Support
Povezovanje ponudnikovih storitev s kategorijami SMM-panela prek API-ja

Kako povezati ponudnikove storitve s karticami SMM-panela prek API-ja

Zakaj ločiti ponudnikov katalog od izložbe panela

Ponudnikov API običajno vrne tehnični katalog: zunanji ID, ime, ceno, omejitve, status in parametre naročila. V SMM-panelu mora ista pozicija pristati v strukturi, ki je razumljiva stranki: platforma, vrsta promocije, geografija, oblika povezave, kakovost občinstva ali hitrost zagona.

Če zunanji katalog prikažete brez obdelave, se bodo na izložbi pojavila tehnična imena, dvojniki in nedosegljive pozicije. Preslikava ločuje nabavno logiko od kartice za stranke. Ena ponudnikova storitev ni nujno ločena storitev v panelu.

Katere podatke je treba pridobiti prek API-ja

Ponudnikove izvorne podatke hranite ločeno od nastavitev izložbe. Zunanjega ID-ja ne smete zamenjati z notranjim identifikatorjem panela: potreben je za ustvarjanje naročila, pridobivanje statusa, preklic in odpravljanje napak. Koristno je shraniti tudi čas zadnje sinhronizacije in celoten odgovor API-ja oziroma njegov posnetek.

  • Identifikator ponudnika in zunanji ID storitve.
  • Ime, opis in zunanjo kategorijo.
  • Nabavno ceno, valuto in obračunsko enoto.
  • Najmanjšo, največjo količino in korak količine.
  • Status razpoložljivosti, preostanek in oznako začasne ustavitve.
  • Zahteve glede povezave, prijave, objave, komentarja in geografije.
  • Oznake ročnega zagona, preklica, ponovnega zagona in delne izvedbe.

Pomanjkljivost samodejnega uvoza je, da ponudniki enaka polja poimenujejo različno in včasih posredujejo nepopolne podatke. Ime storitve ni primerno za stabilno povezavo: lahko ga spremenijo brez spremembe zunanjega ID-ja.

Primer zahteve in odgovora kataloga storitev

Oblika API-ja je odvisna od ponudnika, a logika je običajno enaka: panel posreduje dostopni ključ in parametre strani, v odgovoru pa prejme matriko storitev. Na primer, zahteva za katalog s kazalcem je lahko videti takole:

GET /api/services?cursor=eyJwYWdlIjoyfQ

Pogojni odgovor API-ja:

{ "services": [ { "id": "SP-1042", "name": "Global Followers", "platform": "twitch", "type": "followers", "price": "12.50", "min": 100, "max": 10000, "status": "active" } ], "next_cursor": "eyJwYWdlIjozfQ" }

Polj odgovora ne smete takoj zapisati v kartico izložbe. Najprej jih je treba preveriti, shraniti v ponudnikov katalog in preslikati na notranja pravila. Pomanjkljivost dela samo z že pripravljeno kartico je, da lahko uvoz prepiše ime za stranke, opis ali ročno izbrano kategorijo.

Najprej določite strukturo kategorij v panelu

Pred uvozom določite taksonomijo panela. Najvišja raven običajno opisuje platformo, naslednja dejanje: sledilci, ogledi, odzivi, komentarji, gledalci prenosa ali druga oblika. Znotraj lahko storitve razdelite po geografiji, vrsti občinstva, hitrosti in pogojih nadomestila.

Za vsako kategorijo določite obvezne značilnosti. Pri ogledih je to lahko vrsta povezave in oblika vsebine, pri sledilcih pa platforma, geografija in dovoljena vrsta profila. Pomanjkljivost preveč podrobne strukture je, da postane katalog težje vzdrževati, podobne storitve pa se začnejo razlikovati le po notranjih podrobnostih.

Povezave ponudnika in izložbe hranite ločeno

Povezava med ponudnikovo storitvijo in kartico panela mora biti shranjena v ločeni tabeli ali entiteti. V njej so potrebni ponudnik, zunanji ID, notranja kartica, kategorija, pravilo cene, prioriteta usmeritve, status objave in datum zadnjega uspešnega preverjanja.

Takšna shema omogoča zamenjavo ponudnika brez spremembe URL-ja kartice in brez izgube zgodovine naročil. Primer vrstice preslikave v JSON:

{ "supplier_id": "supplier_a", "external_service_id": "SP-1042", "panel_category": "twitch_followers", "showcase_card_id": "followers_global", "route_priority": 1, "status": "active" }

