POST /apiv2/order5m

Netts के आंतरिक energy पूलों के माध्यम से 5-मिनट का energy रेंटल ऑर्डर बनाएं।

एंडपॉइंट URL

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

अनुरोध हेडर

Header	Required	Description
Content-Type	Yes	application/json
X-API-KEY	Yes	Netts डैशबोर्ड से आपकी API कुंजी
X-Real-IP	Yes	आपकी श्वेतसूची (whitelist) से IP पता

अनुरोध बॉडी

json

{
    "amount": 65000,
    "receiveAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"
}

पैरामीटर

Parameter	Type	Required	Description
amount	integer	Yes	किराए पर ली जाने वाली Energy की मात्रा (न्यूनतम: 61,000, अधिकतम: 650,000)
receiveAddress	string	Yes	TRON पता जो energy प्राप्त करेगा (TRC-20 प्रारूप)

Energy सीमाएं

5-मिनट का एंडपॉइंट प्रति ऑर्डर 61,000 और 650,000 यूनिट के बीच energy मात्रा स्वीकार करता है। इस सीमा से बाहर के अनुरोधों को HTTP 400 के साथ अस्वीकार कर दिया जाएगा।

प्रदाता जानकारी

5-मिनट के energy ऑर्डर विशेष रूप से Netts के आंतरिक energy पूलों के माध्यम से पूरे किए जाते हैं। 1-घंटे के एंडपॉइंट के विपरीत, बाहरी प्रदाताओं का उपयोग नहीं किया जाता है।

उपलब्धता और पुनः प्रयास रणनीति

चूंकि डेलिगेशन केवल आंतरिक पूलों से आते हैं, इसलिए उच्च-मांग की अवधि के दौरान अस्थायी अनुपलब्धता संभव है। यदि आपको 503 त्रुटि मिलती है, तो थोड़े समय के बाद अनुरोध का पुनः प्रयास करें या 1-घंटे के एंडपॉइंट पर वापस आएं, जिसके पास कई बाहरी प्रदाताओं तक पहुंच है।

उदाहरण

cURL

bash

curl -X POST https://netts.io/apiv2/order5m \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key" \
  -H "X-Real-IP: your_whitelisted_ip" \
  -d '{
    "amount": 65000,
    "receiveAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"
  }'

Python

python

import requests

url = "https://netts.io/apiv2/order5m"
headers = {
    "Content-Type": "application/json",
    "X-API-KEY": "your_api_key",
    "X-Real-IP": "your_whitelisted_ip"
}

payload = {
    "amount": 65000,
    "receiveAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"
}

response = requests.post(url, headers=headers, json=payload)
data = response.json()

if response.status_code == 200:
    detail = data.get('detail', {})
    order_data = detail.get('data', {})
    print(f"Order ID: {order_data.get('orderId')}")
    print(f"Transaction Hash: {order_data.get('hash')}")
    print(f"Energy Delivered: {order_data.get('energy')}")
    print(f"Cost: {order_data.get('paidTRX')} TRX")
    print(f"Delegate Address: {order_data.get('delegateAddress')}")
elif response.status_code == 503:
    # Pool temporarily unavailable - retry or fallback to 1h
    print("Pool busy, retrying in 2 seconds...")
else:
    error_detail = data.get('detail', data)
    print(f"Error Code: {error_detail.get('code', 'N/A')}")
    print(f"Error Message: {error_detail.get('msg', error_detail)}")

प्रतिक्रिया

सफल प्रतिक्रिया (200 OK)

json

{
    "detail": {
        "code": 10000,
        "msg": "Successful, 1.430 TRX deducted",
        "data": {
            "orderId": "5Mb4ee11ef86",
            "paidTRX": 1.43,
            "hash": "3636f97dde244fca17cdc0b2cf7fd1572a9b4c6d8e0f1a3b5c7d9e1f3a5b7c9d",
            "delegateAddress": "TNp5gsJhBmZFXgCdgjMgr8pEZ8fHgXUHDq",
            "energy": 65050
        }
    }
}

