Provayder xidmətlərini API vasitəsilə SMM panel kartları ilə necə əlaqələndirmək olar
Provayder kataloqunu panel vitrinindən niyə ayırmaq lazımdır
Provayderin API-si adətən texniki kataloq qaytarır: xarici ID, ad, qiymət, limitlər, status və sifariş parametrləri. SMM panelində həmin mövqe müştəri üçün anlaşılan struktura düşməlidir: platforma, təşviq növü, coğrafiya, link formatı, auditoriya keyfiyyəti və ya başlama sürəti.
Xarici kataloqu emal etmədən çıxarsanız, vitrində texniki adlar, dublikatlar və əlçatmaz mövqelər görünəcək. Uyğunlaşdırma satınalma məntiqi ilə müştəri kartını ayırır. Provayderin bir xidməti paneldə ayrıca xidmət olmaq məcburiyyətində deyil.
API vasitəsilə hansı məlumatları almaq lazımdır
Provayderin ilkin məlumatlarını vitrin ayarlarından ayrı saxlayın. Xarici ID-ni panelin daxili identifikatoru ilə əvəz etmək olmaz: o, sifariş yaratmaq, status almaq, ləğv etmək və xətaları araşdırmaq üçün lazımdır. Son sinxronizasiya vaxtını və tam API cavabını və ya onun snapshotunu saxlamaq da faydalıdır.
- Provayderin identifikatoru və xidmətin xarici ID-si.
- Ad, təsvir və xarici kateqoriya.
- Satınalma qiyməti, valyuta və hesablama vahidi.
- Minimum, maksimum həcm və miqdar addımı.
- Əlçatanlıq statusu, qalıq və müvəqqəti dayandırma əlaməti.
- Link, login, publikasiya, şərh və coğrafiyaya dair tələblər.
- Əl ilə başlatma, ləğv, yenidən başlatma və qismən icra əlamətləri.
Avtomatik idxalın çatışmazlığı ondadır ki, provayderlər eyni sahələri fərqli adlandırır və bəzən natamam məlumat ötürür. Xidmətin adı dayanıqlı əlaqə üçün uyğun deyil: onu xarici ID dəyişmədən dəyişə bilərlər.
Xidmətlər kataloqu üçün sorğu və cavab nümunəsi
API formatı provayderdən asılıdır, amma məntiq adətən eynidir: panel giriş açarını və səhifə parametrlərini ötürür, cavabda isə xidmətlər massivi alır. Məsələn, kursorla kataloq sorğusu belə görünə bilər:
GET /api/services?cursor=eyJwYWdlIjoyfQ
Şərti API cavabı:
{ "services": [ { "id": "SP-1042", "name": "Global Followers", "platform": "twitch", "type": "followers", "price": "12.50", "min": 100, "max": 10000, "status": "active" } ], "next_cursor": "eyJwYWdlIjozfQ" }
Cavab sahələrini dərhal vitrin kartına yazmaq lazım deyil. Əvvəlcə onları yoxlamaq, provayder kataloqunda saxlamaq və daxili qaydalarla uyğunlaşdırmaq lazımdır. Yalnız hazır kartla işləməyin çatışmazlığı ondadır ki, idxal müştəri adını, təsviri və ya əl ilə seçilmiş kateqoriyanı üzərinə yaza bilər.
Əvvəlcə paneldə kateqoriya strukturunu müəyyənləşdirin
İdxaldan əvvəl panelin taksonomiyasını müəyyən edin. Yuxarı səviyyə adətən platformanı təsvir edir, növbəti səviyyə hərəkəti: abunəçilər, baxışlar, reaksiyalar, şərhlər, yayım izləyiciləri və ya digər format. Daxildə xidmətləri coğrafiya, auditoriya növü, sürət və kompensasiya şərtlərinə görə bölmək olar.
Hər kateqoriya üçün məcburi əlamətləri müəyyən edin. Baxışlarda bu, link növü və məzmun formatı ola bilər, abunəçilərdə isə platforma, coğrafiya və icazə verilən profil növü. Həddindən artıq detallı strukturun çatışmazlığı ondadır ki, kataloqu saxlamaq çətinləşir və yaxın xidmətlər yalnız daxili nüanslarla fərqlənməyə başlayır.
Provayder və vitrin əlaqələrini ayrı saxlayın
Provayder xidməti ilə panel kartı arasındakı əlaqə ayrı cədvəldə və ya obyektdə saxlanmalıdır. Orada provayder, xarici ID, daxili kart, kateqoriya, qiymət qaydası, marşrut prioriteti, publikasiya statusu və son uğurlu yoxlama tarixi lazımdır.
Belə sxem kartın URL-ni dəyişmədən və sifariş tarixçəsini itirmədən provayderi əvəz etməyə imkan verir. JSON-da mapinq sətri nümunəsi:
{ "supplier_id": "supplier_a", "external_service_id": "SP-1042", "panel_category": "twitch_followers", "showcase_card_id": "followers_global", "route_priority": 1, "status": "active" }

