Hogyan kapcsoljuk össze a szolgáltatói szolgáltatásokat az SMM-panel kártyáival API-n keresztül
Miért érdemes különválasztani a szolgáltató katalógusát a panel kirakatától
A szolgáltató API-ja általában technikai katalógust ad vissza: külső ID, név, ár, limitek, állapot és rendelési paraméterek. Az SMM-panelben ugyanannak a tételnek az ügyfél számára érthető struktúrába kell kerülnie: platform, promóció típusa, földrajzi terület, linkformátum, közönségminőség vagy indítási sebesség.
Ha a külső katalógust feldolgozás nélkül jelenítjük meg, a kirakatban technikai elnevezések, duplikációk és elérhetetlen tételek jelennek meg. Az összerendelés szétválasztja a beszerzési logikát és az ügyfélkártyát. Egy szolgáltatói szolgáltatásnak nem kell külön szolgáltatásnak lennie a panelben.
Milyen adatokat kell lekérni az API-n keresztül
A szolgáltató eredeti adatait a kirakat beállításaitól elkülönítve tároljuk. A külső ID-t nem helyettesíthetjük a panel belső azonosítójával: szükség van rá a rendelés létrehozásához, az állapot lekéréséhez, a lemondáshoz és a hibák elemzéséhez. Hasznos továbbá tárolni az utolsó szinkronizálás idejét és a teljes API-választ vagy annak pillanatképét.
- A szolgáltató azonosítója és a szolgáltatás külső ID-ja.
- Név, leírás és külső kategória.
- Beszerzési ár, pénznem és elszámolási egység.
- Minimális, maximális mennyiség és mennyiségi lépésköz.
- Elérhetőségi állapot, egyenleg és ideiglenes leállítás jelzője.
- Linkre, bejelentkezésre, közzétételre, hozzászólásra és földrajzi területre vonatkozó követelmények.
- Kézi indítás, lemondás, utólagos indítás és részleges teljesítés jelzői.
Az automatikus import hátránya, hogy a szolgáltatók ugyanazokat a mezőket különbözőképpen nevezik meg, és néha hiányos adatokat adnak át. A szolgáltatás neve nem alkalmas stabil kapcsolatra: a külső ID megváltoztatása nélkül is módosíthatják.
Példa a szolgáltatáskatalógus kérésére és válaszára
Az API formátuma a szolgáltatótól függ, de a logika általában ugyanaz: a panel átadja a hozzáférési kulcsot és az oldal paramétereit, válaszként pedig szolgáltatások tömbjét kapja. Például egy kurzoros katalóguskérés így nézhet ki:
GET /api/services?cursor=eyJwYWdlIjoyfQ
Feltételes API-válasz:
{ "services": [ { "id": "SP-1042", "name": "Global Followers", "platform": "twitch", "type": "followers", "price": "12.50", "min": 100, "max": 10000, "status": "active" } ], "next_cursor": "eyJwYWdlIjozfQ" }
A válasz mezőit nem érdemes azonnal a kirakat kártyájába írni. Először ellenőrizni kell őket, el kell tárolni a szolgáltató katalógusában, és össze kell rendelni a belső szabályokkal. Ha csak a kész kártyával dolgozunk, annak hátránya, hogy az import felülírhatja az ügyfél nevét, leírását vagy a kézzel kiválasztott kategóriát.
Először határozzuk meg a kategóriastruktúrát a panelben
Az import előtt határozzuk meg a panel taxonómiáját. A felső szint általában a platformot írja le, a következő a műveletet: követők, megtekintések, reakciók, hozzászólások, streamnézők vagy más formátum. Belül a szolgáltatásokat földrajzi terület, közönségtípus, sebesség és kompenzációs feltételek szerint lehet felosztani.
Minden kategóriához határozzuk meg a kötelező jellemzőket. A megtekintéseknél ez lehet a link típusa és a tartalom formátuma, a követőknél a platform, a földrajzi terület és az engedélyezett profiltípus. A túl részletes struktúra hátránya, hogy a katalógust nehezebb karbantartani, és a hasonló szolgáltatások már csak belső árnyalatokban térnek el egymástól.
A szolgáltató és a kirakat kapcsolatát külön tároljuk
A szolgáltatói szolgáltatás és a panel kártyája közötti kapcsolatot külön táblában vagy entitásban kell tárolni. Ebben szükség van a szolgáltatóra, a külső ID-ra, a belső kártyára, a kategóriára, az árszabályra, az útvonal prioritására, a közzétételi állapotra és az utolsó sikeres ellenőrzés dátumára.
Ez a séma lehetővé teszi a szolgáltató cseréjét a kártya URL-jének megváltoztatása és a rendelési előzmények elvesztése nélkül. Példa egy összerendelési sorra JSON-ban:
{ "supplier_id": "supplier_a", "external_service_id": "SP-1042", "panel_category": "twitch_followers", "showcase_card_id": "followers_global", "route_priority": 1, "status": "active" }

