API के माध्यम से आपूर्तिकर्ता सेवाओं को SMM पैनल कार्ड से कैसे जोड़ें
आपूर्तिकर्ता कैटलॉग को पैनल शोकेस से अलग क्यों रखें
आपूर्तिकर्ता का API आमतौर पर एक तकनीकी कैटलॉग लौटाता है: बाहरी ID, नाम, कीमत, सीमाएँ, स्थिति और ऑर्डर पैरामीटर। SMM पैनल में वही आइटम ग्राहक के लिए समझने योग्य संरचना में जाना चाहिए: प्लेटफ़ॉर्म, प्रचार का प्रकार, भूगोल, लिंक का फ़ॉर्मेट, ऑडियंस की गुणवत्ता या लॉन्च की गति।
यदि बाहरी कैटलॉग को बिना प्रोसेसिंग के दिखाया जाए, तो शोकेस में तकनीकी नाम, डुप्लिकेट और अनुपलब्ध आइटम दिखाई देंगे। मैपिंग खरीद तर्क और ग्राहक कार्ड को अलग करती है। आपूर्तिकर्ता की एक सेवा का पैनल में अलग सेवा होना ज़रूरी नहीं है।
API के माध्यम से कौन-सा डेटा प्राप्त करना चाहिए
आपूर्तिकर्ता के मूल डेटा को शोकेस सेटिंग्स से अलग रखें। बाहरी ID को पैनल के आंतरिक पहचानकर्ता से नहीं बदला जा सकता: यह ऑर्डर बनाने, स्थिति प्राप्त करने, रद्द करने और त्रुटियों का विश्लेषण करने के लिए आवश्यक है। अंतिम सिंक्रोनाइज़ेशन का समय और पूरा API रिस्पॉन्स या उसका स्नैपशॉट भी संग्रहीत करना उपयोगी है।
- आपूर्तिकर्ता का पहचानकर्ता और सेवा का बाहरी ID।
- नाम, विवरण और बाहरी श्रेणी।
- खरीद मूल्य, मुद्रा और गणना की इकाई।
- न्यूनतम, अधिकतम मात्रा और मात्रा का चरण।
- उपलब्धता की स्थिति, शेष और अस्थायी रोक का संकेत।
- लिंक, लॉगिन, पब्लिकेशन, टिप्पणी और भूगोल के लिए आवश्यकताएँ।
- मैन्युअल लॉन्च, रद्दीकरण, पुनः लॉन्च और आंशिक निष्पादन के संकेत।
स्वचालित आयात की कमी यह है कि आपूर्तिकर्ता एक जैसे फ़ील्ड को अलग-अलग नाम देते हैं और कभी-कभी अपूर्ण डेटा भेजते हैं। सेवा का नाम स्थिर संबंध के लिए उपयुक्त नहीं है: बाहरी ID बदले बिना इसे बदला जा सकता है।
सेवा कैटलॉग के अनुरोध और प्रतिक्रिया का उदाहरण
API का फ़ॉर्मेट आपूर्तिकर्ता पर निर्भर करता है, लेकिन तर्क आमतौर पर एक जैसा होता है: पैनल एक्सेस कुंजी और पेज पैरामीटर भेजता है, और बदले में सेवाओं की एक सरणी प्राप्त करता है। उदाहरण के लिए, कर्सर के साथ कैटलॉग अनुरोध इस तरह दिख सकता है:
GET /api/services?cursor=eyJwYWdlIjoyfQ
सशर्त API प्रतिक्रिया:
{ "services": [ { "id": "SP-1042", "name": "Global Followers", "platform": "twitch", "type": "followers", "price": "12.50", "min": 100, "max": 10000, "status": "active" } ], "next_cursor": "eyJwYWdlIjozfQ" }
प्रतिक्रिया के फ़ील्ड को तुरंत शोकेस कार्ड में नहीं लिखना चाहिए। पहले उन्हें जाँचना, आपूर्तिकर्ता कैटलॉग में संग्रहीत करना और आंतरिक नियमों से मिलान करना आवश्यक है। केवल तैयार कार्ड के साथ काम करने की कमी यह है कि आयात ग्राहक का नाम, विवरण या मैन्युअल रूप से चुनी गई श्रेणी को अधिलेखित कर सकता है।
पहले पैनल में श्रेणी संरचना निर्धारित करें
आयात से पहले पैनल की टैक्सोनॉमी निर्धारित करें। शीर्ष स्तर आमतौर पर प्लेटफ़ॉर्म का वर्णन करता है, अगला — क्रिया: सब्सक्राइबर, व्यूज़, प्रतिक्रियाएँ, टिप्पणियाँ, स्ट्रीम दर्शक या अन्य फ़ॉर्मेट। अंदर सेवाओं को भूगोल, ऑडियंस के प्रकार, गति और मुआवज़े की शर्तों के अनुसार विभाजित किया जा सकता है।
प्रत्येक श्रेणी के लिए अनिवार्य विशेषताएँ निर्धारित करें। व्यूज़ के लिए यह लिंक का प्रकार और सामग्री का फ़ॉर्मेट हो सकता है, सब्सक्राइबर के लिए — प्लेटफ़ॉर्म, भूगोल और प्रोफ़ाइल का स्वीकार्य प्रकार। बहुत विस्तृत संरचना की कमी यह है कि कैटलॉग को बनाए रखना कठिन हो जाता है, और करीबी सेवाएँ केवल आंतरिक बारीकियों में भिन्न होने लगती हैं।
आपूर्तिकर्ता और शोकेस के संबंध अलग रखें
आपूर्तिकर्ता की सेवा और पैनल कार्ड के बीच का संबंध एक अलग तालिका या एंटिटी में संग्रहीत होना चाहिए। इसमें आपूर्तिकर्ता, बाहरी ID, आंतरिक कार्ड, श्रेणी, मूल्य नियम, रूट प्राथमिकता, प्रकाशन की स्थिति और अंतिम सफल जाँच की तारीख आवश्यक है।
ऐसी योजना कार्ड के URL को बदले बिना और ऑर्डर इतिहास को खोए बिना आपूर्तिकर्ता को बदलने की अनुमति देती है। JSON में मैपिंग पंक्ति का उदाहरण:
{ "supplier_id": "supplier_a", "external_service_id": "SP-1042", "panel_category": "twitch_followers", "showcase_card_id": "followers_global", "route_priority": 1, "status": "active" }