पता सक्रियण के साथ सफलता (200 OK)

जब प्राप्तकर्ता पता TRON नेटवर्क पर सक्रिय नहीं होता है, तो Netts इसे स्वचालित रूप से सक्रिय करता है। सक्रियण लागत कुल राशि में जोड़ी जाती है:

json

{
    "detail": {
        "code": 10000,
        "msg": "Successful, 1.430 TRX for energy + 1.100 TRX for address activation",
        "data": {
            "orderId": "5Mb4ee11ef86",
            "paidTRX": 2.53,
            "hash": "3636f97dde244fca17cdc0b2cf7fd1572a9b4c6d8e0f1a3b5c7d9e1f3a5b7c9d",
            "delegateAddress": "TNp5gsJhBmZFXgCdgjMgr8pEZ8fHgXUHDq",
            "energy": 65050,
            "activationHash": "bab38070a64b237acc9110ecf5135acc4d6e8f0a2b4c6d8e0f2a4b6c8d0e2f4a"
        }
    }
}

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

Field	Type	Description
detail.code	integer	सफल ऑर्डरों के लिए हमेशा `10000`
detail.msg	string	काटी गई राशि के साथ सफलता संदेश
detail.data.orderId	string	एकीकृत ऑर्डर ID (प्रारूप: `5M{id}`)
detail.data.paidTRX	number	TRX में कुल लागत (यदि लागू हो तो सक्रियण शुल्क शामिल है)
detail.data.hash	string	डेलिगेशन लेन-देन का हैश
detail.data.delegateAddress	string	पूल पता जिसने energy डेलिगेट की
detail.data.energy	integer	Energy मात्रा + बफर (आमतौर पर +50)
detail.data.activationHash	string	केवल तभी उपस्थित होता है जब पता सक्रियण किया गया हो

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

अमान्य Energy मात्रा (400)

json

{
    "code": 1003,
    "msg": "Energy amount must be between 61000 and 650000. Requested: 50000"
}

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

json

{
    "detail": "Invalid API key or IP not in whitelist"
}

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

json

{
    "code": 1004,
    "msg": "Insufficient funds. Required: 1.43 TRX, Available: 0.50 TRX"
}

सेवा अनुपलब्ध (503)

json

{
    "code": 5003,
    "msg": "Service temporarily unavailable. Energy delegation failed after retries."
}

503 त्रुटियों को संभालना

503 प्रतिक्रिया का अर्थ है कि आंतरिक पूल अस्थायी रूप से पूरी क्षमता पर हैं। अनुशंसित रणनीति:

2-3 सेकंड प्रतीक्षा करें और 5-मिनट के ऑर्डर का पुनः प्रयास करें
यदि अभी भी अनुपलब्ध है, तो 1-घंटे के एंडपॉइंट का उपयोग करें जो एकाधिक प्रदाताओं का उपयोग करता है

आंतरिक सर्वर त्रुटि (500)

json

{
    "code": 5000,
    "msg": "Internal server error occurred"
}

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

Code	Description	HTTP Status
`10000`	सफलता	200
`10000`	सफलता (कैश की गई प्रतिक्रिया)	208
`-`	डुप्लिकेट अनुरोध अभी भी संसाधित हो रहा है	409
`1003`	Energy मात्रा सीमा से बाहर है	400
`1004`	अपर्याप्त शेष राशि	403
`1005`	उपयोगकर्ता भुगतानकर्ता पता कॉन्फ़िगर नहीं किया गया है	400
`5000`	आंतरिक सर्वर त्रुटि	500
`5003`	Energy सेवा अनुपलब्ध है	503

दर सीमाएं

इस एंडपॉइंट पर निम्नलिखित दर सीमाएं लागू होती हैं (प्रति IP पता):

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

दर सीमा हेडर

http

RateLimit-Limit: 50
RateLimit-Remaining: 49
RateLimit-Reset: 1
X-RateLimit-Limit-Second: 50
X-RateLimit-Remaining-Second: 49

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

json

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

Idempotency

