POST /apiv2/bandwidth

एक निश्चित अवधि के लिए TRON Bandwidth किराए पर लें और इसे प्राप्तकर्ता पते पर डेलिगेट करें: 5 मिनट, या मान्यता प्राप्त खातों के लिए 1 घंटा।

⚠️ एक्सेस स्तर (Access tiers).
मान्यता प्राप्त खाते (Accredited accounts) पूल आकार और अधिकतम सीमाओं के भीतर कई समवर्ती ऑर्डरों (concurrent orders) के साथ कोई भी राशि (5000 तक) 5 मिनट या 1 घंटे के लिए किराए पर ले सकते हैं। मान्यता Netts support द्वारा प्रदान की जाती है।
बिना मान्यता के आप 5 मिनट के लिए 400 यूनिट, एक बार में किराए पर ले सकते हैं — अगला ऑर्डर केवल पिछला किराया समाप्त होने के बाद ही अनुमत है। 400 के अलावा अन्य राशियों के अनुरोध, 1 घंटे के अनुरोध, या पहला ऑर्डर सक्रिय रहने के दौरान दूसरा ऑर्डर अस्वीकार कर दिए जाते हैं।

एंडपॉइंट URL

POST https://netts.io/apiv2/bandwidth

अनुरोध हेडर

Header	Required	Description
Content-Type	Yes	application/json
X-API-KEY	Yes	Netts डैशबोर्ड से आपकी API कुंजी
X-Real-IP	Yes	आपकी श्वेतसूची (whitelist) से IP पता
X-Idempotency-Key	No	बिना दोहरा ऑर्डर किए सुरक्षित रूप से पुनः प्रयास करने के लिए वैकल्पिक क्लाइंट-जनरेटेड कुंजी (base64)। यदि छोड़ दिया जाता है, तो सर्वर स्वचालित रूप से एक उत्पन्न करता है

अनुरोध बॉडी

json

{
    "amount": 1500,
    "receiveAddress": "TXXxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "period": "5m"
}

पैरामीटर

Parameter	Type	Required	Description
amount	integer	Yes	किराए पर लेने के लिए Bandwidth यूनिट्स (न्यूनतम: 400, अधिकतम: 5000)
receiveAddress	string	Yes	TRON पता जो Bandwidth प्राप्त करेगा (`T…`, 34 वर्ण, base58)
period	string	Yes	किराए की अवधि: `"5m"` (5 मिनट) या `"1h"` (1 घंटा, केवल मान्यता प्राप्त खातों के लिए)
trx_send	boolean	No	गारंटीकृत लेनदेन: यदि कोई Bandwidth उपलब्ध नहीं है, तो पते पर TRX भेजें ताकि लेनदेन फिर भी पूरा हो सके। केवल तभी काम करता है जब `amount = 400` (अन्यथा अनदेखा किया जाता है)। डिफ़ॉल्ट `false`
check	boolean	No	यदि `true` है और प्राप्तकर्ता के पास पहले से ही 400 से अधिक Bandwidth है, तो ऑर्डर डेलिगेट नहीं किया जाता है और कोई शुल्क नहीं लिया जाता है (स्थिति `enough`)। डिफ़ॉल्ट `false`
test	boolean	No	ड्राई रन (Dry run)। यदि `true` है, तो संपूर्ण ऑर्डर प्रवाह का अनुकरण किया जाता है — प्रतिक्रिया आपको वह परिणाम बताती है जो घटित होगा और वह मूल्य जो लिया जाएगा — बिना किसी ऑन-चेन कार्रवाई और बिना किसी शुल्क के। डिफ़ॉल्ट `false`

उदाहरण

नीचे दिए गए उदाहरण X-Idempotency-Key भी बनाते और भेजते हैं ताकि अनपेक्षित दोहराव से दूसरा ऑर्डर न बने। पूर्ण नियमों के लिए Idempotency देखें।

cURL

bash

API_KEY="your_api_key"
ADDR="TXXxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
AMOUNT=1500
PERIOD="5m"
NONCE=$(( $(date +%s) / 2 ))   # stable for retries within a 2s window; or your own order UUID