संबंध अलग-अलग हो सकते हैं, लेकिन प्रत्येक के लिए पहले से अपडेट नियम निर्धारित करें।
- आपूर्तिकर्ता की एक सेवा — एक कार्ड, यदि उसके पैरामीटर और ऑर्डर फ़ॉर्म अद्वितीय हैं।
- विभिन्न आपूर्तिकर्ताओं की कई सेवाएँ — एक कार्ड, यदि वे आवश्यकताओं और शर्तों में संगत हैं।
- आपूर्तिकर्ता की एक सेवा — कई कार्ड, यदि शोकेस इसे भाषा, सेगमेंट या बिक्री के तरीके से विभाजित करता है।
एक कार्ड में कई आपूर्तिकर्ताओं को मिलाने की कमी यह है कि गति, उपलब्धता और वास्तविक निष्पादन शर्तें भिन्न हो सकती हैं। अलग लिंक फ़ॉर्मेट, सीमाओं या अनिवार्य फ़ील्ड वाले रूट को न मिलाएँ।
कैटलॉग को पेज दर पेज आयात करें
आपूर्तिकर्ता कैटलॉग को संख्या, ऑफ़सेट या कर्सर के माध्यम से पेजों में दे सकता है। पहली प्रतिक्रिया में सभी सेवाएँ होना ज़रूरी नहीं है। अगला पेज तब तक अनुरोध करें जब तक API कर्सर, जारी रखने का लिंक या डेटा की उपस्थिति का अन्य स्पष्ट संकेत न दे।
कर्सर पेजिनेशन में प्रोसेसिंग इस तरह होती है: पैनल एक पेज प्राप्त करता है, सभी सेवाओं को सहेजता है, उन्हें वर्तमान चक्र में पाई गई के रूप में दर्ज करता है और केवल तब अगले कर्सर पर जाता है। यदि next_cursor फ़ील्ड अनुपस्थित है, तो ट्रैवर्सल पूर्ण माना जाता है।
- वर्तमान सिंक्रोनाइज़ेशन चक्र का पहचानकर्ता बनाएँ।
- पहला पेज अनुरोध करें और प्राप्त सेवाओं को सहेजें।
- प्रत्येक सेवा के लिए last_seen_sync फ़ील्ड को चक्र के पहचानकर्ता से अपडेट करें।
- अगला अनुरोध करने से पहले अगले पेज का कर्सर सहेजें।
- सभी पेजों के सफल ट्रैवर्सल के बाद कैटलॉग की वर्तमान चक्र से तुलना करें।
पेजों के क्रमिक लोडिंग की कमी यह है कि पूरा आयात अधिक समय ले सकता है। समानांतर अनुरोध प्रक्रिया को तेज़ करते हैं, लेकिन API सीमा तक पहुँचने या कैटलॉग की अलग-अलग स्थिति में पेज प्राप्त करने का जोखिम बढ़ाते हैं।
पुनः सिंक्रोनाइज़ेशन पर डुप्लिकेट न बनाएँ
मौजूदा सेवा खोजने के लिए एक संयुक्त कुंजी का उपयोग करें: आपूर्तिकर्ता का पहचानकर्ता और सेवा का बाहरी ID। प्रत्येक पुनः आयात पर पहले इस जोड़ी से रिकॉर्ड खोजें, फिर तकनीकी फ़ील्ड अपडेट करें। नया रिकॉर्ड केवल तब बनाएँ जब ऐसी कुंजी मौजूद न हो।
डीडुप्लिकेशन के लिए नाम, कीमत या श्रेणी का उपयोग न करें। दो अलग सेवाओं में ये मान मेल खा सकते हैं, और आपूर्तिकर्ता बाहरी ID बदले बिना आइटम का नाम बदल सकता है। शोकेस के साथ संबंधों के लिए भी अद्वितीय नियंत्रण आवश्यक है: कार्य के पुनः चलाने के बाद एक ही रूट दो बार नहीं दिखना चाहिए।
डेटाबेस स्तर पर विशिष्टता सीमित करना उपयोगी है: आपूर्तिकर्ता कैटलॉग के लिए supplier_id + external_service_id और मैपिंग के लिए supplier_id + external_service_id + showcase_card_id। कठोर प्रतिबंध की कमी यह है कि पुराने संबंध में त्रुटि होने पर उसे स्पष्ट रूप से ठीक करना होगा, न कि उसके ऊपर नया रिकॉर्ड बनाना।
हटाई गई और गायब हुई सेवाओं को कैसे खोजें
किसी सेवा को केवल सभी पेजों के पूर्ण सफल ट्रैवर्सल के बाद गायब माना जा सकता है। यदि सिंक्रोनाइज़ेशन त्रुटि, अनुरोध सीमा या API की अनुपलब्धता पर रुक गया, तो कैटलॉग के पहले से लोड किए गए भाग में अनुपस्थित आइटम को हटाया हुआ नहीं चिह्नित किया जा सकता।
पूर्ण आयात के बाद इस आपूर्तिकर्ता की उन सेवाओं को खोजें जिनका last_seen_sync वर्तमान चक्र के पहचानकर्ता के बराबर नहीं है। उन्हें "नहीं मिली" या "आर्काइव की गई" स्थिति दी जाती है, नए ऑर्डर से अलग किया जाता है और जाँच के लिए भेजा जाता है। बाहरी ID, परिवर्तन इतिहास और ऑर्डर के साथ संबंध संरक्षित रहते हैं।
गायब हुई सेवा को हटाना नहीं, आर्काइव करना चाहिए। आपूर्तिकर्ता इसे बाद में कैटलॉग में वापस ला सकता है, प्रतिक्रिया फ़िल्टर बदल सकता है या आइटम को अस्थायी रूप से छिपा सकता है। यदि वही बाहरी ID फिर से प्रकट होता है, तो अगले आयात पर आर्काइव संबंध बहाल किया जा सकता है।
सेवा का बाहरी ID बदलने पर क्या करें
यदि आपूर्तिकर्ता ने पुरानी के बजाय नई सेवा बनाई है, तो नए बाहरी ID को स्वचालित रूप से पिछले की निरंतरता नहीं माना जा सकता। समान नाम और कीमत होने पर भी आइटम की ऑर्डर आवश्यकताएँ, भूगोल, ऑडियंस का प्रकार या मुआवज़े की शर्तें बदल सकती हैं।
पुराने संबंध को आर्काइव में ले जाएँ, रूट को बिक्री से हटाएँ और पुराने ऑर्डर के लिए उसे संरक्षित रखें। नई सेवा को अलग रिकॉर्ड के रूप में आयात करें। फिर मैन्युअल रूप से या सुरक्षित नियम के अनुसार नई मैपिंग बनाएँ, यदि तकनीकी पैरामीटर पूरी तरह संगत हैं।
नाम के आधार पर स्वचालित मिलान काम को तेज़ कर सकता है, लेकिन इसकी कमी यह है कि अनुपयुक्त शर्तों वाली दूसरी सेवा पर ऑर्डर भेजने का जोखिम है। ID बदलने के लिए रूट के मौन प्रतिस्थापन के बजाय "जाँच आवश्यक" स्थिति का उपयोग करना बेहतर है।
स्थिर तकनीकी फ़ील्ड के आधार पर मैपिंग सेट करें
सेवाओं का स्वचालित वितरण फ़ील्ड के एक सेट पर बनाना बेहतर है: प्लेटफ़ॉर्म, सेवा का प्रकार, भूगोल, लिंक का फ़ॉर्मेट, न्यूनतम मात्रा, अतिरिक्त पैरामीटर और स्थिति। उदाहरण के लिए, एक सेवा भूगोल के आधार पर व्यूज़ श्रेणी में आ सकती है, यदि API संगत प्लेटफ़ॉर्म, प्रचार प्रकार और देश के मान देता है।
यदि आपूर्तिकर्ता टिप्पणी, प्रोफ़ाइल की सूची या मैन्युअल लॉन्च की आवश्यकता बताता है, तो रूट को मानक ऑर्डर फ़ॉर्म में प्रकाशित न करें। आवश्यक फ़ील्ड वाला अलग कार्ड उपयोग करें या इंटीग्रेशन के पूरा होने तक सेवा को छिपा रखें।
नाम का उपयोग केवल अतिरिक्त संकेत के रूप में करने की अनुमति है। ऐसे नियम की कमी यह है कि आपूर्तिकर्ता शब्दावली बदल सकता है, संक्षिप्त रूप जोड़ सकता है या अलग वर्तनी का उपयोग कर सकता है। महत्वपूर्ण रूट को बाहरी ID और प्रतिक्रिया के सत्यापन योग्य पैरामीटर से बाँधें।
API डेटा और कार्ड सेटिंग्स को अलग करें
आयात को शोकेस कार्ड को पूरी तरह अधिलेखित नहीं करना चाहिए। खरीद मूल्य, सीमाएँ, उपलब्धता और तकनीकी पैरामीटर आमतौर पर आपूर्तिकर्ता से अपडेट होते हैं। ग्राहक के लिए नाम, विवरण, दृश्यता, प्रदर्शन क्रम और मार्कअप नियम पैनल की आंतरिक सेटिंग्स रहते हैं।
प्रत्येक फ़ील्ड के लिए सत्य का स्रोत निर्धारित करें। उदाहरण के लिए, न्यूनतम मात्रा API से ली जाती है, ग्राहक का नाम — पैनल से, और शोकेस की कीमत खरीद लागत के आधार पर आंतरिक नियम से गणना की जाती है। ऐसे विभाजन के बिना सिंक्रोनाइज़ेशन मैन्युअल रूप से संपादित विवरण को मिटा सकता है या बाहरी नाम के आधार पर श्रेणी बदल सकता है।
कीमत और पैरामीटर के परिवर्तन जाँचें
यदि आपूर्तिकर्ता ने कीमत बदली है, तो कार्ड के नियम से शोकेस की कीमत की पुनर्गणना करें और मुद्रा, कमीशन और स्वीकार्य मार्जिन जाँचें। अनुपस्थित कीमत, अज्ञात मुद्रा या शर्तों में उल्लेखनीय परिवर्तन पर रूट को जाँच स्थिति में ले जाना बेहतर है।
न्यूनतम, अधिकतम या मात्रा के चरण में परिवर्तन पर ऑर्डर फ़ॉर्म अपडेट करें। यदि फ़ॉर्म नई सीमाओं का समर्थन नहीं करता, तो रूट को बिक्री से हटाएँ। अन्यथा ग्राहक ऐसा ऑर्डर करेगा जिसे आपूर्तिकर्ता भेजने के बाद अस्वीकार कर देगा।
यदि लिंक का फ़ॉर्मेट, अनिवार्य फ़ील्ड, सेवा का प्रकार या लॉन्च का तरीका बदल गया है, तो मैन्युअल जाँच तक नए ऑर्डर ब्लॉक करें। कठोर ब्लॉकिंग की कमी यह है कि कुछ कार्ड अस्थायी रूप से शोकेस से गायब हो जाएँगे, लेकिन यह असंगत ऑर्डर स्वीकार करने से सुरक्षित है।
API त्रुटियों और अनुरोध सीमाओं को संभालें
एक अनुरोध की त्रुटि को स्वचालित रूप से पूरे कैटलॉग को बंद नहीं करना चाहिए। प्राधिकरण त्रुटियों, गलत अनुरोध, अस्थायी अनुपलब्धता और अनुरोध आवृत्ति सीमा को अलग करें। प्रत्येक समूह के लिए अलग परिदृश्य आवश्यक है।
- प्राधिकरण त्रुटि पर इस आपूर्तिकर्ता के नए ऑर्डर रोकें और एक्सेस जाँचें।
- अनुरोध फ़ॉर्मेट त्रुटि पर API प्रतिक्रिया सहेजें और अनंत पुनरावृत्ति के बिना इंटीग्रेशन ठीक करें।
- अस्थायी त्रुटि पर बढ़ते विराम के साथ अनुरोध दोहराएँ।
- आवृत्ति सीमा पर वर्तमान कर्सर सहेजें और कार्य को पुनरावृत्ति के लिए स्थगित करें।
जब तक स्थगित सिंक्रोनाइज़ेशन सफलतापूर्वक पूरा न हो, सेवाओं को गायब चिह्नित न करें। आक्रामक पुनरावृत्ति की कमी यह है कि अनुरोध सीमा जल्दी समाप्त हो सकती है और कैटलॉग अधिक समय तक पुराना रह सकता है।
सक्रिय ऑर्डर के लिए रूट संरक्षित रखें
सेवा की स्थिति और ऑर्डर की स्थिति अलग एंटिटी हैं। सेवा नए ग्राहकों के लिए कैटलॉग से गायब हो सकती है, लेकिन उसके पुराने ऑर्डर अभी भी पूरे हो रहे हैं। कार्ड या रूट की आर्काइविंग पहले से बनाए गए ऑर्डर की स्थिति पोलिंग को नहीं रोकनी चाहिए।
प्रत्येक ऑर्डर के लिए सेवा का बाहरी ID, ऑर्डर का बाहरी ID, भेजे गए पैरामीटर, लॉन्च के समय खरीद लागत और स्थिति इतिहास संरक्षित करें। यदि आपूर्तिकर्ता आंशिक निष्पादन, रद्दीकरण या त्रुटि की सूचना देता है, तो पैनल के नियमों के अनुसार स्थिति संभालें: रिफंड, मुआवज़ा, पुनः लॉन्च या मैन्युअल जाँच।
ऑर्डर पैरामीटर का स्नैपशॉट संग्रहीत करने की कमी यह है कि अधिक स्थान और सावधान डेटा योजना की आवश्यकता होगी। ऐसे स्नैपशॉट के बिना यह स्थापित करना असंभव है कि ऑर्डर किन शर्तों पर भेजा गया था, यदि आपूर्तिकर्ता ने बाद में सेवा बदल दी।
कार्ड प्रकाशित करने से पहले मैपिंग का परीक्षण करें
सेटअप के बाद पूरा पथ जाँचें: पैनल में ऑर्डर बनाना, रूट चुनना, आपूर्तिकर्ता को भेजना, बाहरी ID सहेजना, स्थिति प्राप्त करना, रद्द करना और आंशिक निष्पादन को संभालना। अलग सीमाओं, लिंक और अनिवार्य फ़ील्ड वाले सेवा समूहों का परीक्षण करें।
अलग से पुनः आयात, कीमत परिवर्तन, सफल पूर्ण ट्रैवर्सल के बाद सेवा का गायब होना, पेजिनेशन के बीच त्रुटि और अनुरोध आवृत्ति सीमा का अनुकरण करें। इससे पता चलेगा कि पैनल अपूर्ण कैटलॉग लोडिंग के कारण कार्यशील रूट को आर्काइव तो नहीं कर रहा।
मैन्युअल सेवाओं और टिप्पणियों वाले आइटम पर विशेष ध्यान दें। उनकी कमी यह है कि पैनल का मानक फ़ॉर्म अक्सर वह सारा डेटा नहीं भेजता जिसकी आपूर्तिकर्ता अपेक्षा करता है। उनके लिए अलग ऑर्डर टेम्पलेट या API इंटीग्रेशन के पूरा होने तक छिपी स्थिति आवश्यक है।
Last Articles
डिज़ाइन और कार्यक्षमता में क्या बदला हमने साइट को अपडेट किया है ताकि इसके साथ काम करना तेज़ और आसान हो। मुख्य बदलाव इंटरफ़ेस, व्यक्तिगत कैबिनेट और ऑर..
Good afternoon, I've collected all the news during this time.: 1. The main news is that prices for twitch viewers have been greatly reduced, while Tw..
1. हमारे सभी दर्शकों के लिए 15% छूट के लिए प्रोमो कोड "December2025" का उपयोग करें2. हमने 1 जनवरी तक अपने कॉन्फ़िगरेशन टूल और सबसे सस्ते दर्शक श्रेणी ..
चिकोटी सेवाएं हैं स्थिर रूप से काम करना, इसलिए हम दस्तों, पुनर्विक्रेताओं के साथ सहयोग करने के लिए तैयार हैं, सेवा मालिक, बॉट मालिक, और कई अन्य । ..
हम हमारी ट्विच व्यूअर सेवाओं को पूरी तरह से अपडेट कर दिया है, और वे अब हैं स्थिरतापूर्वक काम करना । हम केवल दर्शकों के लिए उच्च गुणवत्ता वाले आईप..
Hello everyone! Today, we are announcing a new feature—"Twitch Viewer Configurator". Now, you can customize any plan for your Twitch channel. Choo..
Greetings, I have compiled a guide for streamers, which will be very relevant at the moment. Now YouTube and twitch have disabled monetization from vi..
We have finally developed the APINow it will be more convenient for our partner sites to work with us.To update the maximum tariffs for YouTube, an up..
साझेदारी सेवाओं और रेफरल कार्यक्रम की भारी लोकप्रियता के कारण, हमने एक सहयोग तालिका बनाई है। सार बहुत सरल है: अधिक लाइव दर्शक - हमारी ओर से अधिक विज्ञ..
स्ट्रीमर्स के लिए हमारी सेवाएं

Shopee

Bigo
कंटेंट क्रिएटर्स के लिए हमारी सेवाएं