A kapcsolatok különbözőek lehetnek, de mindegyikhez előre határozzuk meg a frissítési szabályt.
- Egy szolgáltatói szolgáltatás — egy kártya, ha egyedi paraméterekkel és rendelési formával rendelkezik.
- Több különböző szolgáltató szolgáltatása — egy kártya, ha a követelmények és feltételek szempontjából kompatibilisek.
- Egy szolgáltatói szolgáltatás — több kártya, ha a kirakat nyelv, szegmens vagy értékesítési mód szerint osztja fel.
Több szolgáltató egy kártyába való összevonásának hátránya, hogy a sebesség, az elérhetőség és a tényleges teljesítési feltételek eltérhetnek. Ne vonjunk össze olyan útvonalakat, amelyek linkformátuma, limitjei vagy kötelező mezői eltérnek.
Importáljuk a katalógust oldalanként
A szolgáltató az oldalakat szám, eltolás vagy kurzor szerint adhatja vissza. Az első válasz nem feltétlenül tartalmazza az összes szolgáltatást. Kérjük le a következő oldalt, amíg az API kurzort, folytatási linket vagy más egyértelmű adatlétezési jelzést ad át.
Kurzoros lapozás esetén a feldolgozás így néz ki: a panel megkapja az oldalt, eltárolja az összes szolgáltatást, rögzíti őket az aktuális ciklusban megtaláltként, és csak ezután lép a következő kurzorra. Ha a next_cursor mező hiányzik, a bejárás befejezettnek tekinthető.
- Hozzuk létre az aktuális szinkronizálási ciklus azonosítóját.
- Kérjük le az első oldalt, és tároljuk el a kapott szolgáltatásokat.
- Minden szolgáltatásnál frissítsük a last_seen_sync mezőt a ciklus azonosítójával.
- A következő kérés végrehajtása előtt mentsük el a következő oldal kurzorát.
- Az összes oldal sikeres bejárása után hasonlítsuk össze a katalógust az aktuális ciklussal.
Az oldalak egymás utáni betöltésének hátránya, hogy a teljes import tovább tarthat. A párhuzamos kérések felgyorsítják a folyamatot, de növelik annak kockázatát, hogy beleütközünk az API korlátjába, vagy a katalógus különböző állapotában kapjuk meg az oldalakat.
Ne hozzunk létre duplikációkat ismételt szinkronizáláskor
A meglévő szolgáltatás kereséséhez használjunk összetett kulcsot: a szolgáltató azonosítóját és a szolgáltatás külső ID-ját. Minden ismételt importnál először ezen pár alapján keressük a rekordot, majd frissítsük a technikai mezőket. Új rekordot csak akkor hozzunk létre, ha ilyen kulcs nem létezik.
A deduplikációhoz ne használjuk a nevet, az árat vagy a kategóriát. Két különböző szolgáltatásnál ezek az értékek megegyezhetnek, és a szolgáltató a külső ID megváltoztatása nélkül is átnevezheti a tételt. A kirakattal való kapcsolatokhoz szintén egyedi ellenőrzés szükséges: ugyanaz az útvonal ne jelenhessen meg kétszer a feladat ismételt futtatása után.
Hasznos az egyediséget adatbázis szinten korlátozni: supplier_id + external_service_id a szolgáltató katalógusához, és supplier_id + external_service_id + showcase_card_id az összerendeléshez. A szigorú korlátozás hátránya, hogy egy régi kapcsolat hibája esetén azt kifejezetten javítani kell, nem pedig új rekordot létrehozni fölé.
Hogyan találjuk meg a törölt és eltűnt szolgáltatásokat
Egy szolgáltatás csak az összes oldal teljesen sikeres bejárása után tekinthető eltűntnek. Ha a szinkronizálás hiba, kérési limit vagy az API elérhetetlensége miatt leállt, a már betöltött katalógusrészben hiányzó tételeket nem lehet töröltként megjelölni.
A befejezett import után keressük meg azokat a szolgáltatásokat, amelyeknél a last_seen_sync nem egyezik az aktuális ciklus azonosítójával. Ezek „nem található” vagy „archivált” állapotot kapnak, kikapcsolják őket az új rendelésekből, és ellenőrzésre küldik. A külső ID-t, a változási előzményeket és a rendelésekkel való kapcsolatokat megőrizzük.
Az eltűnt szolgáltatást archiválni kell, nem törölni. A szolgáltató később visszaadhatja a katalógusba, módosíthatja a válasz szűrőjét, vagy ideiglenesen elrejtheti a tételt. Az archivált kapcsolat a következő importnál visszaállítható, ha ugyanaz a külső ID újra megjelenik.
Mit tegyünk a szolgáltatás külső ID-jának megváltozásakor
Ha a szolgáltató a régi helyett új szolgáltatást hozott létre, az új külső ID nem tekinthető automatikusan a korábbi folytatásának. Még azonos név és ár esetén is megváltozhatnak a tétel rendelési követelményei, földrajzi területe, közönségtípusa vagy kompenzációs feltételei.
A régi kapcsolatot állítsuk archivált állapotba, vonjuk ki az útvonalat az értékesítésből, és őrizzük meg a régi rendelésekhez. Az új szolgáltatást külön rekordként importáljuk. Ezután hozzunk létre új összerendelést kézzel vagy biztonságos szabály szerint, ha a technikai paraméterek teljesen kompatibilisek.
A név szerinti automatikus összerendelés felgyorsíthatja a munkát, de hátránya, hogy fennáll a veszélye annak, hogy a rendelést egy másik, nem megfelelő feltételekkel rendelkező szolgáltatáshoz küldjük. Az ID megváltozásakor jobb „ellenőrzést igényel” állapotot használni, mintsem csendben lecserélni az útvonalat.
Az összerendelést stabil technikai mezők alapján állítsuk be
Az automatikus szolgáltatáselosztást jobb mezőkészlet alapján felépíteni: platform, szolgáltatástípus, földrajzi terület, linkformátum, minimális mennyiség, további paraméterek és állapot. Például egy szolgáltatás földrajzi terület szerinti megtekintéskategóriába kerülhet, ha az API kompatibilis platform-, promóciótípus- és országértékeket ad át.
Ha a szolgáltató hozzászólást, profilok listáját vagy kézi indítást igényel, ne tegyük közzé az útvonalat a szabványos rendelési formában. Használjunk külön kártyát a szükséges mezőkkel, vagy tartsuk a szolgáltatást rejtve az integráció kidolgozásáig.
A nevet csak kiegészítő jellemzőként szabad használni. Az ilyen szabály hátránya, hogy a szolgáltató megváltoztathatja a megfogalmazást, rövidítést adhat hozzá, vagy más írásmódot használhat. A kritikus útvonalakat a külső ID-hoz és az ellenőrizhető válaszparaméterekhez kössük.
Válasszuk szét az API-adatokat és a kártya beállításait
Az importnak nem szabad teljesen felülírnia a kirakat kártyáját. A beszerzési árat, a limiteket, az elérhetőséget és a technikai paramétereket általában a szolgáltatótól frissítjük. Az ügyfélnek szóló név, a leírás, a láthatóság, a megjelenítési sorrend és a felárszabályok a panel belső beállításai maradnak.
Minden mezőhöz rendeljük hozzá az igazság forrását. Például a minimális mennyiség az API-ból származik, az ügyfél neve a panelből, a kirakat ára pedig a beszerzési költség alapján belső szabály szerint számítódik. Ilyen szétválasztás nélkül a szinkronizálás törölheti a kézzel szerkesztett leírást, vagy a külső név alapján megváltoztathatja a kategóriát.
Ellenőrizzük az ár és a paraméterek változásait
Ha a szolgáltató megváltoztatta az árat, számítsuk újra a kirakat árát a kártya szabálya szerint, és ellenőrizzük a pénznemet, a jutalékokat és a megengedett árrést. Hiányzó ár, ismeretlen pénznem vagy a feltételek jelentős változása esetén az útvonalat jobb ellenőrzési állapotba tenni.
A minimum, a maximum vagy a mennyiségi lépésköz változásakor frissítsük a rendelési formát. Ha a forma nem támogatja az új korlátozásokat, vonjuk ki az útvonalat az értékesítésből. Ellenkező esetben az ügyfél olyan rendelést ad le, amelyet a szolgáltató a beküldés után elutasít.
Ha megváltozott a linkformátum, a kötelező mező, a szolgáltatástípus vagy az indítás módja, blokkoljuk az új rendeléseket a kézi ellenőrzésig. A szigorú blokkolás hátránya, hogy a kártyák egy része ideiglenesen eltűnik a kirakatból, de ez biztonságosabb, mint az inkompatibilis rendelések elfogadása.
Kezeljük az API-hibákat és a kérési korlátokat
Egyetlen kérés hibája nem kapcsolhatja ki automatikusan a teljes katalógust. Különítsük el az engedélyezési, a helytelen kérési, az ideiglenes elérhetetlenségi és a kérési gyakorisági korlát hibákat. Minden csoporthoz külön forgatókönyv szükséges.
- Engedélyezési hiba esetén állítsuk le az új rendeléseket ennél a szolgáltatónál, és ellenőrizzük a hozzáférést.
- Kérésformátum-hiba esetén mentsük el az API-választ, és javítsuk az integrációt végtelen ismétlés nélkül.
- Ideiglenes hiba esetén ismételjük meg a kérést növekvő szünettel.
- Gyakorisági korlát esetén mentsük el az aktuális kurzort, és ütemezzük újra a feladatot.
Ne jelöljük a szolgáltatásokat eltűntként, amíg a halasztott szinkronizálás sikeresen be nem fejeződik. Az agresszív ismétlések hátránya, hogy hamarabb kimeríthetjük a kérési limitet, és hosszabb ideig elavult marad a katalógus.
Őrizzük meg az útvonalakat az aktív rendelésekhez
A szolgáltatás állapota és a rendelés állapota különböző entitások. A szolgáltatás eltűnhet a katalógusból az új ügyfelek számára, de a régi rendelések még teljesülhetnek rajta. A kártya vagy az útvonal archiválása nem állíthatja le a már létrehozott rendelések állapotának lekérdezését.
Minden rendelésnél őrizzük meg a szolgáltatás külső ID-ját, a rendelés külső ID-ját, a beküldött paramétereket, az indításkori beszerzési költséget és az állapotelőzményeket. Ha a szolgáltató részleges teljesítésről, lemondásról vagy hibáról számol be, a panel szabályai szerint kezeljük a helyzetet: visszatérítés, kompenzáció, utólagos indítás vagy kézi ellenőrzés.
A rendelési paraméterek pillanatképének tárolása hátránya, hogy több helyre és gondos adatsémára lesz szükség. Ilyen pillanatkép nélkül nem állapítható meg, milyen feltételekkel küldték be a rendelést, ha a szolgáltató később megváltoztatta a szolgáltatást.
A kártyák közzététele előtt teszteljük az összerendelést
A beállítás után ellenőrizzük a teljes folyamatot: rendelés létrehozása a panelben, útvonal kiválasztása, beküldés a szolgáltatónak, külső ID mentése, állapot lekérése, lemondás és a részleges teljesítés kezelése. Teszteljük a különböző limitekkel, linkekkel és kötelező mezőkkel rendelkező szolgáltatáscsoportokat.
Külön modellezzük az ismételt importot, az árváltozást, a szolgáltatás eltűnését a sikeres teljes bejárás után, a lapozás közbeni hibát és a kérési gyakorisági korlátot. Ez megmutatja, hogy a panel nem archiválja-e a működő útvonalakat a katalógus hiányos betöltése miatt.
Különös figyelmet szenteljünk a kézi szolgáltatásoknak és a hozzászólásos tételeknek. Hátrányuk, hogy a panel szabványos formája gyakran nem adja át az összes adatot, amelyet a szolgáltató elvár. Számukra külön rendelési sablon vagy rejtett állapot szükséges az API-integráció kidolgozásáig.
Last Articles
Mi változott a dizájnban és a funkciókban Frissítettük a weboldalt, hogy gyorsabb és kényelmesebb legyen vele dolgozni. A fő változások a felületet, ..
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. Használja a "December2025" promóciós kódot 15% kedvezményért minden nézőnk számára2. Január 1-jéig 25%-kal csökkentettük konfigurátorunk és a legol..
A Twitch szolgáltatások stabilan működik, így készek vagyunk együttműködni a csapatokkal, viszonteladókkal, szolgáltatás tulajdonosok, bot tulajdo..
Mi teljesen frissítettük a Twitch viewer szolgáltatásainkat, és most már stabilan működik. Csak kiváló minőségű IP-címeket használunk a nézők szám..
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..
A partnerségi szolgáltatások és ajánlóprogram óriási népszerűsége miatt kooperációs táblázatot készítettünk. A lényeg nagyon egyszerű: több élő közöns..
Szolgáltatásaink Streamelőknek

Shopee
Szolgáltatásaink Tartalomkészítőknek