Схема связи ID услуги поставщика с категорией SMM-панели и карточкой витрины

Povezave so lahko različne, a za vsako vnaprej določite pravilo posodabljanja.

  • Ena ponudnikova storitev — ena kartica, če ima edinstvene parametre in obliko naročila.
  • Več storitev različnih ponudnikov — ena kartica, če so združljive glede zahtev in pogojev.
  • Ena ponudnikova storitev — več kartic, če jo izložba razdeli po jeziku, segmentu ali načinu prodaje.

Združevanje več ponudnikov v eno kartico ima pomanjkljivost: hitrost, razpoložljivost in dejanski pogoji izvedbe se lahko razlikujejo. Ne združujte usmeritev z različnimi oblikami povezave, omejitvami ali obveznimi polji.

Uvozite katalog po straneh

Ponudnik lahko katalog posreduje po straneh s številko, odmikom ali kazalcem. Prvi odgovor ne vsebuje nujno vseh storitev. Zahtevajte naslednjo stran, dokler API posreduje kazalec, povezavo za nadaljevanje ali drugo jasno oznako prisotnosti podatkov.

Pri paginaciji s kazalcem je obdelava takšna: panel prejme stran, shrani vse storitve, jih zabeleži kot najdene v trenutnem ciklu in šele nato preide na naslednji kazalec. Če polje next_cursor ni prisotno, se šteje, da je obhod zaključen.

  1. Ustvarite identifikator trenutnega cikla sinhronizacije.
  2. Zahtevajte prvo stran in shranite prejete storitve.
  3. Za vsako storitev posodobite polje last_seen_sync z identifikatorjem cikla.
  4. Shranite kazalec naslednje strani pred izvedbo naslednje zahteve.
  5. Po uspešnem obhodu vseh strani primerjajte katalog s trenutnim ciklom.

Pomanjkljivost zaporednega nalaganja strani je, da lahko popoln uvoz traja dlje. Vzporedne zahteve pospešijo postopek, a povečajo tveganje, da naletite na omejitev API-ja ali prejmete strani v različnem stanju kataloga.

Ne ustvarjajte dvojnikov pri ponovni sinhronizaciji

Za iskanje obstoječe storitve uporabite sestavljeni ključ: identifikator ponudnika in zunanji ID storitve. Pri vsakem ponovnem uvozu najprej poiščite zapis po tem paru, nato posodobite tehnična polja. Nov zapis ustvarite le, če takega ključa ni.

Za odstranjevanje dvojnikov ne uporabljajte imena, cene ali kategorije. Dve različni storitvi imata lahko enake te vrednosti, ponudnik pa lahko pozicijo preimenuje brez spremembe zunanjega ID-ja. Tudi za povezave z izložbo je potreben edinstven nadzor: ista usmeritev se po ponovnem zagonu opravila ne sme pojaviti dvakrat.

Koristno je omejiti edinstvenost na ravni baze podatkov: supplier_id + external_service_id za ponudnikov katalog in supplier_id + external_service_id + showcase_card_id za preslikavo. Pomanjkljivost toge omejitve je, da bo treba pri napaki v stari povezavi to izrecno popraviti, namesto da bi čeznjo ustvarili nov zapis.

Kako najti izbrisane in izginule storitve

Storitev se lahko šteje za izginulo šele po popolnoma uspešnem obhodu vseh strani. Če se je sinhronizacija ustavila zaradi napake, omejitve zahtev ali nedosegljivosti API-ja, pozicij, ki jih ni v že naloženem delu kataloga, ne smete označiti kot izbrisane.

Po zaključenem uvozu poiščite storitve tega ponudnika, pri katerih last_seen_sync ni enak identifikatorju trenutnega cikla. Dodelite jim status »ni najdena« ali »arhivirana«, onemogočite jih za nova naročila in jih pošljite v pregled. Zunanji ID, zgodovino sprememb in povezave z naročili ohranite.

Izginulo storitev je treba arhivirati, ne izbrisati. Ponudnik jo lahko pozneje vrne v katalog, spremeni filter odgovora ali pozicijo začasno skrije. Arhivirano povezavo je mogoče obnoviti pri naslednjem uvozu, če se isti zunanji ID znova pojavi.

Kaj storiti ob spremembi zunanjega ID-ja storitve