डुप्लिकेट ऑर्डर प्रोसेसिंग को रोकने के लिए API idempotency का समर्थन करता है। जब आप कई समान अनुरोध भेजते हैं, तो सिस्टम यह सुनिश्चित करता है कि ऑर्डर केवल एक बार संसाधित हो।

Idempotency कैसे काम करता है

अनुरोध की विशिष्टता निम्नलिखित के संयोजन द्वारा निर्धारित की जाती है:

अनुरोध टाइमस्टैम्प (2-सेकंड की विंडो)
Energy मात्रा
प्राप्तकर्ता पता
API कुंजी

प्रत्येक अनुरोध को 2-सेकंड की विशिष्टता विंडो दी जाती है। इस विंडो के भीतर समान मापदंडों वाले अनुरोधों को डुप्लिकेट माना जाता है।

अपनी स्वयं की कुंजी प्रदान करना

आप X-Idempotency-Key हेडर भेजकर idempotency को अपने नियंत्रण में ले सकते हैं। जब यह मौजूद होता है, तो केवल वही मान तय करता है कि अनुरोध दोबारा भेजा गया है या नहीं, और ऊपर दिए गए स्वचालित संयोजन का उपयोग नहीं किया जाता है। जब यह अनुपस्थित होता है, तो कुछ भी नहीं बदलता है — सर्वर आपके लिए कुंजी प्राप्त करता है।

नियम /apiv2/order1h के समान ही हैं:


Header	`X-Idempotency-Key`
Format	ठीक 64 लोअरकेस हेक्साडेसिमल वर्ण — एक SHA-256 डाइजेस्ट
Lifetime	उस कुंजी को ले जाने वाले पहले अनुरोध से 24 घंटे
Scope	आपका खाता। किसी भिन्न खाते द्वारा भेजा गया समान मान कभी भी आपका परिणाम नहीं लौटाता है

किसी अन्य प्रारूप की कुंजी — डैश के साथ UUID, base64, अपरकेस हेक्स — को ऑर्डर दिए जाने से पहले और कोई भी शुल्क लिए जाने से पहले 400 के साथ अस्वीकार कर दिया जाता है:

json

{
    "detail": "Invalid idempotency key format. Must be 64-character hexadecimal string."
}

कुंजी को अपनी API कुंजी से प्राप्त करें ताकि यह आपके खाते के लिए अद्वितीय हो और पुनः प्रयास करने पर पुनरुत्पादित की जा सके — इसका विस्तृत उदाहरण 1-घंटे के पृष्ठ पर है। जिस संदेश को आप हैश करते हैं उसमें रेंटल अवधि शामिल करें: एक ही पते को 5 मिनट और 1 घंटे के लिए किराए पर लेना अलग-अलग ऑर्डर हैं, और दोनों के लिए एक कुंजी का पुन: उपयोग करने पर दूसरे अनुरोध के लिए पहले ऑर्डर की प्रतिक्रिया वापस मिल जाएगी।

दो समान ऑर्डर देना

घंटे वाले एंडपॉइंट के समान ही स्थिति, लेकिन एक विस्तृत विंडो के साथ। दो समान ऑर्डर — समान पते पर समान राशि — पुनः प्रयास से अप्रभेद्य होते हैं, और केवल आने का समय ही उन्हें अलग करता है।

अपनी स्वयं की कुंजी के बिना:

दोनों अनुरोधों के बीच का अंतर क्या होता है

उसी 2-सेकंड की विंडो के अंदर दूसरे अनुरोध को पुनरावृत्ति मान लिया जाता है। इसे निष्पादित नहीं किया जाता है: आपको 208 और पहले ऑर्डर की प्रतिक्रिया मिलती है। इसके लिए कोई शुल्क नहीं लिया जाता है

दो सेकंड से अधिक का अंतर दो अलग-अलग कुंजियाँ — दोनों ऑर्डर दिए जाते हैं और दोनों के लिए शुल्क लिया जाता है