Əlaqələr fərqli ola bilər, amma hər biri üçün yeniləmə qaydasını əvvəlcədən müəyyən edin.
- Bir provayder xidməti — bir kart, əgər onun unikal parametrləri və sifariş forması varsa.
- Fərqli provayderlərin bir neçə xidməti — bir kart, əgər tələblər və şərtlər baxımından uyğundursa.
- Bir provayder xidməti — bir neçə kart, əgər vitrin onu dil, seqment və ya satış üsuluna görə ayırırsa.
Bir neçə provayderin bir kartda birləşdirilməsinin çatışmazlığı ondadır ki, sürət, əlçatanlıq və faktiki icra şərtləri fərqli ola bilər. Link formatı, limitləri və ya məcburi sahələri fərqli olan marşrutları birləşdirməyin.
Kataloqu səhifə-səhifə idxal edin
Provayder kataloqu nömrə, ofset və ya kursor vasitəsilə səhifələrlə qaytara bilər. Birinci cavab mütləq bütün xidmətləri ehtiva etmir. API kursor, davam linki və ya məlumatın mövcudluğuna dair digər aydın əlamət ötürdükcə növbəti səhifəni sorğulayın.
Kursor səhifələməsində emal belə görünür: panel səhifəni alır, bütün xidmətləri saxlayır, onları cari dövrədə tapılmış kimi qeyd edir və yalnız bundan sonra növbəti kursora keçir. next_cursor sahəsi yoxdursa, gəzinti tamamlanmış sayılır.
- Cari sinxronizasiya dövrəsinin identifikatorunu yaradın.
- Birinci səhifəni sorğulayın və alınan xidmətləri saxlayın.
- Hər xidmət üçün last_seen_sync sahəsini dövrə identifikatoru ilə yeniləyin.
- Növbəti sorğunu icra etməzdən əvvəl növbəti səhifənin kursorunu saxlayın.
- Bütün səhifələrin uğurlu gəzintisindən sonra kataloqu cari dövrə ilə müqayisə edin.
Səhifələrin ardıcıl yüklənməsinin çatışmazlığı ondadır ki, tam idxal daha uzun çəkə bilər. Paralel sorğular prosesi sürətləndirir, amma API limitinə ilişmək və ya səhifələri kataloqun fərqli vəziyyətində almaq riskini artırır.
Təkrar sinxronizasiyada dublikat yaratmayın
Mövcud xidməti tapmaq üçün mürəkkəb açardan istifadə edin: provayderin identifikatoru və xidmətin xarici ID-si. Hər təkrar idxalda əvvəlcə bu cütlüklə yazını axtarın, sonra texniki sahələri yeniləyin. Yeni yazını yalnız belə açar olmadıqda yaradın.
De-duplikasiya üçün ad, qiymət və ya kateqoriyadan istifadə etməyin. İki fərqli xidmətdə bu dəyərlər üst-üstə düşə bilər, provayder isə xarici ID-ni dəyişmədən mövqeyi yenidən adlandıra bilər. Vitrinlə əlaqələr üçün də unikal nəzarət lazımdır: eyni marşrut tapşırıq təkrar işə salındıqdan sonra iki dəfə görünməməlidir.
Unikallığı verilənlər bazası səviyyəsində məhdudlaşdırmaq faydalıdır: provayder kataloqu üçün supplier_id + external_service_id və mapinq üçün supplier_id + external_service_id + showcase_card_id. Sərt məhdudiyyətin çatışmazlığı ondadır ki, köhnə əlaqədə xəta olduqda onu üzərinə yeni yazı yaratmadan açıq şəkildə düzəltmək lazım gələcək.
Silinmiş və itkin xidmətləri necə tapmaq olar
Xidməti yalnız bütün səhifələrin tam uğurlu gəzintisindən sonra itkin hesab etmək olar. Əgər sinxronizasiya xəta, sorğu limiti və ya API əlçatmazlığı səbəbindən dayanıbsa, kataloqun artıq yüklənmiş hissəsində olmayan mövqeləri silinmiş kimi qeyd etmək olmaz.
Tamamlanmış idxaldan sonra bu provayderin last_seen_sync cari dövrənin identifikatoruna bərabər olmayan xidmətlərini tapın. Onlara «tapılmadı» və ya «arxivləşdirildi» statusu verilir, yeni sifarişlərdən ayrılır və yoxlamaya göndərilir. Xarici ID, dəyişiklik tarixçəsi və sifarişlərlə əlaqələr saxlanılır.
İtkin düşmüş xidməti silmək deyil, arxivləşdirmək lazımdır. Provayder onu sonra kataloqa qaytara, cavab filtrini dəyişə və ya mövqeyi müvəqqəti gizlədə bilər. Arxiv əlaqəsi növbəti idxalda, eyni xarici ID yenidən göründükdə bərpa oluna bilər.
Xidmətin xarici ID-si dəyişdikdə nə etmək lazımdır
Əgər provayder köhnənin yerinə yeni xidmət yaradıbsa, yeni xarici ID-ni avtomatik olaraq əvvəlkinin davamı hesab etmək olmaz. Eyni ad və qiymət olsa belə, mövqenin sifariş tələbləri, coğrafiyası, auditoriya növü və ya kompensasiya şərtləri dəyişə bilər.
Köhnə əlaqəni arxivə keçirin, marşrutu satışdan çıxarın və köhnə sifarişlər üçün saxlayın. Yeni xidməti ayrı yazı kimi idxal edin. Sonra əl ilə və ya texniki parametrlər tam uyğundursa, təhlükəsiz qayda ilə yeni mapinq yaradın.
Adla avtomatik uyğunlaşdırma işi sürətləndirə bilər, amma onun çatışmazlığı sifarişi uyğun olmayan şərtlərə malik başqa xidmətə göndərmək riskidir. ID dəyişikliyi üçün marşrutu səssizcə əvəz etmək əvəzinə «yoxlama tələb edir» statusundan istifadə etmək daha yaxşıdır.
Mapinqi dayanıqlı texniki sahələr üzrə qurun
Xidmətlərin avtomatik bölüşdürülməsini sahələr dəsti üzrə qurmaq daha yaxşıdır: platforma, xidmət növü, coğrafiya, link formatı, minimum həcm, əlavə parametrlər və status. Məsələn, xidmət coğrafiya üzrə baxışlar kateqoriyasına düşə bilər, əgər API platforma, təşviq növü və ölkə üzrə uyğun dəyərlər ötürürsə.
Əgər provayder şərh, profil siyahısı və ya əl ilə başlatma tələb edirsə, marşrutu standart sifariş formasında dərc etməyin. Lazımi sahələri olan ayrıca kartdan istifadə edin və ya inteqrasiya tamamlanana qədər xidməti gizli saxlayın.
Adı yalnız əlavə əlamət kimi istifadə etmək olar. Belə qaydanın çatışmazlığı ondadır ki, provayder ifadəni dəyişə, ixtisar əlavə edə və ya başqa yazılışdan istifadə edə bilər. Kritik marşrutları xarici ID-yə və cavabın yoxlanıla bilən parametrlərinə bağlayın.
API məlumatlarını və kart ayarlarını ayırın
İdxal vitrin kartının üzərinə tam yazmamalıdır. Satınalma qiyməti, limitlər, əlçatanlıq və texniki parametrlər adətən provayderdən yenilənir. Müştəri üçün ad, təsvir, görünürlük, göstərmə sırası və əlavə dəyər qaydaları panelin daxili ayarları olaraq qalır.
Hər sahə üçün həqiqət mənbəyini təyin edin. Məsələn, minimum həcm API-dən götürülür, müştəri adı paneldən götürülür, vitrin qiyməti isə satınalma dəyəri əsasında daxili qayda ilə hesablanır. Belə ayırma olmadan sinxronizasiya əl ilə redaktə edilmiş təsviri silə və ya xarici ada görə kateqoriyanı dəyişə bilər.
Qiymət və parametr dəyişikliklərini yoxlayın
Əgər provayder qiyməti dəyişibsə, vitrin qiymətini kartın qaydası ilə yenidən hesablayın və valyutanı, komissiyaları və icazə verilən marjanı yoxlayın. Qiymət yoxdursa, valyuta bilinmirsə və ya şərtlər nəzərəçarpan dərəcədə dəyişibsə, marşrutu yoxlama statusuna keçirmək daha yaxşıdır.
Minimum, maksimum və ya miqdar addımı dəyişdikdə sifariş formasını yeniləyin. Əgər forma yeni məhdudiyyətləri dəstəkləmirə, marşrutu satışdan çıxarın. Əks halda müştəri provayderin göndərişdən sonra rədd edəcəyi sifarişi rəsmiləşdirəcək.
Əgər link formatı, məcburi sahə, xidmət növü və ya başlatma üsulu dəyişibsə, əl ilə yoxlamaya qədər yeni sifarişləri bloklayın. Sərt bloklamanın çatışmazlığı ondadır ki, kartların bir hissəsi müvəqqəti olaraq vitrindən itəcək, amma bu, uyğun olmayan sifarişləri qəbul etməkdən daha təhlükəsizdir.
API xətalarını və sorğu məhdudiyyətlərini emal edin
Bir sorğunun xətası bütün kataloqu avtomatik söndürməməlidir. Avtorizasiya, səhv sorğu, müvəqqəti əlçatmazlıq və sorğu tezliyi məhdudiyyəti xətalarını ayırın. Hər qrup üçün ayrıca ssenari lazımdır.
- Avtorizasiya xətası olduqda bu provayderə yeni sifarişləri dayandırın və girişi yoxlayın.
- Sorğu formatı xətası olduqda API cavabını saxlayın və sonsuz təkrarlar olmadan inteqrasiyanı düzəldin.
- Müvəqqəti xəta olduqda sorğunu artan fasilə ilə təkrarlayın.
- Tezlik məhdudiyyəti olduqda cari kursoru saxlayın və tapşırığı təkrara keçirin.
Təxirə salınmış sinxronizasiya uğurla tamamlanana qədər xidmətləri itkin kimi qeyd etməyin. Aqressiv təkrarların çatışmazlığı ondadır ki, sorğu limitini daha tez tükəndirib kataloqu daha uzun müddət köhnəlmiş vəziyyətdə saxlamaq olar.
Aktiv sifarişlər üçün marşrutları saxlayın
Xidmətin statusu və sifarişin statusu fərqli obyektlərdir. Xidmət yeni müştərilər üçün kataloqdan itə bilər, amma onun üzrə köhnə sifarişlər hələ də icra olunur. Kartın və ya marşrutun arxivləşdirilməsi artıq yaradılmış sifarişlərin statuslarının sorğulanmasını dayandırmamalıdır.
Hər sifariş üçün xidmətin xarici ID-sini, sifarişin xarici ID-sini, göndərilmiş parametrləri, başlama anındakı satınalma dəyərini və status tarixçəsini saxlayın. Əgər provayder qismən icra, ləğv və ya xəta barədə məlumat verirsə, vəziyyəti panelin qaydaları ilə emal edin: geri qaytarma, kompensasiya, yenidən başlatma və ya əl ilə yoxlama.
Sifariş parametrlərinin snapshotunun saxlanmasının çatışmazlığı ondadır ki, daha çox yer və səliqəli məlumat sxemi tələb olunacaq. Belə snapshot olmadan provayder sonradan xidməti dəyişdikdə sifarişin hansı şərtlərlə göndərildiyini müəyyən etmək mümkün deyil.
Mapinqi kartların dərcindən əvvəl test edin
Qurulumdan sonra tam yolu yoxlayın: paneldə sifarişin yaradılması, marşrutun seçilməsi, provayderə göndəriş, xarici ID-nin saxlanması, statusun alınması, ləğv və qismən icranın emalı. Fərqli limitləri, linkləri və məcburi sahələri olan xidmət qruplarını test edin.
Ayrıca təkrar idxalı, qiymət dəyişikliyini, uğurlu tam gəzintidən sonra xidmətin itməsini, səhifələmənin ortasında xətanı və sorğu tezliyi məhdudiyyətini modelləşdirin. Bu, panelin natamam kataloq yükləməsi səbəbindən işlək marşrutları arxivləşdirib-arxivləşdirmədiyini göstərəcək.
Əl ilə idarə olunan xidmətlərə və şərhləri olan mövqelərə xüsusi diqqət yetirin. Onların çatışmazlığı ondadır ki, panelin standart forması çox vaxt provayderin gözlədiyi bütün məlumatları ötürmür. Onlar üçün ayrıca sifariş şablonu və ya API inteqrasiyası tamamlanana qədər gizli status lazımdır.
Last Articles
Dizayn və funksionallıqda nə dəyişdi Saytı yenilədik ki, onunla işləmək daha sürətli və rahat olsun. Əsas dəyişikliklər interfeys, şəxsi kabinet və s..
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. Bütün izləyicilərimiz üçün 15% endirim üçün "December2025" promosyon kodundan istifadə edin2. 1 yanvaradək konfiquratorumuzun və ən ucuz izləyici k..
Seğirme Xidmətləri sabit işləyirlər, buna görə komandalarla, satıcılarla əməkdaşlıq etməyə hazırıq, xidmət sahibləri, botlar və daha çox.Fərdi şərtl..
Biz seğirme baxış xidmətlərimizi tamamilə yenilədik və indi onlar sabit işləyirlər. Baxmaq üçün yalnız keyfiyyətli IP ünvanlarından istifadə edirik...
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..
Tərəfdaşlıq xidmətləri və yönləndirmə proqramının böyük populyarlığına görə biz əməkdaşlıq masası hazırlamışıq. Mahiyyət çox sadədir: daha çox canlı a..
Strimmerlər üçün Xidmətlərimiz
Kontent yaradıcıları üçün Xidmətlərimiz










