Cum să asociezi serviciile furnizorului cu cardurile panoului SMM prin API
De ce să separi catalogul furnizorului de vitrina panoului
API-ul furnizorului returnează de obicei un catalog tehnic: ID extern, denumire, preț, limite, status și parametri de comandă. În panoul SMM, aceeași poziție trebuie să ajungă într-o structură clară pentru client: platformă, tip de promovare, geografie, formatul linkului, calitatea audienței sau viteza de lansare.
Dacă afișezi catalogul extern fără procesare, în vitrină vor apărea denumiri tehnice, duplicate și poziții indisponibile. Maparea separă logica de achiziție de cardul pentru client. Un serviciu al furnizorului nu trebuie neapărat să fie un serviciu separat în panou.
Ce date trebuie obținute prin API
Păstrează datele sursă ale furnizorului separat de setările vitrinei. ID-ul extern nu poate fi înlocuit cu identificatorul intern al panoului: este necesar pentru crearea comenzii, obținerea statusului, anulare și analiza erorilor. Este util să stochezi și momentul ultimei sincronizări și răspunsul complet al API-ului sau o copie a acestuia.
- Identificatorul furnizorului și ID-ul extern al serviciului.
- Denumirea, descrierea și categoria externă.
- Prețul de achiziție, moneda și unitatea de calcul.
- Volumul minim, maxim și pasul cantității.
- Statusul disponibilității, stocul și indicatorul de oprire temporară.
- Cerințele privind linkul, loginul, publicarea, comentariul și geografia.
- Indicatori de lansare manuală, anulare, relansare și execuție parțială.
Dezavantajul importului automat este că furnizorii denumesc diferit aceleași câmpuri și uneori transmit date incomplete. Denumirea serviciului nu este potrivită pentru o legătură stabilă: poate fi modificată fără schimbarea ID-ului extern.
Exemplu de cerere și răspuns al catalogului de servicii
Formatul API depinde de furnizor, dar logica este de obicei aceeași: panoul transmite cheia de acces și parametrii paginii, iar în răspuns primește un array de servicii. De exemplu, o cerere a catalogului cu cursor poate arăta astfel:
GET /api/services?cursor=eyJwYWdlIjoyfQ
Răspuns API condiționat:
{ "services": [ { "id": "SP-1042", "name": "Global Followers", "platform": "twitch", "type": "followers", "price": "12.50", "min": 100, "max": 10000, "status": "active" } ], "next_cursor": "eyJwYWdlIjozfQ" }
Câmpurile răspunsului nu trebuie scrise imediat în cardul vitrinei. Mai întâi trebuie verificate, salvate în catalogul furnizorului și mapate cu regulile interne. Dezavantajul lucrului doar cu un card gata făcut este că importul poate suprascrie denumirea pentru client, descrierea sau categoria selectată manual.
Mai întâi definește structura categoriilor în panou
Înainte de import, definește taxonomia panoului. Nivelul superior descrie de obicei platforma, următorul — acțiunea: abonați, vizualizări, reacții, comentarii, spectatori ai transmisiunii sau alt format. În interior, serviciile pot fi împărțite după geografie, tipul audienței, viteză și condițiile de compensare.
Pentru fiecare categorie stabilește caracteristicile obligatorii. La vizualizări, acestea pot fi tipul linkului și formatul conținutului, la abonați — platforma, geografia și tipul de profil permis. Dezavantajul unei structuri prea detaliate este că catalogul devine mai greu de întreținut, iar serviciile apropiate încep să difere doar prin nuanțe interne.
Stochează separat legăturile dintre furnizor și vitrină
Legătura dintre serviciul furnizorului și cardul panoului trebuie stocată într-un tabel sau o entitate separată. În ea sunt necesare furnizorul, ID-ul extern, cardul intern, categoria, regula de preț, prioritatea rutei, statusul publicării și data ultimei verificări reușite.
Această schemă permite înlocuirea furnizorului fără schimbarea URL-ului cardului și fără pierderea istoricului comenzilor. Exemplu de rând de mapare în JSON:
{ "supplier_id": "supplier_a", "external_service_id": "SP-1042", "panel_category": "twitch_followers", "showcase_card_id": "followers_global", "route_priority": 1, "status": "active" }