दोनों अनुरोधों के बीच का अंतर	क्या होता है
उसी 2-सेकंड की विंडो के अंदर	दूसरे अनुरोध को पुनरावृत्ति मान लिया जाता है। इसे निष्पादित नहीं किया जाता है: आपको `208` और पहले ऑर्डर की प्रतिक्रिया मिलती है। इसके लिए कोई शुल्क नहीं लिया जाता है
दो सेकंड से अधिक का अंतर	दो अलग-अलग कुंजियाँ — दोनों ऑर्डर दिए जाते हैं और दोनों के लिए शुल्क लिया जाता है

इसलिए दो समान ऑर्डरों के बीच दो सेकंड से अधिक का अंतर छोड़ें, और स्थिति कोड पढ़ें: 208 का अर्थ है कि आपने जो ऑर्डर अभी भेजा है वह नहीं दिया गया था।

रोकना (pause) केवल एक अस्थायी समाधान है, स्थायी समाधान नहीं — यह उन अनुरोधों को भी अलग कर देता है जिन्हें आप कभी दोहराना नहीं चाहते थे, जैसे टाइमआउट के बाद का पुनः प्रयास या आपकी कतार (queue) द्वारा फिर से भेजा गया संदेश, और इनमें से प्रत्येक अलग शुल्क के साथ एक अलग ऑर्डर बन जाता है। अपनी स्वयं की कुंजी भेजना ही इसे वास्तव में हल करता है: एक नए ऑर्डर के लिए एक नया nonce, पुनः प्रयास के लिए पहले प्रयास का nonce। पूरा तर्क 1-घंटे के पृष्ठ पर है।

डुप्लिकेट अनुरोधों के लिए HTTP स्थिति कोड

Status Code	Name	Description
200	OK	ऑर्डर सफलतापूर्वक संसाधित हुआ (पहला अनुरोध)
208	Already Reported	ऑर्डर पहले ही संसाधित हो चुका था, कैश की गई प्रतिक्रिया लौटाई जा रही है
409	Conflict	अनुरोध वर्तमान में संसाधित किया जा रहा है, पुनः प्रयास न करें

डुप्लिकेट अनुरोध - पहले ही संसाधित (208)

json

{
    "detail": {
        "code": 10000,
        "msg": "Successful, 1.430 TRX deducted",
        "data": {
            "hash": "3636f97dde244fca17cdc0b2cf7fd1572a9b4c6d8e0f1a3b5c7d9e1f3a5b7c9d",
            "energy": 65050,
            "orderId": "5Mb4ee11ef86",
            "paidTRX": 1.43,
            "delegateAddress": "TNp5gsJhBmZFXgCdgjMgr8pEZ8fHgXUHDq"
        }
    },
    "idempotency": {
        "status": "completed",
        "cached": true,
        "original_created_at": "2026-03-21T08:53:52.498000"
    }
}

डुप्लिकेट अनुरोध - अभी भी संसाधित हो रहा है (409)

json

{
    "success": false,
    "error": "duplicate_request_processing",
    "message": "This request is currently being processed. Please wait and do not retry.",
    "retry_after_seconds": 3
}

सर्वोत्तम प्रथाएं

समान मापदंडों के साथ समानांतर अनुरोध न भेजें - प्रत्येक प्रतिक्रिया की प्रतीक्षा करें
तुरंत पुनः प्रयास करने के बजाय प्रतीक्षा करके 409 प्रतिक्रियाओं को संभालें
कैश की गई प्रतिक्रियाओं की पहचान करने के लिए idempotency.cached फ़ील्ड की जांच करें

तुलना: 5-मिनट बनाम 1-घंटे के ऑर्डर

Feature	5-Minute Order	1-Hour Order
Endpoint	`/apiv2/order5m`	`/apiv2/order1h`
Duration	5 मिनट	1 घंटा
Energy range	61,000 - 650,000	61,000 - 3,000,000
Providers	केवल Netts आंतरिक पूल	आंतरिक पूल + बाहरी प्रदाता
Price	कम (5-मिनट की दर)	मानक प्रति घंटा दर
Availability	पीक आवर्स के दौरान सीमित हो सकती है	उच्च (एकाधिक प्रदाता फॉलबैक)
Best for	बार-बार होने वाले छोटे लेन-देन	बड़े या गारंटीकृत वितरण

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

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

