रेफ़रेंस
एरर
हर एरर का एक तय कोड, एक HTTP स्टेटस और एक फ़्लैग होता है जो बताता है कि दोबारा कोशिश से मदद मिल सकती है या नहीं। संदेश के टेक्स्ट पर नहीं, error_code और retryable पर शाखा बनाएँ।
एरर का रूप
विफल अनुरोध एरर के HTTP स्टेटस के साथ एक JSON ऑब्जेक्ट लौटाता है। error का टेक्स्ट टाइप किए गए मानों से भरा तय अंग्रेज़ी वाक्य है; इसमें कभी दूसरे सिस्टम का टेक्स्ट नहीं होता।
{
"error": "Minimum quantity is 100",
"error_code": "MINIMUM_QUANTITY",
"retryable": false,
"details": {
"n": 100
}
}एरर फ़ील्ड
errorstring- लोगों के लिए एक तय अंग्रेज़ी संदेश। केवल
errorपढ़ने वाली पुरानी स्क्रिप्ट काम करती रहती हैं। error_codestring- नीचे की सूची से एरर कोड। इस पर शाखा बनाना सुरक्षित है।
retryablebooleantrueजब वही अनुरोध बाद में दोबारा भेजने पर सफल हो सकता है।detailsobject- संदेश में भरे गए मान, नाम से, जैसे
param,rule,nयाtime। केवल तब मौजूद जब कोई हो। retry_afterinteger- दोबारा कोशिश से पहले प्रतीक्षा के सेकंड। तब मौजूद जब प्रतीक्षा पता हो, और
Retry-Afterहेडर में भी दोहराया जाता है।
HTTP स्टेटस
ये वे स्टेटस हैं जो API इस्तेमाल करती है। HTTP कारण वाक्यांश प्रोटोकॉल नाम हैं और अंग्रेज़ी में ही रहते हैं।
- 400
Bad Request
अनुरोध मान्य नहीं है। दोबारा भेजने से पहले इसे ठीक करें।
- 401
Unauthorized
API कुंजी मान्य नहीं है।
- 402
Payment Required
वॉलेट बैलेंस बहुत कम है।
- 403
403
खाता अभी API इस्तेमाल नहीं कर सकता।
- 404
Not Found
सेवा, ऑर्डर, रिफिल या webhook नहीं मिला।
- 405
405
केवल POST स्वीकार किया जाता है।
- 409
Conflict
अनुरोध किसी सेवा, ऑर्डर या पहले के अनुरोध आईडी की स्थिति से टकराता है।
- 410
410
सेवा बंद कर दी गई है।
- 413
413
अनुरोध की बॉडी बहुत बड़ी है।
- 429
Too Many Requests
रेट लिमिट पूरी हो गई। प्रतीक्षा करें, फिर दोबारा कोशिश करें।
- 500
500
हमारी तरफ़ की गड़बड़ी। अनुरोध दोहराना सुरक्षित है।
- 503
503
API या ऑर्डर देना थोड़ी देर के लिए रोका गया है। Retry-After तक प्रतीक्षा करें।
सुरक्षित रीट्राई
जब retryable true हो, तो retry_after या Retry-After हेडर तक प्रतीक्षा करें, थोड़ा रैंडम जिटर जोड़ें और अनुरोध फिर भेजें। जब वह false हो, तो पहले अनुरोध बदलें। अगर add कॉल टाइमआउट हो या INTERNAL_ERROR से विफल हो, तो उसे उसी request_id (अधिकतम 128 अक्षर) के साथ दोबारा भेजें: आपको मूल ऑर्डर वापस मिलता है, कभी दूसरा नहीं।
उदाहरण
key=YOUR_API_KEY&action=add&service=7&link=https://instagram.com/example&quantity=10{
"error": "Minimum quantity is 100",
"error_code": "MINIMUM_QUANTITY",
"retryable": false,
"details": {
"n": 100
}
}key=YOUR_API_KEY&action=add&service=7&link=https://instagram.com/example&quantity=10000{
"error": "Insufficient balance",
"error_code": "INSUFFICIENT_BALANCE",
"retryable": false
}key=YOUR_API_KEY&action=balance{
"error": "Rate limit exceeded",
"error_code": "API_RATE_LIMITED",
"retryable": true,
"retry_after": 12
}key=YOUR_API_KEY&action=add&link=https://instagram.com/example&quantity=100{
"error": "Missing required parameter: service",
"error_code": "MISSING_PARAMETER",
"retryable": false,
"details": {
"param": "service"
}
}सभी एरर कोड
संदेश तय टेम्पलेट है; उसके प्लेसहोल्डर details से भरे जाते हैं। हर कोड अपना HTTP स्टेटस और दोबारा कोशिश से मदद मिल सकती है या नहीं, यह दिखाता है।
अनुरोध और खाता
- 401
INVALID_KEY
Invalid API keyकुंजी गायब है, गलत है या रद्द की जा चुकी है। पहले अनुरोध ठीक करें।
- 405
METHOD_NOT_ALLOWED
Use POSTअनुरोध POST नहीं था। पहले अनुरोध ठीक करें।
- 413
BODY_TOO_LARGE
Request body too largeअनुरोध की बॉडी बहुत बड़ी है। पहले अनुरोध ठीक करें।
- 400
INVALID_ACTION
Invalid actionयह कार्रवाई दस्तावेज़ में दी गई कार्रवाइयों में से नहीं है। पहले अनुरोध ठीक करें।
- 400
MISSING_PARAMETER
Missing required parameter: {param}एक ज़रूरी पैरामीटर गायब है। details.param उसका नाम बताता है। पहले अनुरोध ठीक करें।
- 400
INVALID_PARAMETER
Invalid {param}: {rule}किसी पैरामीटर का मान अमान्य है। details.param और details.rule बताते हैं कि कौन सा और क्यों। पहले अनुरोध ठीक करें।
- 400
TOO_MANY_IDS
Maximum 100 IDs per requestएक सूची में एक अनुरोध की क्षमता से अधिक आईडी हैं। पहले अनुरोध ठीक करें।
- 403
INACTIVE_ACCOUNT
Account suspendedखाता निलंबित है। पहले अनुरोध ठीक करें।
- 403
EMAIL_UNVERIFIED
Email verification requiredखाते का ईमेल पता अभी सत्यापित नहीं हुआ है। पहले अनुरोध ठीक करें।
उपलब्धता और सीमाएँ
- 503
API_DISABLED
The API is temporarily disabledAPI थोड़ी देर के लिए बंद है। Retry-After बताता है कि दोबारा कब कोशिश करें। दोबारा कोशिश से मदद मिल सकती है।
- 429
API_RATE_LIMITED
Rate limit exceededरेट लिमिट पूरी हो गई। रेट लिमिट देखें। दोबारा कोशिश से मदद मिल सकती है।
- 500
INTERNAL_ERROR
Internal server errorहमारी तरफ़ कुछ विफल हुआ। उसी request_id के साथ add दोहराना सुरक्षित है। दोबारा कोशिश से मदद मिल सकती है।
सेवाएँ और ऑर्डर देना
- 404
SERVICE_NOT_FOUND
Service not foundइस आईडी की कोई सेवा नहीं है, या वह आपके लिए उपलब्ध नहीं है। पहले अनुरोध ठीक करें।
- 410
SERVICE_DISCONTINUED
Service has been discontinuedसेवा बंद कर दी गई है। पहले अनुरोध ठीक करें।
- 409
SERVICE_PAUSED
Service is temporarily unavailableसेवा फ़िलहाल रोकी गई है। बाद में फिर कोशिश करें। दोबारा कोशिश से मदद मिल सकती है।
- 503
ORDER_PLACEMENT_PAUSED
Ordering is temporarily pausedसभी के लिए ऑर्डर देना थोड़ी देर के लिए रोका गया है। Retry-After बताता है कि दोबारा कब कोशिश करें। दोबारा कोशिश से मदद मिल सकती है।
- 400
INVALID_LINK
Link is invalid for this serviceलिंक इस सेवा के अनुकूल नहीं है। पहले अनुरोध ठीक करें।
- 400
LINK_BLOCKED
This link is blocked. Contact support if this is a mistake.लिंक ब्लॉक है। अगर आपको लगे कि यह गलती है, तो सपोर्ट से संपर्क करें। पहले अनुरोध ठीक करें।
- 409
LINK_BUSY
An order for this link is still running. Wait until it finishes.इस लिंक के लिए पहले का ऑर्डर अब भी चल रहा है। उसके खत्म होने तक प्रतीक्षा करें। दोबारा कोशिश से मदद मिल सकती है।
- 400
MINIMUM_QUANTITY
Minimum quantity is {n}मात्रा सेवा के न्यूनतम से कम है। पहले अनुरोध ठीक करें।
- 400
MAXIMUM_QUANTITY
Maximum quantity is {n}मात्रा सेवा के अधिकतम से अधिक है। पहले अनुरोध ठीक करें।
- 400
QUANTITY_STEP
Quantity must be a multiple of {step}मात्रा सेवा के स्टेप का गुणज नहीं है। पहले अनुरोध ठीक करें।
- 400
QUANTITY_MISMATCH
quantity must equal the number of items in {param} ({count})मात्रा किसी सूची या रिएक्शन फ़ील्ड के आइटमों की संख्या से मेल नहीं खाती। पहले अनुरोध ठीक करें।
- 400
MINIMUM_ORDER_AMOUNT
Minimum order amount is ${amount}ऑर्डर का मूल्य न्यूनतम ऑर्डर राशि से कम है। पहले अनुरोध ठीक करें।
- 402
INSUFFICIENT_BALANCE
Insufficient balanceवॉलेट बैलेंस शुल्क से कम है। पहले अनुरोध ठीक करें।
- 400
INVALID_OPTION
Invalid {param}: {rule}किसी अतिरिक्त फ़ील्ड का मान अमान्य है। details.param और details.rule बताते हैं कि कौन सा और क्यों। पहले अनुरोध ठीक करें।
- 400
OPTION_NOT_SUPPORTED
This service does not accept {param}आपके भेजे गए फ़ील्ड को सेवा स्वीकार नहीं करती। पहले अनुरोध ठीक करें।
- 400
DRIP_FEED_NOT_AVAILABLE
Drip-feed is not available for this serviceसेवा में ड्रिप फीड नहीं है, या इस मात्रा के लिए नहीं है। पहले अनुरोध ठीक करें।
- 400
DRIP_FEED_CONFLICT
Send runs and interval, or drip_feed_total_minutes, not bothएक अनुरोध में ड्रिप फीड के दोनों रूप भेजे गए। पहले अनुरोध ठीक करें।
- 400
DRIP_FEED_INVALID
{rule}ड्रिप फीड के मान सीमाओं में नहीं बैठते। संदेश बताता है कि कौन सी सीमा। पहले अनुरोध ठीक करें।
- 429
ORDER_LIMIT_REACHED
Too many orders. Try again later.एक साथ बहुत ज़्यादा ऑर्डर दिए गए हैं या खुले हैं। बाद में फिर कोशिश करें। दोबारा कोशिश से मदद मिल सकती है।
- 409
SERVICE_CHANGED
Service settings changed while placing the order. Retry.ऑर्डर देते समय सेवा की सेटिंग बदल गई। अनुरोध फिर भेजें। दोबारा कोशिश से मदद मिल सकती है।
- 409
REQUEST_ID_CONFLICT
request_id was already used with different parametersइस request_id से पहले ही अलग पैरामीटर वाला ऑर्डर बन चुका है। पहले अनुरोध ठीक करें।
ऑर्डर और रद्द करना
- 404
ORDER_NOT_FOUND
Order not foundइस नंबर का कोई ऑर्डर आपके खाते का नहीं है। पहले अनुरोध ठीक करें।
- 409
ORDER_FINISHED
Order is already {status}ऑर्डर पहले ही खत्म हो चुका है। पहले अनुरोध ठीक करें।
- 409
CANCEL_NOT_AVAILABLE
Cancel is not available for this orderइस ऑर्डर के लिए रद्द करना संभव नहीं है। पहले अनुरोध ठीक करें।
- 409
CANCEL_REFUSED
The order could not be canceled. You can ask again after {time}.रद्द करने का अनुरोध अस्वीकार हुआ। आप details.time में दिए समय के बाद फिर पूछ सकते हैं। दोबारा कोशिश से मदद मिल सकती है।
रिफिल
- 409
REFILL_NOT_AVAILABLE
Refill is not available for this orderइस ऑर्डर के लिए रिफिल संभव नहीं है। पहले अनुरोध ठीक करें।
- 409
REFILL_NOT_COMPLETED
Refill is available after the order is completedऑर्डर पूर्ण होने के बाद रिफिल संभव है। दोबारा कोशिश से मदद मिल सकती है।
- 409
REFILL_COOLDOWN
You can request a refill again after {time}इस ऑर्डर के लिए हाल ही में रिफिल का अनुरोध किया गया था। details.time के बाद फिर कोशिश करें। दोबारा कोशिश से मदद मिल सकती है।
- 409
REFILL_ALREADY_PENDING
A refill request is already in progress for this orderइस ऑर्डर के लिए रिफिल पहले से जारी है। दोबारा कोशिश से मदद मिल सकती है।
- 404
REFILL_NOT_FOUND
Refill not foundइस आईडी का कोई रिफिल आपके खाते का नहीं है। पहले अनुरोध ठीक करें।
Webhooks
- 409
WEBHOOK_LIMIT
Maximum {limit} webhook endpoints per accountखाते में webhook endpoint की अधिकतम संख्या पहले से है। पहले अनुरोध ठीक करें।
- 404
WEBHOOK_NOT_FOUND
Webhook not foundआपके खाते में इस आईडी का कोई webhook endpoint नहीं है। पहले अनुरोध ठीक करें।
- 400
INVALID_WEBHOOK_URL
Invalid webhook URLयह URL सार्वजनिक https पता नहीं है। पहले अनुरोध ठीक करें।