كيفية ربط خدمات المورّد ببطاقات لوحة SMM عبر API
لماذا نفصل كتالوج المورّد عن واجهة اللوحة
عادةً ما يعيد API المورّد كتالوجًا تقنيًا: معرّف خارجي، واسم، وسعر، وحدود، وحالة، ومعاملات الطلب. في لوحة SMM يجب أن تصل نفس الخدمة إلى بنية مفهومة للعميل: المنصة، ونوع الترويج، والجغرافيا، وصيغة الرابط، وجودة الجمهور أو سرعة التشغيل.
إذا عرضت الكتالوج الخارجي دون معالجة، ستظهر في الواجهة أسماء تقنية وتكرارات وعناصر غير متاحة. يفصل الربط بين منطق الشراء وبطاقة العميل. لا يلزم أن تكون خدمة المورّد الواحدة خدمة منفصلة في اللوحة.
ما البيانات التي يجب الحصول عليها عبر API
احفظ بيانات المورّد الأصلية منفصلة عن إعدادات الواجهة. لا يمكن استبدال المعرّف الخارجي بمعرّف داخلي في اللوحة: فهو مطلوب لإنشاء الطلب والحصول على الحالة والإلغاء وتحليل الأخطاء. من المفيد أيضًا تخزين وقت آخر مزامنة واستجابة API الكاملة أو نسخة منها.
- معرّف المورّد والمعرّف الخارجي للخدمة.
- الاسم والوصف والفئة الخارجية.
- سعر الشراء والعملة ووحدة الحساب.
- الحد الأدنى والأقصى للحجم وخطوة الكمية.
- حالة التوفر والرصيد وعلامة الإيقاف المؤقت.
- متطلبات الرابط وتسجيل الدخول والنشر والتعليق والجغرافيا.
- علامات التشغيل اليدوي والإلغاء وإعادة التشغيل والتنفيذ الجزئي.
عيب الاستيراد التلقائي هو أن المورّدين يسمّون الحقول نفسها بأسماء مختلفة وأحيانًا يرسلون بيانات غير مكتملة. لا يصلح اسم الخدمة لربط مستقر: فقد يُغيَّر دون تغيير المعرّف الخارجي.
مثال على طلب واستجابة كتالوج الخدمات
يعتمد تنسيق 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" }
لا ينبغي كتابة حقول الاستجابة مباشرة في بطاقة الواجهة. يجب أولًا التحقق منها وحفظها في كتالوج المورّد ومطابقتها مع القواعد الداخلية. عيب العمل مع البطاقة الجاهزة فقط هو أن الاستيراد قد يستبدل اسم العميل أو الوصف أو الفئة المختارة يدويًا.
حدّد بنية الفئات في اللوحة أولًا
قبل الاستيراد، حدّد تصنيف اللوحة. يصف المستوى الأعلى عادةً المنصة، ويليه الإجراء: المتابعون، والمشاهدات، والتفاعلات، والتعليقات، ومشاهدو البث أو صيغة أخرى. ويمكن داخلها تقسيم الخدمات حسب الجغرافيا ونوع الجمهور والسرعة وشروط التعويض.
لكل فئة، حدّد السمات الإلزامية. في المشاهدات قد يكون ذلك نوع الرابط وصيغة المحتوى، وفي المتابعين — المنصة والجغرافيا ونوع الملف الشخصي المسموح. عيب البنية المفرطة في التفصيل هو صعوبة صيانة الكتالوج، وبدء اختلاف الخدمات المتشابهة فقط في الفروق الداخلية.
احفظ روابط المورّد والواجهة بشكل منفصل
يجب تخزين الرابط بين خدمة المورّد وبطاقة اللوحة في جدول أو كيان منفصل. يحتاج إلى المورّد، والمعرّف الخارجي، والبطاقة الداخلية، والفئة، وقاعدة السعر، وأولوية المسار، وحالة النشر، وتاريخ آخر تحقق ناجح.
يتيح هذا المخطط استبدال المورّد دون تغيير رابط البطاقة ودون فقدان سجل الطلبات. مثال على صف ربط بصيغة 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 أو الحصول على صفحات في حالات مختلفة من الكتالوج.
لا تنشئ تكرارات عند إعادة المزامنة
للبحث عن خدمة موجودة، استخدم مفتاحًا مركّبًا: معرّف المورّد والمعرّف الخارجي للخدمة. عند كل استيراد متكرر، ابحث أولًا عن السجل بهذا الزوج، ثم حدّث الحقول التقنية. أنشئ سجلًا جديدًا فقط عند غياب هذا المفتاح.
لا تستخدم الاسم أو السعر أو الفئة لإزالة التكرار. قد تتطابق هذه القيم في خدمتين مختلفتين، وقد يعيد المورّد تسمية العنصر دون تغيير المعرّف الخارجي. تحتاج الروابط بالواجهة أيضًا إلى تحكم فريد: يجب ألا يظهر المسار نفسه مرتين بعد إعادة تشغيل المهمة.
من المفيد تقييد التفرد على مستوى قاعدة البيانات: supplier_id + external_service_id لكتالوج المورّد، وsupplier_id + external_service_id + showcase_card_id للربط. عيب القيد الصارم هو أنه عند خطأ في رابط قديم، سيتعين تصحيحه صراحةً بدلًا من إنشاء سجل جديد فوقه.
كيفية العثور على الخدمات المحذوفة والمختفية
لا يمكن اعتبار الخدمة مختفية إلا بعد تمرير ناجح كامل عبر جميع الصفحات. إذا توقفت المزامنة عند خطأ أو حد طلبات أو تعذّر الوصول إلى API، فلا يمكن تعليم العناصر الغائبة عن الجزء المحمّل من الكتالوج كمحذوفة.
بعد اكتمال الاستيراد، ابحث عن خدمات هذا المورّد التي لا يساوي last_seen_sync فيها معرّف الدورة الحالية. تُمنح حالة «غير موجودة» أو «مؤرشفة»، وتُعطَّل عن الطلبات الجديدة وتُرسَل للتحقق. يُحتفظ بالمعرّف الخارجي وسجل التغييرات والروابط بالطلبات.
يجب أرشفة الخدمة المختفية، لا حذفها. فقد يعيدها المورّد إلى الكتالوج لاحقًا، أو يغيّر مرشّح الاستجابة، أو يخفي العنصر مؤقتًا. يمكن استعادة الرابط المؤرشف عند الاستيراد التالي إذا ظهر المعرّف الخارجي نفسه مجددًا.
ماذا تفعل عند تغيّر المعرّف الخارجي للخدمة
إذا أنشأ المورّد خدمة جديدة بدلًا من القديمة، فلا يمكن اعتبار المعرّف الخارجي الجديد استمرارًا تلقائيًا للسابق. حتى مع تطابق الاسم والسعر، قد تتغير متطلبات الطلب أو الجغرافيا أو نوع الجمهور أو شروط التعويض.
انقل الرابط القديم إلى الأرشيف، وأزل المسار من البيع، واحفظه للطلبات القديمة. استورد الخدمة الجديدة كسجل منفصل. ثم أنشئ ربطًا جديدًا يدويًا أو وفق قاعدة آمنة، إذا كانت المعاملات التقنية متوافقة تمامًا.
قد تسرّع المطابقة التلقائية بالاسم العمل، لكن عيبها هو خطر إرسال الطلب إلى خدمة أخرى بشروط غير مناسبة. لتغيير المعرّف، يُفضّل استخدام حالة «تتطلب تحققًا» بدلًا من استبدال المسار بهدوء.
اضبط الربط وفق الحقول التقنية المستقرة
من الأفضل بناء التوزيع التلقائي للخدمات وفق مجموعة حقول: المنصة، ونوع الخدمة، والجغرافيا، وصيغة الرابط، والحد الأدنى للحجم، والمعاملات الإضافية، والحالة. على سبيل المثال، قد تندرج خدمة ضمن فئة المشاهدات حسب الجغرافيا إذا كان API يرسل قيمًا متوافقة للمنصة ونوع الترويج والدولة.
إذا كان المورّد يتطلب تعليقًا أو قائمة ملفات شخصية أو تشغيلًا يدويًا، فلا تنشر المسار في نموذج الطلب القياسي. استخدم بطاقة منفصلة بالحقول المطلوبة أو أبقِ الخدمة مخفية حتى استكمال التكامل.
يجوز استخدام الاسم كعلامة إضافية فقط. عيب هذه القاعدة هو أن المورّد قد يغيّر الصياغة أو يضيف اختصارًا أو يستخدم كتابة مختلفة. اربط المسارات الحرجة بالمعرّف الخارجي والمعاملات القابلة للتحقق في الاستجابة.
افصل بيانات API عن إعدادات البطاقة
يجب ألا يستبدل الاستيراد بطاقة الواجهة بالكامل. عادةً تُحدَّث من المورّد أسعار الشراء والحدود والتوفر والمعاملات التقنية. أما اسم العميل والوصف والظهور وترتيب العرض وقواعد هامش الربح فتبقى إعدادات داخلية للوحة.
لكل حقل، حدّد مصدر الحقيقة. على سبيل المثال، يُؤخذ الحد الأدنى للحجم من API، واسم العميل من اللوحة، ويُحسب سعر الواجهة وفق قاعدة داخلية بناءً على تكلفة الشراء. بدون هذا الفصل، قد تمحو المزامنة وصفًا محرَّرًا يدويًا أو تغيّر الفئة وفق الاسم الخارجي.
تحقق من تغييرات السعر والمعاملات
إذا غيّر المورّد السعر، فأعد حساب سعر الواجهة وفق قاعدة البطاقة، وتحقق من العملة والعمولات والهامش المسموح. عند غياب السعر أو جهل العملة أو تغيّر ملحوظ في الشروط، يُفضّل نقل المسار إلى حالة التحقق.
عند تغيّر الحد الأدنى أو الأقصى أو خطوة الكمية، حدّث نموذج الطلب. إذا لم يدعم النموذج القيود الجديدة، فأزل المسار من البيع. وإلا فسيُنشئ العميل طلبًا يرفضه المورّد بعد الإرسال.
إذا تغيّرت صيغة الرابط أو الحقل الإلزامي أو نوع الخدمة أو طريقة التشغيل، فاحجب الطلبات الجديدة حتى التحقق اليدوي. عيب الحجب الصارم هو اختفاء بعض البطاقات مؤقتًا من الواجهة، لكنه أكثر أمانًا من قبول طلبات غير متوافقة.
تعامل مع أخطاء API وحدود الطلبات
لا ينبغي أن يؤدي خطأ طلب واحد إلى تعطيل الكتالوج بأكمله تلقائيًا. افصل بين أخطاء التفويض والطلب غير الصحيح والتعذر المؤقت وتقييد معدل الطلبات. تحتاج كل مجموعة إلى سيناريو منفصل.
- عند خطأ التفويض، أوقف الطلبات الجديدة لهذا المورّد وتحقق من الوصول.
- عند خطأ صيغة الطلب، احفظ استجابة API وأصلح التكامل دون تكرار لا نهائي.
- عند خطأ مؤقت، أعد الطلب بفاصل زمني متزايد.
- عند تقييد معدل الطلبات، احفظ المؤشر الحالي وأعد جدولة المهمة.
لا تعلّم الخدمات كمختفية حتى تكتمل المزامنة المؤجلة بنجاح. عيب التكرارات العدوانية هو إمكانية استنفاد حد الطلبات بسرعة وإبقاء الكتالوج قديمًا لفترة أطول.
احفظ المسارات للطلبات النشطة
حالة الخدمة وحالة الطلب كيانان مختلفان. قد تختفي الخدمة من الكتالوج للعملاء الجدد، لكن الطلبات القديمة عليها لا تزال قيد التنفيذ. يجب ألا تؤدي أرشفة البطاقة أو المسار إلى إيقاف استعلام حالات الطلبات المنشأة بالفعل.
لكل طلب، احفظ المعرّف الخارجي للخدمة، والمعرّف الخارجي للطلب، والمعاملات المرسلة، وتكلفة الشراء وقت التشغيل، وسجل الحالات. إذا أبلغ المورّد عن تنفيذ جزئي أو إلغاء أو خطأ، فتعامل مع الموقف وفق قواعد اللوحة: استرداد أو تعويض أو إعادة تشغيل أو تحقق يدوي.
عيب تخزين نسخة من معاملات الطلب هو الحاجة إلى مساحة أكبر ومخطط بيانات دقيق. بدون هذه النسخة، يستحيل تحديد الشروط التي أُرسل بها الطلب إذا غيّر المورّد الخدمة لاحقًا.
اختبر الربط قبل نشر البطاقات
بعد الإعداد، تحقق من المسار الكامل: إنشاء طلب في اللوحة، واختيار المسار، والإرسال إلى المورّد، وحفظ المعرّف الخارجي، وتلقي الحالة، والإلغاء، ومعالجة التنفيذ الجزئي. اختبر مجموعات خدمات بحدود وروابط وحقول إلزامية مختلفة.
بشكل منفصل، حاكِ الاستيراد المتكرر، وتغيّر السعر، واختفاء الخدمة بعد تمرير كامل ناجح، وخطأ في منتصف الترقيم الصفحي، وتقييد معدل الطلبات. سيوضح ذلك ما إذا كانت اللوحة تؤرشف مسارات عاملة بسبب تحميل كتالوج غير مكتمل.
أولِ اهتمامًا خاصًا للخدمات اليدوية والعناصر ذات التعليقات. عيبها هو أن نموذج اللوحة القياسي غالبًا لا ينقل جميع البيانات التي يتوقعها المورّد. تحتاج إلى قالب طلب منفصل أو حالة مخفية حتى استكمال تكامل 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. استخدم كود الخصم "December2025" للحصول على خصم 15٪ لجميع مشاهدينا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
خدماتنا لصانعي المحتوى