आपकी जमा राशि से कुछ भी नहीं काटा जाता है। प्रत्येक सफल ऑर्डर आपके खाते की देय शेष राशि में आपके अनुबंध में सहमत निपटान मुद्रा में जोड़ दिया जाता है। आप अपने समझौते के अनुसार चालान (invoice) द्वारा इसका भुगतान करते हैं।
आपके खाते की एक क्रेडिट सीमा होती है। जब तक देय राशि सीमा के भीतर है, शून्य जमा राशि के साथ भी ऑर्डर स्वीकार किए जाते हैं।
केवल वितरित सेवाओं के लिए बिल भेजा जाता है। एक ऑर्डर जो अस्वीकार कर दिया गया है या निष्पादित नहीं किया गया है, उसकी कोई लागत नहीं होती है।
यदि प्राप्तकर्ता पते को सक्रिय करना पड़ता है, तो सक्रियण उसी ऑर्डर का हिस्सा होता है और इसका बिल एक अलग शुल्क के रूप में बनता है।

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

अतिरिक्त अनुरोध फ़ील्ड

Parameter	Type	Required	Description
test	boolean	No	`true` — केवल कीमत की गणना करें। कुछ भी ऑर्डर, वितरित या बिल नहीं किया जाता है
freezePrice	boolean	No	`true` — आपके अनुबंध की कीमत को 60 सेकंड के लिए तय करता है। कुछ भी ऑर्डर या बिल नहीं किया जाता है
quoteId	string	No	`freezePrice` द्वारा जारी किए गए कोट की कीमत पर ऑर्डर दें
priceCurrency	string	No	`TRX` (डिफ़ॉल्ट) या आपके अनुबंध की मुद्रा, जैसा कि `settlement.asset` में है। पोस्टपेड खातों के लिए आपके अनुबंध की मुद्रा में राशियाँ हमेशा शामिल होती हैं

quoteId को test या freezePrice के साथ संयोजित नहीं किया जा सकता है। अनुरोध बॉडी में किसी भी अन्य फ़ील्ड को अस्वीकार कर दिया जाता है।

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

json

{
    "amount": 65000,
    "receiveAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
    "test": true
}

json

{
    "detail": {
        "code": 10010,
        "msg": "Test calculation",
        "data": {
            "amount": 65000,
            "unitPriceSun": "19",
            "discount": null,
            "energyTRX": "1.235000",
            "activationTRX": "1.100000",
            "wouldCostTRX": "2.335000",
            "paidTRX": 0,
            "paymentMode": "postpaid",
            "activationCheck": "inactive",
            "alt": {"USDC": {"energy": "0.409088", "activation": "0.364370", "total": "0.773458"}},
            "fxAt": "2026-10-19T07:16:12.548894+00:00"
        }
    }
}

Field	Description
unitPriceSun	SUN में प्रति energy यूनिट की कीमत, जिसमें आपकी व्यक्तिगत छूट शामिल है यदि आपके पास है
discount	आपकी व्यक्तिगत छूट (`type`, `value`) या `null`
energyTRX / activationTRX / wouldCostTRX	TRX में Energy, सक्रियण (यदि पते को इसकी आवश्यकता है) और कुल राशि
activationCheck	`inactive` — पता सक्रिय किया जाएगा और बिल भेजा जाएगा; `active` — कोई सक्रियण नहीं; `unknown` — अभी जांच नहीं की जा सकी
`alt.<currency>`	वही राशियाँ आपके अनुबंध की मुद्रा में
fxAt	आपके अनुबंध की मुद्रा की राशियों के लिए उपयोग की गई विनिमय दर का समय

निश्चित-मूल्य कोट (`freezePrice: true`)

ऑर्डर करने से पहले अपने अनुबंध की कीमत तय करने के लिए कोट का उपयोग करें।