Če je ponudnik ustvaril novo storitev namesto stare, novega zunanjega ID-ja ne smete samodejno obravnavati kot nadaljevanje prejšnjega. Tudi pri enakem imenu in ceni se lahko pri poziciji spremenijo zahteve glede naročila, geografija, vrsta občinstva ali pogoji nadomestila.

Staro povezavo premaknite v arhiv, umaknite usmeritev iz prodaje in jo ohranite za stara naročila. Novo storitev uvozite kot ločen zapis. Nato ustvarite novo preslikavo ročno ali po varnem pravilu, če so tehnični parametri popolnoma združljivi.

Samodejno ujemanje po imenu lahko pospeši delo, a njegova pomanjkljivost je tveganje, da se naročilo pošlje na drugo storitev z neustreznimi pogoji. Za spremembo ID-ja je bolje uporabiti status »zahteva pregled« kot tiho zamenjavo usmeritve.

Nastavite preslikavo po stabilnih tehničnih poljih

Samodejno razvrščanje storitev je najbolje zgraditi na naboru polj: platforma, vrsta storitve, geografija, oblika povezave, najmanjša količina, dodatni parametri in status. Na primer, storitev lahko pristane v kategoriji ogledov po geo, če API posreduje združljive vrednosti platforme, vrste promocije in države.

Če ponudnik zahteva komentar, seznam profilov ali ročni zagon, usmeritve ne objavite v standardnem obrazcu naročila. Uporabite ločeno kartico z ustreznimi polji ali pustite storitev skrito do nadgradnje integracije.

Ime je dovoljeno uporabiti le kot dodatno značilnost. Pomanjkljivost takega pravila je, da lahko ponudnik spremeni formulacijo, doda okrajšavo ali uporabi drugačen zapis. Kritične usmeritve vežite na zunanji ID in preverljive parametre odgovora.

Ločite podatke API-ja in nastavitve kartice

Uvoz ne sme v celoti prepisati kartice izložbe. Nabavna cena, omejitve, razpoložljivost in tehnični parametri se običajno posodabljajo od ponudnika. Ime za stranke, opis, vidnost, vrstni red prikaza in pravila pribitka ostanejo notranje nastavitve panela.

Za vsako polje določite vir resnice. Na primer, najmanjša količina se vzame iz API-ja, ime za stranke iz panela, cena izložbe pa se izračuna po notranjem pravilu na podlagi nabavne vrednosti. Brez take ločitve lahko sinhronizacija izbriše ročno urejen opis ali spremeni kategorijo glede na zunanje ime.

Preverjajte spremembe cene in parametrov

Če je ponudnik spremenil ceno, preračunajte ceno izložbe po pravilu kartice in preverite valuto, provizije in dovoljeno maržo. Ob manjkajoči ceni, neznani valuti ali opazni spremembi pogojev je usmeritev bolje prenesti v status pregleda.

Ob spremembi najmanjše, največje količine ali koraka količine posodobite obrazec naročila. Če obrazec ne podpira novih omejitev, umaknite usmeritev iz prodaje. Sicer bo stranka oddala naročilo, ki ga bo ponudnik zavrnil po pošiljanju.

Če so se spremenili oblika povezave, obvezno polje, vrsta storitve ali način zagona, blokirajte nova naročila do ročnega pregleda. Pomanjkljivost strogega blokiranja je, da bo del kartic začasno izginil z izložbe, a to je varneje kot sprejemanje nezdružljivih naročil.

Obravnavajte napake API-ja in omejitve zahtev

Napaka ene zahteve ne sme samodejno onemogočiti celotnega kataloga. Ločujte napake avtorizacije, nepravilne zahteve, začasne nedosegljivosti in omejitve pogostosti zahtev. Za vsako skupino je potreben ločen scenarij.

  • Ob napaki avtorizacije ustavite nova naročila temu ponudniku in preverite dostop.
  • Ob napaki oblike zahteve shranite odgovor API-ja in popravite integracijo brez neskončnih ponovitev.
  • Ob začasni napaki ponovite zahtevo z naraščajočim premorom.
  • Ob omejitvi pogostosti shranite trenutni kazalec in opravilo preložite na ponovitev.

Storitev ne označite kot izginulo, dokler se odložena sinhronizacija ne zaključi uspešno. Pomanjkljivost agresivnih ponovitev je, da lahko hitreje izčrpate omejitev zahtev in pustite katalog zastarel dlje časa.

Ohranite usmeritve za aktivna naročila

