रेफ़रेंस
चेंजलॉग
v3 API में ब्रेकिंग और उल्लेखनीय बदलाव। हम इसका पालन करते हैं semver (नए टैब में खुलता है) — एडिटिव बदलाव (नए वैकल्पिक पैरामीटर, नए एक्शन, रिस्पॉन्स में नई फ़ील्ड) एक major वर्शन के भीतर आते हैं; ब्रेकिंग बदलाव एक नए major में जाते हैं।
- नवीनतम
v3.2: नई ऑर्डर प्रणाली: एक एरर सूची, सरल ड्रिप फीड, अधिक स्पष्ट रद्दीकरण और रिफिल
नीचे का सब कुछ
X-NotPanel-API-Version: 2026-10हेडर के तहत एक साथ आता है। पिछली हर कार्रवाई काम करती रहती है, और /api/v1, /api/v2 और /api/v3 पते एक जैसे व्यवहार करते हैं।- हर ऑर्डर का एक नंबर होता है जो डैशबोर्ड, सपोर्ट और API में चलता है। API ऑर्डर अपने पुराने नंबर रखते हैं।
- ड्रिप फीड:
intervalके साथrunsअब भी काम करता है। नया सरल रूप कुलquantityऔरdrip_feed_total_minutesलेता है, 48 घंटे तक। - पहले 15 सेकंड में रद्दीकरण तुरंत और पूरे रिफंड के साथ होता है। उसके बाद, जहाँ सेवा सपोर्ट करे, आप स्वचालित रिफंड के साथ रद्द करने का अनुरोध कर सकते हैं।
orderपहले की तरह एक ऑब्जेक्ट लौटाता है;ordersएक ऐरे लौटाता है। - रिफिल हर ऑर्डर के लिए हर 6 घंटे में एक बार काम करता है, बिना अंतिम तारीख के और अस्वीकार होने पर स्पष्ट कारण के साथ।
- Telegram रिएक्शन एक ही
reactionsफ़ील्ड हैं, या तो मिश्रण (👍,❤️,🔥) या सटीक गिनती (👍:60,❤️:40), जो शुल्क लिए जाने से पहले जाँची जाती है। - सेवा सूची में टैग, सीमाओं वाले अतिरिक्त फ़ील्ड, ड्रिप फीड सीमाएँ और उपलब्धता दिखती हैं।
cancel: trueका अब मतलब है कि रद्द करने के अनुरोध सचमुच काम करते हैं। - हर एरर का एक तय कोड, एक HTTP स्टेटस और एक retryable फ़्लैग होता है। पिछले कोड और मौजूदा कोड नीचे सूचीबद्ध हैं।
- नया
order_details, जो आपकेrequest_idसे भी ऑर्डर ढूँढ सकता है। statusमें ही रिफंड आता है: रद्द या आंशिक ऑर्डर के लिएrefundरिफंड की गई राशि है, इसलिए अलग कॉल की ज़रूरत नहीं।refund_quoteएक पुराना नाम है जोstatusजैसा ही जवाब लौटाता है।- Webhooks अब एक ही प्रणाली हैं: हर कॉल के लिए एक हस्ताक्षरित इवेंट, संस्करण सहित, रद्द और आंशिक ऑर्डर के लिए और रिफिल नतीजों के लिए नए इवेंट के साथ।
- हटाया गया: बैच webhook बॉडी,
couponपैरामीटर, और status सेrefund_pendingफ़ील्ड तथा रिफंड नीति वाले दो फ़ील्ड। पुरानाdelayपैरामीटर अब पढ़ा नहीं जाता;drip_feed_total_minutesइस्तेमाल करें। - जोड़ा गया: status में
can_cancelऔरaddके जवाब मेंinstant_cancel_until। पुरानाcancel_availableदोनों में बना रहता है, औरcancel_window_secondsवcancel_beforeaddके जवाब में बने रहते हैं। - बरकरार:
catalogऔरaccount_statusकार्रवाइयाँ पहले की तरह काम करती रहती हैं, औरcatalogअब सेवाओं की सूची में दर्ज है। पुराने पैरामीटर नाम अब भी काम करते हैं:referer,lpost_count, हैशटैग सूचियों के लिएhashtag, कॉमा से अलगusernamesऔर पुराना रिएक्शन मैप।webhook.addइवेंट नामorder.refundedऔरorder.refill_completedभी स्वीकार करता है। /api/v1,/api/v2और/api/v3सभी काम करते रहते हैं और एक जैसा व्यवहार करते हैं। दस्तावेज़ में/api/v3है।- पूर्ण ऑर्डर में
remainsहमेशा 0 दिखता है।
v3.1: Optional market-native service names
services और catalog actions अब दस supported languages में curated market terminology से localized service names के लिए optional language code लेते हैं। Explicit request canonical-name और actual-language metadata जोड़ती है तथा missing या stale translation पर safely English fallback करती है। language के बिना legacy English response shape unchanged रहता है। Admins हर नाम की समीक्षा या refinement कर सकते हैं।
v3.0: v3 अब डिफ़ॉल्ट API है
/api/v3 canonical endpoint और familiar reseller contract का direct base-URL replacement बना। v3 optional exact retry keys, 60-second legacy duplicate protection, advanced catalog, numeric IDs, refund_quote, account_status, single/bulk cancel, batch status/refill और signed webhooks जोड़ता है। API throughput अब lifetime successful spend tier और account की सभी keys द्वारा shared एक rolling 60-second window इस्तेमाल करता है। /api/v1 और /api/v2 इसी current contract के exact aliases हैं।
v2.5: Advanced catalog, refund reconciliation और cancellation
पृष्ठों में बँटा catalog और केवल पढ़ने योग्य refund_quote कार्य जोड़े गए, add और status मेटाडेटा बढ़ाया गया, और API के सामान्य ऑर्डर के लिए 15 सेकंड की रद्दीकरण अवधि जोड़ी गई। API वेबहुक इवेंट में अब स्थिर इवेंट id होता है, जबकि उसी बैच के पुनः प्रयासों में deliveryId स्थिर रहता है; हर पुनः प्रयास को नया टाइमस्टैम्प और हस्ताक्षर मिलता है। वेबहुक डिलीवरी पुनः प्रयासों के साथ यथासंभव होती है, कम से कम एक बार डिलीवरी की टिकाऊ गारंटी नहीं है।
v2.4: कैटलॉग में 12 नए मीडिया प्लेटफ़ॉर्म
Google, Rumble, Audiomack, Tumblr, Kwai, Clubhouse, Vimeo, Deezer, Tidal, Apple Music, Quora, और GitHub के लिए सेवाएं जोड़ी गईं। वे किसी भी अन्य सर्विस की तरह services एक्शन में दिखती हैं और हर एक का एक समर्पित सार्वजनिक प्लेटफ़ॉर्म पेज है। कोई क्लाइंट बदलाव आवश्यक नहीं — नए सर्विस ID बस कैटलॉग में दिखने लगते हैं।
v2.3: Add पर service availability लागू हुई
Unavailable services नया order चुपचाप accept या queue करने की जगह action=add अस्वीकार करती हैं। Retry से पहले catalog refresh करें और available service चुनें।
v2.2: वैकल्पिक ऑर्डर पैरामीटर
add action अब supported service-type-specific optional fields स्वीकार करता है, जैसे start delay और per-type engagement options। Service type द्वारा पहले से defined fields अपना documented meaning रखते हैं।
v2.1: ऑर्डर प्लेसमेंट पर Drip-feed पैरामीटर
add action dripfeed=true वाली services के लिए runs और interval साथ स्वीकार करता है। कुल delivery quantity × runs है और service maximum से अधिक नहीं हो सकती। Non-drip services दोनों fields अस्वीकार करती हैं।
v2.0: v2 API का सार्वजनिक लॉन्च
Form-encoded v2 action API को rate controls, retries वाले signed best-effort webhooks और idempotent order placement के साथ launch किया गया। मौजूदा v1 और v2 URLs, v3 contract के aliases हैं और documented shared account limit इस्तेमाल करते हैं।
पिछले संस्करणों से बदलाव
एरर कोड और webhook इवेंट के नाम बदल गए। अपना कोड अपडेट करते समय इन सूचियों को एक बार इस्तेमाल करें।
एरर कोड
पिछले जवाब बाईं ओर के कोड इस्तेमाल करते थे। संस्करण 3.2 एक बंद सूची इस्तेमाल करता है, जो एरर में दिखाई गई है। आखिरी कॉलम बताता है कि वे कैसे मेल खाते हैं।
| पहले | अब | कैसे बदला |
|---|---|---|
| INVALID_ACTION | INVALID_ACTION | वही कोड। |
| MISSING_SERVICE, MISSING_LINK, MISSING_QUANTITY, MISSING_ORDER, MISSING_ORDER_PARAMETER, MISSING_REFILL, MISSING_WEBHOOK_URL, MISSING_WEBHOOK_ID, NO_ORDER_IDS, NO_REFILL_IDS, NO_WEBHOOK_EVENTS, MISSING_CUSTOM_FIELD | MISSING_PARAMETER | पिछले कई कोड एक हो गए। ब्योरे के लिए details पढ़ें। |
| INVALID_SERVICE_ID, INVALID_QUANTITY, LINK_TOO_LONG, IDEMPOTENCY_EMPTY, IDEMPOTENCY_EMPTY_REQUEST, IDEMPOTENCY_TOO_LONG, IDEMPOTENCY_TOO_LONG_REQUEST, INVALID_LANGUAGE, INVALID_WEBHOOK_EVENT | INVALID_PARAMETER | पिछले कई कोड एक हो गए। ब्योरे के लिए details पढ़ें। |
| INVALID_LINK_URL | INVALID_LINK, LINK_BLOCKED | पिछला एक कोड कई हो गया, हर एक अधिक विशिष्ट। |
| INVALID_CUSTOM_FIELD | INVALID_OPTION | वही कोड। |
| RUNS_INVALID, RUNS_TOO_HIGH, INTERVAL_INVALID, INTERVAL_TOO_HIGH | DRIP_FEED_INVALID | पिछले कई कोड एक हो गए। ब्योरे के लिए details पढ़ें। |
| REQUEST_ID_CONFLICT | REQUEST_ID_CONFLICT | वही कोड। |
| SERVICE_NOT_FOUND, ADD_SERVICE_NOT_FOUND, WRONG_SERVICE_TYPE | SERVICE_NOT_FOUND | पिछले कई कोड एक हो गए। ब्योरे के लिए details पढ़ें। |
| SERVICE_NOT_ACTIVE | SERVICE_PAUSED | वही कोड। |
| SERVICE_DISCONTINUED, REFILL_SERVICE_DISCONTINUED | SERVICE_DISCONTINUED | पिछले कई कोड एक हो गए। ब्योरे के लिए details पढ़ें। |
| INSUFFICIENT_BALANCE | INSUFFICIENT_BALANCE | वही कोड। |
| ORDER_NOT_FOUND, STATUS_ORDER_NOT_FOUND, REFUND_ORDER_NOT_FOUND, REFILL_ORDER_NOT_FOUND | ORDER_NOT_FOUND | पिछले कई कोड एक हो गए। ब्योरे के लिए details पढ़ें। |
| ORDER_ALREADY_COMPLETED, ORDER_ALREADY_REFUNDED | ORDER_FINISHED | पिछले कई कोड एक हो गए। ब्योरे के लिए details पढ़ें। |
| ORDER_NOT_CANCELLABLE | CANCEL_NOT_AVAILABLE, ORDER_FINISHED | पिछला एक कोड कई हो गया, हर एक अधिक विशिष्ट। |
| TOO_MANY_ORDERS, TOO_MANY_REFILLS | TOO_MANY_IDS | पिछले कई कोड एक हो गए। ब्योरे के लिए details पढ़ें। |
| INACTIVE_ACCOUNT, ACCOUNT_NOT_FOUND, ACCOUNT_ERROR | INACTIVE_ACCOUNT, EMAIL_UNVERIFIED | पिछला एक कोड कई हो गया, हर एक अधिक विशिष्ट। |
| API_RATE_LIMITED, IP_RATE_LIMITED, CANCEL_RATE_LIMITED | API_RATE_LIMITED | पिछले कई कोड एक हो गए। ब्योरे के लिए details पढ़ें। |
| REFILL_STATUS_INELIGIBLE | REFILL_NOT_COMPLETED, REFILL_NOT_AVAILABLE | पिछला एक कोड कई हो गया, हर एक अधिक विशिष्ट। |
| REFILL_SERVICE_NOT_REFILLABLE, REFILL_REQUEST_FAILED | REFILL_NOT_AVAILABLE | पिछले कई कोड एक हो गए। ब्योरे के लिए details पढ़ें। |
| REFILL_ALREADY_PENDING | REFILL_ALREADY_PENDING | वही कोड। |
| REFILL_WAITING_PERIOD | REFILL_COOLDOWN | पिछले कई कोड एक हो गए। ब्योरे के लिए details पढ़ें। |
| REFILL_NOT_FOUND | REFILL_NOT_FOUND | वही कोड। |
| INVALID_WEBHOOK_URL | INVALID_WEBHOOK_URL | वही कोड। |
| WEBHOOK_LIMIT | WEBHOOK_LIMIT | वही कोड। |
| WEBHOOK_NOT_FOUND | WEBHOOK_NOT_FOUND | वही कोड। |
| REQUEST_PROCESSING, REQUEST_OUTCOME_UNKNOWN, REQUEST_OUTCOME_NOT_RECORDED, REQUEST_UNCONFIRMED, REQUEST_RESULT_UNAVAILABLE, CONFLICTING_REQUEST_RECORDS | – | अब नहीं होता। API कभी दूसरे सिस्टम का इंतज़ार नहीं करती, और बाद की समस्याएँ कारण कोड के साथ Canceled ऑर्डर के रूप में आती हैं। |
Webhooks
दो इवेंट नाम बदल गए। बैच बॉडी हट गई: हर कॉल अब id, type, schema_version, created_at, sequence और data वाले एनवेलप में एक इवेंट ले जाती है, और endpoint कुंजी के बजाय खाते के होते हैं।
| पहले | अब |
|---|---|
| order.refunded | order.canceled |
| order.refill_completed | refill.completed |