"freezePrice": true के साथ ऑर्डर भेजें। प्रतिक्रिया में कोड 10011 (Quote issued) होता है, वही फ़ील्ड जो मूल्य जांच में होते हैं, साथ ही quoteId और expiresAt।
60 सेकंड के भीतर "quoteId": "<quoteId>" और समान amount और receiveAddress के साथ ऑर्डर भेजें।
ऑर्डर का बिल कोटेशन की कीमत पर बनता है — यानी कोटेशन के समय आपके अनुबंध की कीमत पर — भले ही इस बीच कीमत बदल जाए।

एक कोट का उपयोग एक बार और केवल उसी उत्पाद के लिए किया जा सकता है: 5-मिनट का कोट 1-घंटे के ऑर्डर का भुगतान नहीं कर सकता है। एक समाप्त या पहले से उपयोग किए गए कोट को अस्वीकार कर दिया जाता है और कुछ भी ऑर्डर नहीं किया जाता है।

json

{
    "amount": 65000,
    "receiveAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
    "quoteId": "q_4f540f16a2c94b7f8e3d1a6b5c0e9d72"
}

सफल ऑर्डर

json

{
    "detail": {
        "code": 10000,
        "msg": "Successful, 1.24 TRX service cost, postpaid",
        "data": {
            "orderId": "5M5f557d2fba",
            "paidTRX": 1.235,
            "hash": "c1fafd8ef7fb6b7fb8a729120756b26e611f401275cb4f7a04fe2bafd75b13da",
            "delegateAddress": "TR3qZsdmkFcvP729Md3PwXzktFQkMoUzjg",
            "energy": 65000,
            "paymentMode": "postpaid",
            "energyTRX": "1.235000",
            "activationTRX": "0.000000",
            "totalTRX": "1.235000"
        }
    }
}

Field	Description
paidTRX	TRX में सेवा की लागत। पोस्टपेड खातों के लिए इसे जमा राशि से नहीं काटा जाता है
paymentMode	`postpaid`
energyTRX / activationTRX / totalTRX	सटीक राशियां, 6 दशमलव स्थान
quoteId, alt	तब मौजूद होते हैं जब ऑर्डर कोटेशन के साथ दिया गया हो: कोटेशन ID और कोट की गई राशियाँ

अन्य सभी फ़ील्ड प्रीपेड ऑर्डरों के समान ही हैं।

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

json

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

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

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

Code	HTTP	Description
`10010`	200	मूल्य जांच परिणाम (`test`)
`10011`	200	कोट जारी किया गया (`freezePrice`)
`1004`	402	पोस्टपेड क्रेडिट सीमा समाप्त हो गई
`4100`	400	अमान्य अनुरोध
`4101`	400	असमर्थित `priceCurrency`
`4102`	400	`quoteId` को `test` या `freezePrice` के साथ संयोजित किया गया
`4103`	409	कोट पहले ही उपयोग किया जा चुका है
`4104`	409	कोट समाप्त हो गया
`4105`	409	Idempotency कुंजी पहले से ही किसी भिन्न अनुरोध के लिए उपयोग की गई है
`4106`	404	कोट नहीं मिला
`4107`	409	ऑर्डर के पैरामीटर कोट से भिन्न हैं
`4108`	400	अमान्य `quoteId` प्रारूप
`4109`	422	सब-अकाउंट के लिए उपलब्ध नहीं
`5032`	503	कीमत अस्थायी रूप से अनुपलब्ध है
`5033`	503	विनिमय दर अस्थायी रूप से अनुपलब्ध है
`5034`	503	बिलिंग अस्थायी रूप से अनुपलब्ध है — ऑर्डर स्वीकार नहीं किया गया था
`5036`	503	क्रेडिट जांच अस्थायी रूप से अनुपलब्ध है — बाद में पुनः प्रयास करें

ऊपर दी गई सभी 4xx और 503 प्रतिक्रियाओं के लिए कुछ भी ऑर्डर नहीं किया गया है और कुछ भी बिल नहीं किया गया है।

नोट्स

