چگونه خدمات تأمینکننده را از طریق API به کارتهای پنل SMM متصل کنیم
چرا باید کاتالوگ تأمینکننده را از ویترین پنل جدا کرد
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" }
فیلدهای پاسخ را نباید بلافاصله در کارت ویترین نوشت. ابتدا باید آنها را بررسی کرد، در کاتالوگ تأمینکننده ذخیره کرد و با قواعد داخلی نگاشت کرد. عیب کار فقط با کارت آماده این است که وارد کردن ممکن است نام مشتری، توضیحات یا دستهبندی انتخابشده دستی را بازنویسی کند.
ابتدا ساختار دستهبندیها را در پنل تعیین کنید
پیش از وارد کردن، تاکسونومی پنل را مشخص کنید. سطح بالا معمولاً پلتفرم را توصیف میکند، سطح بعدی اقدام: دنبالکننده، بازدید، واکنش، نظر، بیننده پخش زنده یا قالب دیگر. در داخل میتوان خدمات را بر اساس جغرافیا، نوع مخاطب، سرعت و شرایط جبران تقسیم کرد.
برای هر دستهبندی ویژگیهای الزامی تعیین کنید. برای بازدیدها میتواند نوع لینک و قالب محتوا باشد، برای دنبالکنندگان پلتفرم، جغرافیا و نوع مجاز پروفایل. عیب ساختار بیش از حد دقیق این است که نگهداری کاتالوگ دشوارتر میشود و خدمات نزدیک فقط با تفاوتهای داخلی از هم متمایز میشوند.
ارتباطات تأمینکننده و ویترین را جداگانه نگه دارید
اتصال بین خدمت تأمینکننده و کارت پنل باید در جدول یا موجودیت جداگانه ذخیره شود. در آن به تأمینکننده، شناسه خارجی، کارت داخلی، دستهبندی، قاعده قیمت، اولویت مسیر، وضعیت انتشار و تاریخ آخرین بررسی موفق نیاز است.
این طرح امکان میدهد تأمینکننده را بدون تغییر 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 یا دریافت صفحات در وضعیتهای مختلف کاتالوگ را افزایش میدهند.
در همگامسازی مجدد موارد تکراری ایجاد نکنید
برای یافتن خدمت موجود از کلید ترکیبی استفاده کنید: شناسه تأمینکننده و شناسه خارجی خدمت. در هر وارد کردن مجدد ابتدا رکورد را با این جفت جستجو کنید، سپس فیلدهای فنی را بهروزرسانی کنید. رکورد جدید را فقط در صورت نبود چنین کلیدی ایجاد کنید.
برای حذف تکراریها از نام، قیمت یا دستهبندی استفاده نکنید. دو خدمت مختلف میتوانند این مقادیر را داشته باشند و تأمینکننده ممکن است موقعیت را بدون تغییر شناسه خارجی تغییر نام دهد. برای ارتباطات با ویترین نیز کنترل یکتا لازم است: همان مسیر نباید پس از اجرای مجدد وظیفه دو بار ظاهر شود.
محدود کردن یکتایی در سطح پایگاه داده مفید است: 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 ژانویه قیمتهای پایه برای ابزار پیکربندی و مقرونبهصرفهت..
خدمات Twitch با ثبات کار ميکنيم ، پس آماده ايم با گروه ها و فروشنده ها همکاري کنيم, صاحبان خدمات ، صاحبان ربات ها و بسیاری دیگر.اصطلاحات فردی را م..
ما خدمات twitch viewer ما را به طور کامل به روز کرده اند و اکنون کار پایدار. ما فقط از آدرس های 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
خدمات ما برای تولیدکنندگان محتوا









