ऑर्डर
ऑर्डर दें
ऑर्डर बनाता है और पैसा एक ही चरण में काटता है। जवाब तुरंत मिलता है: ऑर्डर लंबित होता है और उसके पहले 15 सेकंड में मुफ़्त रद्द किया जा सकता है। अपना request_id भेजें ताकि रीट्राई से कभी दूसरा ऑर्डर न बने।
https://notpanel.com/api/v3action=add- API की आवश्यक
- रेट लिमिट पार
- बॉडी:
application/x-www-form-urlencoded
पैरामीटर
हमेशा भेजा जाता है
keystringआवश्यक- आपकी API की।
actionstringआवश्यकaddलिटरल स्ट्रिंग "add" होना चाहिए।
ऑर्डर
serviceintegerआवश्यक- सेवा सूची से सेवा आईडी।
linkstringआवश्यक- वह लिंक जिस पर डिलीवर करना है। क्या मान्य है, यह सेवा पर निर्भर करता है।
quantityintegerसेवा के प्रकार पर निर्भर- कुल मात्रा।
runsऔरintervalके साथ यह प्रति रन मात्रा होती है। सूचियाँ और सटीक रिएक्शन अपनी मात्रा खुद गिनते हैं, और पैकेज की मात्रा तय होती है।
रीट्राई
request_idstringवैकल्पिक- इस ऑर्डर के लिए आपका अपना आईडी, अधिकतम 128 अक्षर। उन्हीं पैरामीटर के साथ दोहराने पर मूल ऑर्डर लौटता है। अलग पैरामीटर के साथ इस्तेमाल करने पर
REQUEST_ID_CONFLICTलौटता है। idempotency_keystringवैकल्पिकrequest_idका उपनाम। दोनों भेजे जाएँ तोrequest_idमान्य होता है।
ड्रिप फीड
runsintegerवैकल्पिक- क्लासिक ड्रिप फीड: रन की संख्या, 2 से 100 तक।
runs=1सामान्य ऑर्डर है। intervalintegerवैकल्पिक- क्लासिक ड्रिप फीड: रन के बीच के मिनट, 1 से 1440 तक।
drip_feed_total_minutesintegerवैकल्पिक- सरल ड्रिप फीड: पूरी
quantityइतने मिनट में पूरी करें, 1 से 2880 तक। इसेrunsऔरintervalके साथ न मिलाएँ।
सेवा के फ़ील्ड
reactionsstringवैकल्पिक- Telegram रिएक्शन, जैसे
👍,❤️,🔥या👍:60,❤️:40। comments, usernames, answer_number, …सेवा के प्रकार पर निर्भर- अन्य अतिरिक्त फ़ील्ड उनके नाम से, जैसे
comments,usernamesयाanswer_number। सेवा कीfieldsसूची बताती है कि वह कौन से लेती है।
curl -X POST https://notpanel.com/api/v3 \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "key=YOUR_API_KEY&action=add&service=7&link=https://instagram.com/example&quantity=1000&request_id=550e8400-e29b-41d4-a716-446655440000"const res = await fetch("https://notpanel.com/api/v3", {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
key: "YOUR_API_KEY",
action: "add",
service: "7",
link: "https://instagram.com/example",
quantity: "1000",
request_id: "550e8400-e29b-41d4-a716-446655440000",
}),
});
const data = await res.json();
console.log(data);import requests
res = requests.post(
"https://notpanel.com/api/v3",
data={
"key": "YOUR_API_KEY",
"action": "add",
"service": "7",
"link": "https://instagram.com/example",
"quantity": "1000",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
},
)
print(res.json())<?php
$body = http_build_query([
'key' => 'YOUR_API_KEY',
'action' => 'add',
'service' => '7',
'link' => 'https://instagram.com/example',
'quantity' => '1000',
'request_id' => '550e8400-e29b-41d4-a716-446655440000',
]);
$response = file_get_contents('https://notpanel.com/api/v3', false, stream_context_create([
'http' => [
'method' => 'POST',
'header' => "Content-Type: application/x-www-form-urlencoded\r\n",
'content' => $body,
'ignore_errors' => true,
],
]));
print_r(json_decode($response, true));
YOUR_API_KEY की जगह अपने API पेज की की डालें।
{
"order": 1234567,
"status": "Pending",
"status_key": "pending",
"charge": "1.20",
"currency": "USD",
"instant_cancel_until": "2026-10-03T10:00:15Z",
"cancel_available": true,
"cancel_window_seconds": 15,
"cancel_before": "2026-10-03T10:00:15Z"
}एरर
- 400
{"error":"Minimum quantity is 100","error_code":"MINIMUM_QUANTITY","retryable":false,"details":{"n":100}}मात्रा सेवा के न्यूनतम से कम है। यही रूप अधिकतम, स्टेप और अन्य जाँचों पर भी लागू होता है।
- 402
{"error":"Insufficient balance","error_code":"INSUFFICIENT_BALANCE","retryable":false}वॉलेट शुल्क पूरा नहीं कर सकता। कुछ नहीं कटा और कोई ऑर्डर नहीं बना।
/dashboard/walletमें फ़ंड जोड़ें। - 409
{"error":"request_id was already used with different parameters","error_code":"REQUEST_ID_CONFLICT","retryable":false}उस
request_idसे पहले ही अलग पैरामीटर वाला ऑर्डर बन चुका है। अलग ऑर्डर के लिए नयाrequest_idइस्तेमाल करें।
रिस्पॉन्स
हर सफल add नया ऑर्डर तुरंत लौटाता है। डिलीवरी के आंतरिक विवरण कभी नहीं दिखते; बाद के बदलाव status और webhooks में दिखते हैं।
रिस्पॉन्स फ़ील्ड
orderinteger- ऑर्डर नंबर। यह डैशबोर्ड, सपोर्ट और हर अन्य कार्रवाई में वही नंबर होता है।
statusstring- नए ऑर्डर के लिए
Pending। दोहराया गयाrequest_idऑर्डर का मौजूदा स्टेटस लौटाता है। status_keystring- नए ऑर्डर के लिए
pending, वरना मौजूदा स्टेटस की key। chargestring- आपसे कितना शुल्क लिया गया, USD में, स्ट्रिंग के रूप में।
currencystring- हमेशा
USD। instant_cancel_untilstring (UTC time)- मुफ़्त रद्दीकरण अवधि का अंत: ऑर्डर देने के 15 सेकंड बाद।
cancel_availablebooleantrueजब तक ऑर्डर अब भी पूरे रिफ़ंड के साथ रद्द किया जा सकता है। पुरानी स्क्रिप्ट के लिए रखा गया।cancel_window_secondsinteger- मुफ़्त रद्दीकरण अवधि सेकंड में: 15। पुरानी स्क्रिप्ट के लिए रखा गया।
cancel_beforestring (UTC time)instant_cancel_untilवाला ही समय। पुरानी स्क्रिप्ट के लिए रखा गया।replayedboolean- केवल तभी मौजूद और true जब यह दोहराए गए
request_idका मूल ऑर्डर हो।
रीट्राई और request_id
request_id (या उसका उपनाम idempotency_key, अधिकतम 128 अक्षर) सबसे पहले देखा जाता है। वही अनुरोध मूल ऑर्डर लौटाता है और कुछ भी दो बार नहीं कटता। उसी आईडी वाला अलग अनुरोध REQUEST_ID_CONFLICT लौटाता है। अगर दो प्रतियाँ एक साथ आएँ, तो एक जीतती है और दूसरी को वही ऑर्डर वापस मिलता है।
key=YOUR_API_KEY&action=add&service=7&link=https://instagram.com/example&quantity=1000&request_id=550e8400-e29b-41d4-a716-446655440000{
"order": 1234567,
"status": "In progress",
"status_key": "in_progress",
"charge": "1.20",
"currency": "USD",
"instant_cancel_until": "2026-10-03T10:00:15Z",
"cancel_available": false,
"cancel_window_seconds": 15,
"cancel_before": "2026-10-03T10:00:15Z",
"replayed": true
}key=YOUR_API_KEY&action=add&service=7&link=https://instagram.com/example&quantity=2000&request_id=550e8400-e29b-41d4-a716-446655440000{
"error": "request_id was already used with different parameters",
"error_code": "REQUEST_ID_CONFLICT",
"retryable": false
}ऑर्डर देने के बाद
ऑर्डर Pending होता है और आप उसके पहले 15 सेकंड में उसे पूरे रिफंड के साथ रद्द कर सकते हैं। उसके बाद मिलने वाली समस्याएँ, जैसे गलत लिंक या व्यस्त लिंक, reason_code और स्वचालित रिफंड के साथ Canceled ऑर्डर के रूप में आती हैं। वे कभी add की एरर नहीं होतीं।
क्रम से क्या जाँचा जाता है
मिली पहली समस्या लौटाई जाती है और कुछ नहीं कटता।
- सेवा मौजूद है और ऑर्डर ले सकती है:
SERVICE_NOT_FOUND,SERVICE_DISCONTINUED,SERVICE_PAUSED। - मात्रा न्यूनतम और अधिकतम के भीतर है:
MINIMUM_QUANTITY,MAXIMUM_QUANTITY। - मात्रा स्टेप के अनुसार है:
QUANTITY_STEP। - सूचियाँ और सटीक रिएक्शन: मात्रा आइटमों की संख्या से मेल खाती है,
QUANTITY_MISMATCH। - अतिरिक्त फ़ील्ड उपलब्ध और मान्य हैं:
OPTION_NOT_SUPPORTED,MISSING_PARAMETER,INVALID_OPTION। - ड्रिप फीड मान मेल खाते हैं:
DRIP_FEED_NOT_AVAILABLE,DRIP_FEED_CONFLICT,DRIP_FEED_INVALID। - लिंक सेवा के अनुकूल है:
INVALID_LINK,LINK_BLOCKED। - जहाँ सेवा में यह नियम है, वहाँ प्रति लिंक एक सक्रिय ऑर्डर:
LINK_BUSY। - बैलेंस शुल्क पूरा करता है:
INSUFFICIENT_BALANCE।
add की एरर
ये सभी सामान्य एरर रूप का उपयोग करती हैं। error_code पर शाखा बनाएँ; संदेश का टेक्स्ट लोगों के लिए है।
- 400
MISSING_PARAMETER
Missing required parameter: {param}एक ज़रूरी पैरामीटर गायब है। details.param उसका नाम बताता है। पहले अनुरोध ठीक करें।
- 400
INVALID_PARAMETER
Invalid {param}: {rule}किसी पैरामीटर का मान अमान्य है। details.param और details.rule बताते हैं कि कौन सा और क्यों। पहले अनुरोध ठीक करें।
- 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
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}ऑर्डर का मूल्य न्यूनतम ऑर्डर राशि से कम है। पहले अनुरोध ठीक करें।
- 400
OPTION_NOT_SUPPORTED
This service does not accept {param}आपके भेजे गए फ़ील्ड को सेवा स्वीकार नहीं करती। पहले अनुरोध ठीक करें।
- 400
INVALID_OPTION
Invalid {param}: {rule}किसी अतिरिक्त फ़ील्ड का मान अमान्य है। details.param और details.rule बताते हैं कि कौन सा और क्यों। पहले अनुरोध ठीक करें।
- 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}ड्रिप फीड के मान सीमाओं में नहीं बैठते। संदेश बताता है कि कौन सी सीमा। पहले अनुरोध ठीक करें।
- 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.इस लिंक के लिए पहले का ऑर्डर अब भी चल रहा है। उसके खत्म होने तक प्रतीक्षा करें। दोबारा कोशिश से मदद मिल सकती है।
- 402
INSUFFICIENT_BALANCE
Insufficient balanceवॉलेट बैलेंस शुल्क से कम है। पहले अनुरोध ठीक करें।
- 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 से पहले ही अलग पैरामीटर वाला ऑर्डर बन चुका है। पहले अनुरोध ठीक करें।
- 500
INTERNAL_ERROR
Internal server errorहमारी तरफ़ कुछ विफल हुआ। उसी request_id के साथ add दोहराना सुरक्षित है। दोबारा कोशिश से मदद मिल सकती है।