ऑर्डर प्लेस करें
Familiar reseller-panel shape से नया order submit करता है। पुराने clients idempotency fields छोड़ सकते हैं; उसी account का exact payload 60 seconds तक उसी order पर map होता है। Exact caller-controlled retry के लिए optional request_id या idempotency_key alias दोबारा इस्तेमाल करें। सामान्य API order dispatch से पहले 15 seconds hold रहता है।
POST
https://notpanel.com/api/v3action=addAPI की आवश्यकरेट लिमिटेड (shared account + IP + action)बॉडी:
application/x-www-form-urlencodedrequest_id और idempotency_key optional हैं। दोनों न हों तो same account + exact payload को 60-second duplicate protection मिलता है; intentional identical order भी उस window में पहला order लौटाएगा। तुरंत duplicate चाहिए तो unique request_id भेजें, या 60 seconds प्रतीक्षा करें।
पैरामीटर
| नाम | टाइप | विवरण |
|---|---|---|
| keyआवश्यक | string | आपकी API की। |
| actionआवश्यक | string | लिटरल स्ट्रिंग "add" होना चाहिए। |
| serviceआवश्यक | integer | services सूची से सर्विस ID। सबमिशन के समय सर्विस active होनी चाहिए। |
| request_id | string | Optional preferred caller idempotency key, हर logical order के लिए unique और अधिकतम 128 characters। Exact retries में वही value भेजें; दोनों aliases हों तो request_id चुना जाता है। |
| idempotency_key | string | request_id का optional compatibility alias। दोनों fields न हों तो server 60-second identical-payload protection देता है। |
| linkशर्ती | string (URL) | लक्ष्य URL — प्रोफ़ाइल, पोस्ट, वीडियो या चैनल। चुनी हुई सेवा को लिंक चाहिए तो यह अनिवार्य है। अधिकतम 1000 अक्षर; http(s) होना चाहिए। |
| quantityशर्ती | integer | डिलीवर की जाने वाली इकाइयों की संख्या, सेवा की न्यूनतम और अधिकतम सीमा के भीतर। |
| runsशर्ती | integer | केवल dripfeed=true होने पर interval के साथ आवश्यक। Validation से मिली effective configured cap के भीतर positive integer दें; absolute ceiling 1000 है। quantity × runs service maximum से अधिक नहीं हो सकता। |
| intervalशर्ती | integer | केवल dripfeed=true होने पर runs के साथ आवश्यक। Validation से मिली effective configured cap के भीतर positive whole minutes दें; absolute ceiling 2880 minutes है। Non-drip services दोनों fields अस्वीकार करती हैं। ड्रिप-फ़ीड शेड्यूल: अधिकतम 48 घंटे (रन × अंतराल)। |
| coupon | string | लागू किया जाने वाला कूपन कोड, प्रति उपयोगकर्ता, वैश्विक और सेवा संबंधी कूपन सीमाओं के अधीन। |
| delay | integer | वैकल्पिक आरंभ विलंब। यदि चुनी हुई सेवा इस फ़ील्ड का समर्थन करती है, तो 1 से 86400 सेकंड तक की पूर्णांक संख्या दें। |
| lpost_count | integer | Compatible सामान्य services के लिए optional last-post count। 1 से 500 का integer दें, जब तक service इसे अपना canonical field define न करे। |
| reactions | string (map) | Compatible सामान्य services के लिए optional emoji map। JSON या supported PHP-style single-quote form भेजें, अधिकतम 50 emoji keys के साथ। Values या तो सभी R हों या सभी positive integers अधिकतम 1000000; modes कभी mix न करें। Exact counts में उनका sum effective quantity बनता है और committed charge तय करता है। |
उदाहरण रिक्वेस्ट
YOUR_API_KEY को अपने डैशबोर्ड के API पेज के तहत जनरेट की गई की से बदलें।
curl -X POST https://notpanel.com/api/v3 \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "key=YOUR_API_KEY&action=add&service=1&request_id=550e8400-e29b-41d4-a716-446655440000&link=https://instagram.com/example&quantity=1000"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: "1",
request_id: "550e8400-e29b-41d4-a716-446655440000",
link: "https://instagram.com/example",
quantity: "1000",
}),
});
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": "1",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"link": "https://instagram.com/example",
"quantity": "1000",
},
)
print(res.json())<?php
$body = http_build_query([
'key' => 'YOUR_API_KEY',
'action' => 'add',
'service' => '1',
'request_id' => '550e8400-e29b-41d4-a716-446655440000',
'link' => 'https://instagram.com/example',
'quantity' => '1000',
]);
$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));
उदाहरण रिस्पॉन्स
{
"order": 7001,
"status": "Pending",
"status_key": "pending",
"charge": "0.50",
"currency": "USD",
"cancel_available": true,
"cancel_window_seconds": 15,
"cancel_before": "2026-08-25T10:30:15.000Z"
}सामान्य एरर
| स्टेटस | बॉडी | कारण |
|---|---|---|
| 400 | {"error":"Service not found"} | Service ID मौजूद नहीं है। Services सूची दोबारा fetch करके current ID इस्तेमाल करें। |
| 400 | {"error":"Service has been discontinued and is no longer available"} | Service मौजूद है, लेकिन disabled, archived या अब orderable नहीं है। Catalog refresh करके available service चुनें। |
| 400 | {"error":"Insufficient balance"} | अकाउंट बैलेंस ऑर्डर के कुल चार्ज से कम है। डैशबोर्ड से टॉप-अप करें। |
| 400 | {"error":"Quantity must be a positive integer"} | मात्रा शून्य, ऋणात्मक, या non-integer थी। सबमिशन से पहले validate करें। |
| 409 | {"error":"request_id was already used with different parameters"} | Request मौजूदा state से टकराती है, जैसे अलग logical order के लिए add request_id दोबारा इस्तेमाल करना। स्थिति के अनुसार original request या नया unique identifier इस्तेमाल करें। |