# X-Idempotency-Key = base64( HMAC-SHA256( API_KEY, "addr:amount:period:nonce" ) )
IDEMP=$(printf '%s' "${ADDR}:${AMOUNT}:${PERIOD}:${NONCE}" \
  | openssl dgst -sha256 -hmac "$API_KEY" -binary | base64)

curl -X POST https://netts.io/apiv2/bandwidth \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: $API_KEY" \
  -H "X-Real-IP: your_whitelisted_ip" \
  -H "X-Idempotency-Key: $IDEMP" \
  -d "{\"amount\": $AMOUNT, \"receiveAddress\": \"$ADDR\", \"period\": \"$PERIOD\"}"

Python

python

import time, hmac, hashlib, base64, requests

API_KEY = "your_api_key"
url = "https://netts.io/apiv2/bandwidth"
payload = {
    "amount": 1500,
    "receiveAddress": "TXXxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "period": "5m",
}

# X-Idempotency-Key = base64( HMAC-SHA256( API_KEY, "addr:amount:period:nonce" ) )
# Generate ONCE per order and resend the same value on every retry.
nonce = str(int(time.time() // 2))   # 2s bucket; or your own order UUID
message = f"{payload['receiveAddress']}:{payload['amount']}:{payload['period']}:{nonce}"
idem_key = base64.b64encode(
    hmac.new(API_KEY.encode(), message.encode(), hashlib.sha256).digest()
).decode()

headers = {
    "Content-Type": "application/json",
    "X-API-KEY": API_KEY,
    "X-Real-IP": "your_whitelisted_ip",
    "X-Idempotency-Key": idem_key,
}

response = requests.post(url, headers=headers, json=payload)
data = response.json()
detail = data.get("detail", {})

if response.status_code == 200 and detail.get("status") == "completed":
    d = detail["data"]
    print(f"Order ID: {d['orderId']}")
    print(f"Hashes:   {d['hash']}")          # array of delegation tx hashes
    print(f"Bandwidth: {d['bandwidth']} for {d['period']}")
    print(f"Cost:     {d['paidTRX']} TRX")
else:
    print(f"Code: {detail.get('code')} | {detail.get('msg', detail)}")

सेवा पैकेज (handler_bandwidth/doc/client_example/) के साथ एक पूर्ण क्लाइंट उदाहरण (Python + cURL) प्रदान किया गया है।

प्रतिक्रिया

सफलता — Bandwidth डेलिगेट की गई (200 OK)

json

{
    "detail": {
        "code": 10000,
        "status": "completed",
        "msg": "Successful",
        "data": {
            "orderId": "B5M<key14>",
            "paidTRX": "<amount charged in TRX>",
            "fulfilledBy": "bandwidth",
            "hash": ["a1b2c3...", "d4e5f6..."],
            "bandwidth": 1500,
            "period": "5m"
        }
    }
}

सफलता — Bandwidth के बजाय TRX भेजा गया (200 OK, केवल `amount=400` + `trx_send=true`)

जब पूल में कोई Bandwidth उपलब्ध नहीं होती है और trx_send सक्षम होता है, तो पते पर TRX भेजा जाता है ताकि लेनदेन फिर भी सफल हो। इस मामले में, अनुरोधित अवधि की परवाह किए बिना एक निश्चित शुल्क लागू होता है।

json

{
    "detail": {
        "code": 10000,
        "status": "completed",
        "msg": "Successful (sent TRX, bandwidth unavailable)",
        "data": {
            "orderId": "B5M<key14>",
            "paidTRX": "<amount charged in TRX>",
            "fulfilledBy": "trx",
            "trxSendHash": ["<txid>"],
            "hash": [],
            "bandwidth": 400,
            "period": "5m"
        }
    }
}

पहले से पर्याप्त — कोई शुल्क नहीं लिया गया (200 OK, केवल `check=true` के साथ)

json

{
    "detail": {
        "code": 10002,
        "status": "enough",
        "msg": "enough band for 1 transfer",
        "data": { "orderId": "B5M<key14>", "paidTRX": 0, "bandwidth": 400, "period": "5m" }
    }
}

प्रसंस्करण — बाहरी प्रदाता (202 Accepted)

तब लौटाया जाता है जब ऑर्डर अतुल्यकालिक रूप से (asynchronously) किसी बाहरी प्रदाता को सौंपा जाता है। जब तक यह पूरा नहीं हो जाता, तब तक orderId का उपयोग करके स्थिति एंडपॉइंट (नीचे) को पोल करें।

json

{
    "detail": {
        "code": 10001,
        "status": "processing",
        "msg": "Order accepted, processed by an external provider. Poll the status endpoint.",
        "data": { "orderId": "B5M<key14>", "bandwidth": 1500, "period": "5m" }
    }
}

परीक्षण रन (200 OK, केवल `test=true` के साथ)

संपूर्ण ऑर्डर प्रवाह का अनुकरण किया जाता है। testAction आपको बताता है कि क्या घटित होगा और wouldCostTRX बताता है कि क्या शुल्क लिया जाएगा। कुछ भी डेलिगेट नहीं किया जाता है, कोई TRX नहीं भेजा जाता है, कुछ भी शुल्क नहीं लिया जाता है (paidTRX: 0)।

json

{
    "detail": {
        "code": 10003,
        "status": "test",
        "msg": "Test run — no on-chain action, no charge",
        "data": {
            "orderId": "B5M<...>",
            "testAction": "would_delegate",
            "wouldCostTRX": "<amount that would be charged in TRX>",
            "paidTRX": 0,
            "bandwidth": 400,
            "period": "5m",
            "receiverFreeBandwidth": 600
        }
    }
}

testAction मान: would_delegate (Bandwidth डेलिगेट की जाएगी), would_trx_send (कोई Bandwidth नहीं, amount=400 + trx_send → TRX भेजा जाएगा), enough (प्राप्तकर्ता के पास पहले से पर्याप्त है, check=true के साथ), या would_error:<reason> (उदा. no_bandwidth, not_whitelisted)।

प्रतिक्रिया फ़ील्ड

Field	Type	Description
detail.code	integer	`10000` डेलिगेटेड/TRX, `10002` पर्याप्त, `10001` प्रसंस्करण
detail.status	string	`completed` / `enough` / `processing` / `failed`
detail.data.orderId	string	ऑर्डर ID, प्रारूप `B5M…` (5m) / `B1H…` (1h) — स्थिति एंडपॉइंट के लिए इसका उपयोग करें
detail.data.paidTRX	number	TRX में ली गई राशि (`enough` होने पर `0`)
detail.data.fulfilledBy	string	`bandwidth` (डेलिगेटेड) / `trx` (TRX भेजा गया)
detail.data.hash	array	डेलिगेशन लेनदेन हैश (10 तक)। हमेशा एक ऐरे (TRX शाखा के लिए खाली)
detail.data.trxSendHash	array	TRX ट्रांसफर हैश, केवल तभी मौजूद जब `fulfilledBy = trx`
detail.data.bandwidth	integer	डेलिगेट की गई Bandwidth यूनिट्स
detail.data.period	string	किराए की अवधि (`5m` / `1h`)

स्थिति एंडपॉइंट

GET https://netts.io/apiv2/bandwidth/status/{orderId}

Headers: X-API-KEY + X-Real-IP (ऑर्डर प्रमाणित उपयोगकर्ता का होना चाहिए)।

ऑर्डर स्थिति	HTTP	code	status
पूर्ण हुआ	200	10000	`completed` (`hash` / `trxSendHash` के साथ)
प्रगति पर है	200	10001	`processing`
पहले से पर्याप्त	200	10002	`enough`
विफल रहा	200	5003	`failed`
नहीं मिला / आपका नहीं है	404	-1	—

रीक्लेम एंडपॉइंट

अपनी अवधि समाप्त होने से पहले अपने डेलिगेट किए गए ऑर्डरों में से किसी एक की Bandwidth को स्वेच्छा से रीक्लेम (undelegate) करें। Bandwidth स्वचालित रूप से अनडेलिगेट हो जाती है और लेनदेन हैश वापस आ जाता है।

POST https://netts.io/apiv2/bandwidth/reclaim/{orderId}

Headers: X-API-KEY + X-Real-IP (ऑर्डर प्रमाणित उपयोगकर्ता का होना चाहिए)।

ऑर्डर स्थिति	HTTP	code	status	परिणाम
डेलिगेटेड → अब रीक्लेम किया गया	200	10004	`reclaimed`	`reclaimHash` (undelegate लेनदेन हैश)
पहले से रीक्लेम किया गया	200	10004	`reclaimed`	`reclaimHash` + संदेश "already reclaimed"
डेलिगेटेड स्थिति में नहीं है (रीक्लेम करने के लिए कुछ नहीं है)	400	5005	`failed`	—
रीक्लेम अभी पूरा नहीं हुआ है	503	5003	`failed`	शीघ्र पुनः प्रयास करें
नहीं मिला / आपका नहीं है	404	-1	—	—

bash

curl -X POST https://netts.io/apiv2/bandwidth/reclaim/B5M<...> \
  -H "X-API-KEY: your_api_key" -H "X-Real-IP: your_whitelisted_ip"

json

{
    "detail": {
        "code": 10004,
        "status": "reclaimed",
        "msg": "Bandwidth reclaimed",
        "data": { "orderId": "B5M<...>", "reclaimHash": ["<txid>"] }
    }
}

python

import requests

order_id = "B5M..."   # the orderId from your rental response
url = f"https://netts.io/apiv2/bandwidth/reclaim/{order_id}"
headers = {"X-API-KEY": "your_api_key", "X-Real-IP": "your_whitelisted_ip"}

resp = requests.post(url, headers=headers)
detail = resp.json()["detail"]

if resp.status_code == 200 and detail["status"] == "reclaimed":
    print(f"Reclaimed: {detail['data']['reclaimHash']} ({detail['msg']})")
else:
    print(f"Code {detail.get('code')}: {detail.get('msg', detail)}")

समय से पहले स्वैच्छिक रीक्लेम पर किराए का शुल्क वापस नहीं किया जाता है — रीक्लेम करने से केवल डेलिगेट की गई Bandwidth अवधि से पहले पूल में वापस आ जाती है।

त्रुटि प्रतिक्रियाएं

प्रमाणीकरण त्रुटि (401)

json

{ "detail": { "code": -1, "msg": "Invalid API key or IP not in whitelist" } }

अपर्याप्त शेष राशि (403)

json

{ "detail": { "code": 1004, "status": "failed", "msg": "Insufficient funds" } }

सत्यापन त्रुटि (400)

json

{ "detail": { "code": 5004, "status": "failed", "msg": "Bandwidth amount out of range (400..5000)" } }

डेलिगेशन विफल / सेवा अनुपलब्ध (503)

json

{ "detail": { "code": 5003, "status": "failed", "msg": "Bandwidth delegation failed" } }

त्रुटि कोड संदर्भ

Code	Description	HTTP Status
`10000`	सफलता (डेलिगेटेड, या TRX भेजा गया)	200
`10000`	सफलता (कैश की गई प्रतिक्रिया)	208
`10001`	स्वीकृत, बाहरी प्रदाता द्वारा संसाधित किया जा रहा है	202
`10002`	प्राप्तकर्ता के पास पहले से पर्याप्त Bandwidth है (कोई शुल्क नहीं लिया गया)	200
`10003`	परीक्षण रन — परिणाम + मूल्य पूर्वावलोकन, कुछ भी शुल्क नहीं लिया गया (`test=true`)	200
`10004`	Bandwidth रीक्लेम की गई (स्वैच्छिक undelegate) — `reclaimHash` लौटाया गया	200
`-`	डुप्लिकेट अनुरोध अभी भी संसाधित हो रहा है	409
`-1`	अमान्य API कुंजी / IP श्वेतसूची में नहीं है	401
`1004`	अपर्याप्त शेष राशि	403
`1005`	उपयोगकर्ता के लिए कोई भुगतानकर्ता पता नहीं है	400
`5004`	अमान्य राशि/अवधि (सत्यापन)	400
`5005`	रीक्लेम करने के लिए कुछ नहीं है (ऑर्डर डेलिगेटेड स्थिति में नहीं है)	400
`5007`	बिना मान्यता के — एक समय में केवल एक किराया; पिछला ऑर्डर अभी भी सक्रिय है (इसके समाप्त होने तक प्रतीक्षा करें)	503
`5008`	बिना मान्यता के — केवल 5 मिनट के लिए 400-यूनिट ऑर्डरों की अनुमति है; बड़ी राशियों या 1 घंटे के लिए मान्यता आवश्यक है	503
`5003`	Bandwidth डेलिगेशन विफल / अनुपलब्ध	503
`5000`	आंतरिक सर्वर त्रुटि	500

दर सीमाएं

Period	Limit	Description
1 सेकंड	50 अनुरोध	प्रति IP प्रति सेकंड अधिकतम 50 अनुरोध

दर सीमा पार हो गई (429)

json

{ "message": "API rate limit exceeded" }

Idempotency

वैकल्पिक X-Idempotency-Key हेडर भेजें ताकि अनपेक्षित दोहराव से दूसरा ऑर्डर न बने — मूल प्रतिक्रिया HTTP 208 के साथ वापस कर दी जाती है। यदि आप हेडर नहीं भेजते हैं, तो सर्वर थोड़े समय के भीतर आपके अनुरोध पैरामीटरों से स्वचालित रूप से एक कुंजी प्राप्त कर लेता है।

कुंजी कैसे बनाएं

कुंजी base64( HMAC-SHA256( secret, message ) ) है — एक 44-वर्णों की base64 स्ट्रिंग, जहां:

secret = आपकी API कुंजी (X-API-KEY);
message = : के साथ जुड़े फ़ील्ड — receiveAddress:amount:period:nonce।

nonce कोई भी मान है जो समान तार्किक ऑर्डर के पुनः प्रयासों में स्थिर रहता है लेकिन अलग-अलग ऑर्डरों के बीच भिन्न होता है — उदा. एक UUID जो आप उस ऑर्डर के लिए रखते हैं, या एक मोटा टाइमस्टैम्प बकेट। प्रति ऑर्डर एक बार कुंजी उत्पन्न करें और प्रत्येक पुनः प्रयास पर वही सटीक मान दोबारा भेजें।

python

import hmac, hashlib, base64, time

def make_idempotency_key(api_key, receive_address, amount, period, nonce=None):
    if nonce is None:
        nonce = str(int(time.time() // 2))   # 2-second bucket; or your own order UUID
    message = f"{receive_address}:{amount}:{period}:{nonce}"
    digest = hmac.new(api_key.encode(), message.encode(), hashlib.sha256).digest()
    return base64.b64encode(digest).decode()  # 44-char base64

bash

# then send it as a header:
-H "X-Idempotency-Key: <base64_key>"

संदेश में period शामिल करना महत्वपूर्ण है: 5 मिनट और 1 घंटे के लिए समान पते को किराए पर लेना अलग-अलग ऑर्डर हैं और इनसे अलग-अलग कुंजियाँ बननी चाहिए।

सत्यापन। प्रदान की गई X-Idempotency-Key 16–64 वर्णों की base64 स्ट्रिंग होनी चाहिए (वर्णसेट A–Z a–z 0–9 + / = _ -)। गलत प्रारूपित या अत्यधिक लंबी कुंजी को HTTP 400 (code 5004) के साथ अस्वीकार कर दिया जाता है।

स्थिति कोड	अर्थ
200	सफलतापूर्वक संसाधित (पहला अनुरोध)
208	पहले ही सफलतापूर्वक संसाधित — कैश्ड प्रतिक्रिया लौटाई गई (कोई दूसरा शुल्क नहीं)
409	वही अनुरोध वर्तमान में संसाधित किया जा रहा है — प्रतीक्षा करें, अभी पुनः प्रयास न करें

विफलता के बाद पुनः प्रयास करना। केवल सफल परिणाम (completed / enough) कैश किए जाते हैं। यदि पिछला प्रयास विफल रहा या समय समाप्त हो गया (कोई धनराशि नहीं काटी गई), तो आप सुरक्षित रूप से उसी X-Idempotency-Key के साथ पुनः प्रयास कर सकते हैं — पुरानी त्रुटि लौटाने के बजाय ऑर्डर का पुनः प्रयास किया जाता है। जब कोई प्रयास अभी भी प्रगति पर होता है तो आपको 409 मिलता है; प्रतीक्षा करें और पुनः प्रयास करें।

पोस्टपेड खाते

पोस्टपेड बिलिंग वाले खाते अन्य सभी की तरह ही समान एंडपॉइंट, URL, हेडर और अनुरोध बॉडी का उपयोग करते हैं। अंतर यह है कि ऑर्डर का भुगतान कैसे किया जाता है:

आपकी जमा राशि से कुछ भी नहीं काटा जाता है। प्रत्येक डिलीवर किया गया ऑर्डर आपके अनुबंध में सहमत निपटान मुद्रा (settlement currency) में देय खाता शेष में जोड़ा जाता है। आप अपने समझौते के अनुसार चालान (invoice) द्वारा इसका भुगतान करते हैं।
आपके खाते की एक क्रेडिट सीमा (credit limit) होती है। जब तक देय राशि सीमा के भीतर है, शून्य जमा के साथ भी ऑर्डर स्वीकार किए जाते हैं। 5 मिनट और 1 घंटे के लिए किराए समान Bandwidth सीमा के तहत गिने जाते हैं।
केवल डिलीवर की गई सेवाओं का बिल भेजा जाता है: पते पर डेलिगेट की गई Bandwidth, या इसके बजाय भेजा गया TRX (fulfilledBy = trx)। राशि प्रीपेड ऑर्डरों के समान ही होती है।
एक ऑर्डर जो अस्वीकार कर दिया जाता है, निष्पादित नहीं होता है, एक परीक्षण रन (test: true) है या enough (check: true) के साथ उत्तर दिया जाता है, उसका कोई शुल्क नहीं लगता है।
समय से पहले स्वैच्छिक रीक्लेम देय राशि को कम नहीं करता है, बिल्कुल प्रीपेड ऑर्डरों की तरह।
एक्सेस स्तर, राशियां, अवधियां और इस एंडपॉइंट के अन्य सभी नियम प्रीपेड खातों के समान ही हैं।

अनुरोध पर Netts द्वारा किसी खाते के लिए पोस्टपेड बिलिंग सक्षम की जाती है। प्रत्येक प्रतिक्रिया आपको बताती है कि ऑर्डर का भुगतान कैसे किया गया है: paymentMode या तो postpaid या prepaid होता है।

मूल्य जांच (`test: true`)

json

{
    "amount": 1000,
    "receiveAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
    "period": "5m",
    "test": true
}

json

{
    "detail": {
        "code": 10003,
        "status": "test",
        "msg": "Test run — no on-chain action, no charge",
        "data": {
            "orderId": "B5M1a2b3c4d5e6f70",
            "testAction": "would_delegate",
            "wouldCostTRX": 0.7,
            "paidTRX": 0,
            "bandwidth": 1000,
            "period": "5m",
            "receiverFreeBandwidth": 600,
            "paymentMode": "postpaid"
        }
    }
}

wouldCostTRX वह राशि है जो TRX में आपके देय शेष में जोड़ी जाएगी। कुछ भी डेलिगेट या बिल नहीं किया जाता है।

सफल ऑर्डर

json

{
    "detail": {
        "code": 10000,
        "status": "completed",
        "msg": "Successful, 0.700000 TRX, postpaid",
        "data": {
            "orderId": "B5M0f9e8d7c6b5a41",
            "paidTRX": 0.7,
            "fulfilledBy": "bandwidth",
            "hash": ["<txid>"],
            "bandwidth": 1000,
            "period": "5m",
            "paymentMode": "postpaid",
            "totalTRX": "0.700000"
        }
    }
}

Field	Description
paidTRX	TRX में सेवा की लागत। पोस्टपेड खातों के लिए यह जमा राशि से नहीं काटा जाता है
paymentMode	`postpaid`
totalTRX	सटीक राशि, 6 दशमलव स्थान

TRX शाखा (fulfilledBy = trx, trxSendHash) सहित अन्य सभी फ़ील्ड, प्रीपेड ऑर्डरों के समान ही हैं।

क्रेडिट सीमा समाप्त (402)

json

{
    "detail": {
        "code": 1004,
        "msg": "Postpaid credit limit reached.",
        "paymentMode": "postpaid",
        "reason": "limit_reached"
    }
}

ऑर्डर निष्पादित नहीं किया गया है और कुछ भी बिल नहीं किया गया है। आपका भुगतान दर्ज होने या आपकी सीमा बढ़ाए जाने के बाद नए ऑर्डर फिर से स्वीकार किए जाते हैं।

पोस्टपेड त्रुटि कोड

Code	HTTP	Description
`1004`	402	पोस्टपेड क्रेडिट सीमा समाप्त हो गई
`5032`	503	मूल्य अस्थायी रूप से अनुपलब्ध है
`5034`	503	बिलिंग अस्थायी रूप से अनुपलब्ध है — ऑर्डर स्वीकार नहीं किया गया था
`5036`	503	क्रेडिट जांच अस्थायी रूप से अनुपलब्ध है — बाद में पुनः प्रयास करें

उपरोक्त सभी प्रतिक्रियाओं के लिए कुछ भी ऑर्डर नहीं किया गया है और कुछ भी बिल नहीं किया गया है। अन्य सभी कोड प्रीपेड ऑर्डरों के समान ही हैं।

नोट्स

एक्सेस स्तर: मान्यता प्राप्त खाते समवर्ती ऑर्डरों के साथ पूल/अधिकतम सीमाओं के भीतर किसी भी राशि को किराए पर ले सकते हैं; बिना मान्यता के — 5 मिनट के लिए 400 यूनिट, एक बार में (अगला ऑर्डर केवल पिछला किराया समाप्त होने के बाद)। मान्यता के लिए Netts support से संपर्क करें।
न्यूनतम: 400 यूनिट। अधिकतम: प्रति ऑर्डर 5000 यूनिट (वर्तमान कॉन्फ़िगरेशन)।
अवधियां: 5m (300 सेकंड) और 1h (3600 सेकंड, केवल मान्यता प्राप्त खातों के लिए)। अवधि समाप्त होने पर Bandwidth स्वचालित रूप से रीक्लेम कर ली जाती है।
कोई बफर नहीं: सटीक रूप से अनुरोधित राशि ही डेलिगेट की जाती है।
hash एक ऐरे है: एक एकल ऑर्डर 10 तक डेलिगेशन हैश उत्पन्न कर सकता है — सभी लौटाए जाते हैं।
मूल्य निर्धारण: अनुरोधित राशि और अवधि के आधार पर TRX में शुल्क लिया जाता है; दरें दिन के समय के अनुसार भिन्न हो सकती हैं। वर्तमान मूल्य निर्धारण के लिए सहायता से संपर्क करें।
छोटे-ऑर्डर का मुआवजा (डेलिगेशन): 1000 यूनिट से कम के ऑर्डरों के लिए, ऑन-चेन डेलिगेशन और रीक्लेम के मुआवजे के रूप में मूल्य में एक निश्चित 0.372 TRX जोड़ा जाता है। 1000 यूनिट या उससे अधिक के ऑर्डरों में ऐसा कोई अतिरिक्त शुल्क नहीं होता है।
TRX-send मुआवजा: जब ऑर्डर TRX भेजकर पूरा किया जाता है (fulfilledBy = trx), तो इसके बजाय एक निश्चित 0.268 TRX जोड़ा जाता है (ऑन-चेन TRX ट्रांसफर के लिए मुआवजा)।
trx_send: केवल amount = 400 के लिए; यदि कोई Bandwidth उपलब्ध नहीं है, तो पते पर TRX भेजा जाता है ताकि लेनदेन फिर भी पूरा हो सके।
check: जब प्राप्तकर्ता के पास पहले से ही 400 से अधिक Bandwidth होती है, तो डेलिगेशन (और शुल्क लेने) को छोड़ देता है।
ऑर्डर ID प्रारूप: B5M… (5 मिनट) / B1H… (1 घंटा)।
प्रतिक्रिया टाइमआउट: डेलिगेशन की प्रतीक्षा करते समय ~12 सेकंड तक; आमतौर पर 1–2 सेकंड।

POST /apiv2/bandwidth ​

एंडपॉइंट URL ​

अनुरोध हेडर ​

अनुरोध बॉडी ​

पैरामीटर ​

उदाहरण ​

cURL ​

Python ​

प्रतिक्रिया ​

सफलता — Bandwidth डेलिगेट की गई (200 OK) ​

सफलता — Bandwidth के बजाय TRX भेजा गया (200 OK, केवल amount=400 + trx_send=true) ​

पहले से पर्याप्त — कोई शुल्क नहीं लिया गया (200 OK, केवल check=true के साथ) ​

प्रसंस्करण — बाहरी प्रदाता (202 Accepted) ​

परीक्षण रन (200 OK, केवल test=true के साथ) ​

प्रतिक्रिया फ़ील्ड ​

स्थिति एंडपॉइंट ​

रीक्लेम एंडपॉइंट ​

त्रुटि प्रतिक्रियाएं ​

प्रमाणीकरण त्रुटि (401) ​

अपर्याप्त शेष राशि (403) ​

सत्यापन त्रुटि (400) ​

डेलिगेशन विफल / सेवा अनुपलब्ध (503) ​

त्रुटि कोड संदर्भ ​

दर सीमाएं ​

दर सीमा पार हो गई (429) ​

Idempotency ​

कुंजी कैसे बनाएं ​

पोस्टपेड खाते ​

मूल्य जांच (test: true) ​

सफल ऑर्डर ​

क्रेडिट सीमा समाप्त (402) ​

पोस्टपेड त्रुटि कोड ​

नोट्स ​

POST /apiv2/bandwidth

एंडपॉइंट URL

अनुरोध हेडर

अनुरोध बॉडी

पैरामीटर

उदाहरण

cURL

Python

प्रतिक्रिया

सफलता — Bandwidth डेलिगेट की गई (200 OK)

सफलता — Bandwidth के बजाय TRX भेजा गया (200 OK, केवल `amount=400` + `trx_send=true`)

पहले से पर्याप्त — कोई शुल्क नहीं लिया गया (200 OK, केवल `check=true` के साथ)

प्रसंस्करण — बाहरी प्रदाता (202 Accepted)

परीक्षण रन (200 OK, केवल `test=true` के साथ)

प्रतिक्रिया फ़ील्ड

स्थिति एंडपॉइंट

रीक्लेम एंडपॉइंट

त्रुटि प्रतिक्रियाएं

प्रमाणीकरण त्रुटि (401)

अपर्याप्त शेष राशि (403)

सत्यापन त्रुटि (400)

डेलिगेशन विफल / सेवा अनुपलब्ध (503)

त्रुटि कोड संदर्भ

दर सीमाएं

दर सीमा पार हो गई (429)

Idempotency

कुंजी कैसे बनाएं

पोस्टपेड खाते

मूल्य जांच (`test: true`)

सफल ऑर्डर

क्रेडिट सीमा समाप्त (402)

पोस्टपेड त्रुटि कोड

नोट्स