Legăturile pot fi diferite, dar pentru fiecare stabilește dinainte regula de actualizare.
- Un serviciu al furnizorului — un card, dacă are parametri unici și o formă de comandă unică.
- Mai multe servicii ale diferiților furnizori — un card, dacă sunt compatibile prin cerințe și condiții.
- Un serviciu al furnizorului — mai multe carduri, dacă vitrina îl împarte după limbă, segment sau modalitate de vânzare.
Combinarea mai multor furnizori într-un singur card are un dezavantaj: viteza, disponibilitatea și condițiile efective de execuție pot diferi. Nu combina rute cu formate de link, limite sau câmpuri obligatorii diferite.
Importă catalogul pagină cu pagină
Furnizorul poate returna catalogul în pagini prin număr, offset sau cursor. Primul răspuns nu conține neapărat toate serviciile. Solicită pagina următoare cât timp API-ul transmite un cursor, un link de continuare sau un alt indicator clar al existenței datelor.
La paginarea cu cursor, procesarea arată astfel: panoul primește pagina, salvează toate serviciile, le marchează ca găsite în ciclul curent și abia apoi trece la cursorul următor. Dacă câmpul next_cursor lipsește, parcurgerea este considerată încheiată.
- Creează un identificator pentru ciclul curent de sincronizare.
- Solicită prima pagină și salvează serviciile primite.
- Pentru fiecare serviciu actualizează câmpul last_seen_sync cu identificatorul ciclului.
- Salvează cursorul paginii următoare înainte de a executa următoarea cerere.
- După parcurgerea cu succes a tuturor paginilor, compară catalogul cu ciclul curent.
Dezavantajul încărcării secvențiale a paginilor este că importul complet poate dura mai mult. Cererile paralele accelerează procesul, dar cresc riscul de a atinge limita API-ului sau de a primi pagini în stări diferite ale catalogului.
Nu crea duplicate la resincronizare
Pentru a găsi un serviciu existent, folosește o cheie compusă: identificatorul furnizorului și ID-ul extern al serviciului. La fiecare reimport, caută mai întâi înregistrarea după această pereche, apoi actualizează câmpurile tehnice. Creează o înregistrare nouă doar în absența acestei chei.
Nu folosi denumirea, prețul sau categoria pentru deduplicare. Două servicii diferite pot avea aceste valori identice, iar furnizorul poate redenumi poziția fără a schimba ID-ul extern. Pentru legăturile cu vitrina este necesar și un control unic: aceeași rută nu trebuie să apară de două ori după relansarea sarcinii.
Este util să limitezi unicitatea la nivelul bazei de date: supplier_id + external_service_id pentru catalogul furnizorului și supplier_id + external_service_id + showcase_card_id pentru mapare. Dezavantajul unei constrângeri rigide este că, în cazul unei erori într-o legătură veche, aceasta va trebui corectată explicit, nu prin crearea unei înregistrări noi peste ea.
Cum să găsești serviciile șterse și dispărute
Un serviciu poate fi considerat dispărut doar după parcurgerea completă și reușită a tuturor paginilor. Dacă sincronizarea s-a oprit la o eroare, o limită de cereri sau indisponibilitatea API-ului, pozițiile absente din partea deja încărcată a catalogului nu pot fi marcate ca șterse.
După importul finalizat, găsește serviciile acestui furnizor la care last_seen_sync nu este egal cu identificatorul ciclului curent. Li se atribuie statusul „negăsit” sau „arhivat”, sunt dezactivate pentru comenzi noi și trimise la verificare. ID-ul extern, istoricul modificărilor și legăturile cu comenzile se păstrează.
Un serviciu dispărut trebuie arhivat, nu șters. Furnizorul îl poate readuce în catalog mai târziu, poate modifica filtrul răspunsului sau ascunde temporar poziția. Legătura arhivată poate fi restaurată la următorul import, dacă același ID extern apare din nou.
Ce să faci la schimbarea ID-ului extern al serviciului
Dacă furnizorul a creat un serviciu nou în locul celui vechi, noul ID extern nu poate fi considerat automat o continuare a celui anterior. Chiar și cu denumire și preț identice, cerințele de comandă, geografia, tipul audienței sau condițiile de compensare ale poziției se pot schimba.
Mută legătura veche în arhivă, retrage ruta din vânzare și păstreaz-o pentru comenzile vechi. Importă serviciul nou ca înregistrare separată. Apoi creează o mapare nouă manual sau după o regulă sigură, dacă parametrii tehnici sunt complet compatibili.
Maparea automată după denumire poate accelera lucrul, dar dezavantajul ei este riscul de a trimite comanda către un alt serviciu cu condiții nepotrivite. Pentru schimbarea ID-ului este mai bine să folosești statusul „necesită verificare”, nu înlocuirea silențioasă a rutei.
Configurează maparea după câmpuri tehnice stabile
Distribuirea automată a serviciilor se construiește mai bine pe un set de câmpuri: platformă, tip de serviciu, geografie, formatul linkului, volumul minim, parametri suplimentari și status. De exemplu, un serviciu poate intra în categoria vizualizărilor pe geo, dacă API-ul transmite valori compatibile ale platformei, tipului de promovare și țării.
Dacă furnizorul cere un comentariu, o listă de profiluri sau lansare manuală, nu publica ruta în forma standard de comandă. Folosește un card separat cu câmpurile necesare sau lasă serviciul ascuns până la finalizarea integrării.
Denumirea poate fi folosită doar ca indicator suplimentar. Dezavantajul acestei reguli este că furnizorul poate modifica formularea, adăuga o abreviere sau folosi o altă ortografie. Leagă rutele critice de ID-ul extern și de parametrii verificabili ai răspunsului.
Separă datele API de setările cardului
Importul nu trebuie să suprascrie complet cardul vitrinei. Prețul de achiziție, limitele, disponibilitatea și parametrii tehnici se actualizează de obicei de la furnizor. Denumirea pentru client, descrierea, vizibilitatea, ordinea de afișare și regulile de adaos rămân setări interne ale panoului.
Pentru fiecare câmp desemnează sursa de adevăr. De exemplu, volumul minim este preluat din API, denumirea pentru client — din panou, iar prețul vitrinei este calculat după o regulă internă pe baza costului de achiziție. Fără această separare, sincronizarea poate șterge o descriere editată manual sau poate schimba categoria după denumirea externă.
Verifică modificările de preț și parametri
Dacă furnizorul a modificat prețul, recalculează prețul vitrinei după regula cardului și verifică moneda, comisioanele și marja admisibilă. În cazul unui preț lipsă, al unei monede necunoscute sau al unei modificări notabile a condițiilor, este mai bine să treci ruta în statusul de verificare.
La modificarea minimului, maximului sau pasului cantității, actualizează forma de comandă. Dacă forma nu suportă noile restricții, retrage ruta din vânzare. Altfel, clientul va plasa o comandă pe care furnizorul o va respinge după trimitere.
Dacă s-au modificat formatul linkului, câmpul obligatoriu, tipul serviciului sau modalitatea de lansare, blochează comenzile noi până la verificarea manuală. Dezavantajul blocării stricte este că o parte din carduri va dispărea temporar din vitrină, dar este mai sigur decât să accepți comenzi incompatibile.
Gestionează erorile API și limitele de cereri
O eroare a unei singure cereri nu trebuie să dezactiveze automat întregul catalog. Separă erorile de autorizare, cerere incorectă, indisponibilitate temporară și limitare a frecvenței cererilor. Pentru fiecare grup este necesar un scenariu separat.
- La eroare de autorizare, oprește comenzile noi către acest furnizor și verifică accesul.
- La eroare de format al cererii, salvează răspunsul API și corectează integrarea fără reîncercări infinite.
- La eroare temporară, repetă cererea cu o pauză crescătoare.
- La limitarea frecvenței, salvează cursorul curent și reprogramează sarcina.
Nu marca serviciile ca dispărute până când sincronizarea amânată nu se încheie cu succes. Dezavantajul reîncercărilor agresive este că poți epuiza mai repede limita de cereri și lăsa catalogul învechit pentru o perioadă mai lungă.
Păstrează rutele pentru comenzile active
Statusul serviciului și statusul comenzii sunt entități diferite. Serviciul poate dispărea din catalog pentru clienții noi, dar comenzile vechi pentru el încă se execută. Arhivarea cardului sau a rutei nu trebuie să oprească interogarea statusurilor comenzilor deja create.
Pentru fiecare comandă păstrează ID-ul extern al serviciului, ID-ul extern al comenzii, parametrii trimiși, costul de achiziție la momentul lansării și istoricul statusurilor. Dacă furnizorul raportează execuție parțială, anulare sau eroare, gestionează situația conform regulilor panoului: rambursare, compensare, relansare sau verificare manuală.
Dezavantajul stocării unei copii a parametrilor comenzii este că va fi nevoie de mai mult spațiu și de o schemă de date atentă. Fără o astfel de copie nu se poate stabili în ce condiții a fost trimisă comanda, dacă furnizorul a modificat ulterior serviciul.
Testează maparea înainte de publicarea cardurilor
După configurare verifică întregul parcurs: crearea comenzii în panou, selectarea rutei, trimiterea către furnizor, salvarea ID-ului extern, obținerea statusului, anularea și gestionarea execuției parțiale. Testează grupuri de servicii cu limite, linkuri și câmpuri obligatorii diferite.
Simulează separat reimportul, modificarea prețului, dispariția unui serviciu după o parcurgere completă reușită, o eroare la mijlocul paginării și limitarea frecvenței cererilor. Astfel vei vedea dacă panoul arhivează rute active din cauza unei încărcări incomplete a catalogului.
Acordă o atenție deosebită serviciilor manuale și pozițiilor cu comentarii. Dezavantajul lor este că forma standard a panoului nu transmite adesea toate datele pe care le așteaptă furnizorul. Pentru ele este nevoie de un șablon de comandă separat sau de un status ascuns până la finalizarea integrării API.
Last Articles
Ce s-a schimbat în design și funcționalitate Am actualizat site-ul pentru a lucra cu el mai rapid și mai comod. Principalele modificări vizează inter..
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. Folosiți codul promoțional "December2025" pentru o reducere de 15% pentru toți spectatorii noștri2. Am redus până la 1 ianuarie prețurile de bază p..
Serviciile Twitch sunt lucrând stabil, așa că suntem gata să cooperăm cu Echipe, revânzători, proprietari de servicii, proprietari de bot și mulți..
Noi au actualizat complet serviciile noastre Twitch viewer și acum sunt lucrează stabil. Folosim doar adrese IP de înaltă calitate pentru spectato..
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..
Datorită popularității uriașe a serviciilor de parteneriat și programului de recomandare, am realizat o masă de cooperare. Esența este foarte simplă: ..
Serviciile noastre pentru streameri

Shopee
Serviciile noastre pentru creatorii de conținut