Status storitve in status naročila sta različni entiteti. Storitev lahko izgine iz kataloga za nove stranke, a stara naročila zanjo se še vedno izvajajo. Arhiviranje kartice ali usmeritve ne sme ustaviti poizvedovanja o statusih že ustvarjenih naročil.

Za vsako naročilo shranite zunanji ID storitve, zunanji ID naročila, poslane parametre, nabavno vrednost ob zagonu in zgodovino statusov. Če ponudnik sporoči delno izvedbo, preklic ali napako, situacijo obravnavajte po pravilih panela: vračilo, nadomestilo, ponovni zagon ali ročni pregled.

Pomanjkljivost shranjevanja posnetka parametrov naročila je, da bo potrebnih več prostora in skrbna podatkovna shema. Brez takega posnetka ni mogoče ugotoviti, pod katerimi pogoji je bilo naročilo poslano, če je ponudnik pozneje spremenil storitev.

Testirajte preslikavo pred objavo kartic

Po nastavitvi preverite celotno pot: ustvarjanje naročila v panelu, izbiro usmeritve, pošiljanje ponudniku, shranjevanje zunanjega ID-ja, pridobivanje statusa, preklic in obravnavo delne izvedbe. Testirajte skupine storitev z različnimi omejitvami, povezavami in obveznimi polji.

Ločeno simulirajte ponovni uvoz, spremembo cene, izginotje storitve po uspešnem popolnem obhodu, napako na sredini paginacije in omejitev pogostosti zahtev. To bo pokazalo, ali panel arhivira delujoče usmeritve zaradi nepopolnega nalaganja kataloga.

Posebno pozornost namenite ročnim storitvam in pozicijam s komentarji. Njihova pomanjkljivost je, da standardni obrazec panela pogosto ne posreduje vseh podatkov, ki jih ponudnik pričakuje. Zanje je potrebna ločena predloga naročila ali skrit status do nadgradnje API-integracije.

Last Articles

Novi dizajn spletne strani

Kaj se je spremenilo pri dizajnu in funkcionalnosti Posodobili smo spletno stran, da bi z njo delali hitreje in bolj udobno. Glavne spremembe zadevaj..

15/08/2026 Novo

News SP

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..

08/04/2026 Posodobitev

Zhromaždili sme pre Vás všetky aktuálne akcie a žrebovania do 01.01.2026

1. Použite promo kód "December2025" na 15% zľavu pre všetkých našich divákov2. Znížili sme do 1. januára základné ceny nášho konfigurátora a najlacnej..

26/12/2025 Končano

Sodelovanje z oddelki in preprodajalci

Storitve trzanja so delo stabilno, zato smo pripravljeni sodelovati z oddelki, preprodajalci, lastniki storitev, lastniki botov in mnogi drugi.O p..

22/10/2025 Za partnerje

Gledalci trzanja so stabilni, vendar obstaja nekaj odtenkov.

Mi so popolnoma posodobili naše storitve pregledovalnika trzanja in zdaj so deluje stabilno. Za gledalce uporabljamo samo visokokakovostne naslove..

22/10/2025 Posodobitev

Twitch Viewer Configurator

Hello everyone! Today, we are announcing a new feature—"Twitch Viewer Configurator". Now, you can customize any plan for your Twitch channel. Choo..

15/06/2025 Novo

If YouTube is blocked, where to stream now?

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..

16/03/2022 Pomembno

API SP

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..

02/09/2021 Za partnerje

PARTNERJI IN REFERENCE: NOVI POGOJI!

Zaradi velike priljubljenosti partnerskih storitev in referenčnega programa smo izdelali tabelo sodelovanja. Bistvo je zelo preprosto: več občinstva v..

12/08/2020 Za partnerje

Nadzorna plošča gledalcev [Twitch | Kick | YouTube | VK Video Live]

Ustvari svoj lastni prilagojeni paket
Polnjenje stanja, naročilo z enim klikom, popusti in bonusi so na voljo samo registriranim uporabnikom. Registracija.
Če niste našli prave storitve ali ste jo našli ceneje, pišite naši podpori na Telegramu ali v klepet in rešili bomo vsako vprašanje.
Novo

Telegram bot @BOT_SP_RU_BOT

Naročilo ali ponovitev v minuti, stanje in statusi naročil — kar v Telegramu

Ponovi naročiloStanje naročilPolnjenje stanjaPromocijske kode