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. ہم نے یکم جنوری تک اپنے کنفیگریٹر اور سب سے سستی ویور کیٹیگری ک..
Twitch خدمات ہیں مستحکم کام کرنا ، لہذا ہم اسکواڈ ، ری سیلرز کے ساتھ تعاون کرنے کے لئے تیار ہیں, سروس مالکان ، بوٹ مالکان ، اور بہت سے دوسرے ۔ ٹیل..
ہم ہماری Twitch ناظرین کی خدمات کو مکمل طور پر اپ ڈیٹ کر دیا ہے ، اور وہ اب ہیں مستحکم کام کرنا ۔ ہم صرف ناظرین کے لئے اعلی معیار کے IP پتے استعم..
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
مواد تخلیق کاروں کے لیے ہماری خدمات