सफल ऑर्डर पर Energy तुरंत वितरित की जाती है (आमतौर पर 0.5-2 सेकंड के भीतर)
API प्रतिक्रिया टाइमआउट: अधिकतम 10 सेकंड (आंतरिक पुनः प्रयास शामिल हैं)
पता सक्रियण: यदि प्राप्तकर्ता पता सक्रिय नहीं है, तो Netts इसे लागत मूल्य पर सक्रिय करता है। सक्रियण लागत प्रति पते पर केवल एक बार ली जाती है
अवधि: निश्चित 5 मिनट (300 सेकंड)
न्यूनतम energy मात्रा: 61,000 यूनिट
अधिकतम energy मात्रा: 650,000 यूनिट प्रति ऑर्डर
Energy बफर: +50 यूनिट स्वचालित रूप से जोड़े जाते हैं (निःशुल्क)
ऑर्डर ID प्रारूप: एकीकृत ट्रैकिंग के लिए 5M{id}
मूल्य निर्धारण: मूल्य निर्धारण API के माध्यम से दिन के समय के आधार पर गतिशील
दर सीमित करना: प्रति IP पता प्रति सेकंड 50 अनुरोध
केवल आंतरिक पूल: यदि पूल पूरी क्षमता पर हैं, तो थोड़े समय के बाद पुनः प्रयास करें या फॉलबैक के रूप में 1-घंटे के एंडपॉइंट का उपयोग करें

POST /apiv2/order5m ​

एंडपॉइंट URL ​

अनुरोध हेडर ​

अनुरोध बॉडी ​

पैरामीटर ​

प्रदाता जानकारी ​

उदाहरण ​

cURL ​

Python ​

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

सफल प्रतिक्रिया (200 OK) ​

पता सक्रियण के साथ सफलता (200 OK) ​

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

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

अमान्य Energy मात्रा (400) ​

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

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

सेवा अनुपलब्ध (503) ​

आंतरिक सर्वर त्रुटि (500) ​

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

दर सीमाएं ​

दर सीमा हेडर ​

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

Idempotency ​

Idempotency कैसे काम करता है ​

अपनी स्वयं की कुंजी प्रदान करना ​

दो समान ऑर्डर देना ​

डुप्लिकेट अनुरोधों के लिए HTTP स्थिति कोड ​

डुप्लिकेट अनुरोध - पहले ही संसाधित (208) ​

डुप्लिकेट अनुरोध - अभी भी संसाधित हो रहा है (409) ​

सर्वोत्तम प्रथाएं ​

तुलना: 5-मिनट बनाम 1-घंटे के ऑर्डर ​

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

अतिरिक्त अनुरोध फ़ील्ड ​

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

निश्चित-मूल्य कोट (freezePrice: true) ​

सफल ऑर्डर ​

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

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

नोट्स ​

POST /apiv2/order5m

एंडपॉइंट URL

अनुरोध हेडर

अनुरोध बॉडी

पैरामीटर

प्रदाता जानकारी

उदाहरण

cURL

Python

प्रतिक्रिया

सफल प्रतिक्रिया (200 OK)

पता सक्रियण के साथ सफलता (200 OK)

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

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

अमान्य Energy मात्रा (400)

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

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

सेवा अनुपलब्ध (503)

आंतरिक सर्वर त्रुटि (500)

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

दर सीमाएं

दर सीमा हेडर

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

Idempotency

Idempotency कैसे काम करता है

अपनी स्वयं की कुंजी प्रदान करना

दो समान ऑर्डर देना

डुप्लिकेट अनुरोधों के लिए HTTP स्थिति कोड

डुप्लिकेट अनुरोध - पहले ही संसाधित (208)

डुप्लिकेट अनुरोध - अभी भी संसाधित हो रहा है (409)

सर्वोत्तम प्रथाएं

तुलना: 5-मिनट बनाम 1-घंटे के ऑर्डर

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

अतिरिक्त अनुरोध फ़ील्ड

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

निश्चित-मूल्य कोट (`freezePrice: true`)

सफल ऑर्डर

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

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

नोट्स