Support
Koppeling van leveranciersdiensten aan SMM-panelcategorieën via API

Hoe je leveranciersdiensten koppelt aan SMM-panelkaarten via API

Waarom je de leverancierscatalogus loskoppelt van de etalage van het panel

De API van een leverancier retourneert meestal een technische catalogus: externe ID, naam, prijs, limieten, status en orderparameters. In het SMM-panel moet dezelfde positie in een voor de klant begrijpelijke structuur terechtkomen: platform, type promotie, geografie, linkformaat, kwaliteit van het publiek of snelheid van starten.

Als je de externe catalogus ongefilterd toont, verschijnen er technische namen, duplicaten en niet-beschikbare posities in de etalage. Mapping scheidt de inkooplogica van de klantkaart. Eén leveranciersdienst hoeft geen aparte dienst in het panel te zijn.

Welke gegevens je via de API moet ophalen

Bewaar de brongegevens van de leverancier apart van de instellingen van de etalage. De externe ID mag je niet vervangen door een interne identificator van het panel: die is nodig voor het aanmaken van een order, het ophalen van de status, annulering en foutanalyse. Het is ook handig om het tijdstip van de laatste synchronisatie en het volledige API-antwoord of een snapshot daarvan op te slaan.

  • Leveranciersidentificator en externe ID van de dienst.
  • Naam, beschrijving en externe categorie.
  • Inkoopprijs, valuta en rekeneenheid.
  • Minimaal en maximaal volume en stapgrootte van de hoeveelheid.
  • Beschikbaarheidsstatus, restvoorraad en signaal van tijdelijke stopzetting.
  • Vereisten voor link, login, publicatie, reactie en geografie.
  • Kenmerken voor handmatige start, annulering, herstart en gedeeltelijke uitvoering.

Het nadeel van automatische import is dat leveranciers dezelfde velden verschillend benoemen en soms onvolledige gegevens doorgeven. De naam van de dienst is niet geschikt voor een stabiele koppeling: die kan worden gewijzigd zonder dat de externe ID verandert.

Voorbeeld van een request en response van de dienstencatalogus

Het API-formaat hangt af van de leverancier, maar de logica is meestal hetzelfde: het panel stuurt een toegangssleutel en paginaparameters mee en ontvangt in het antwoord een array van diensten. Een catalogusverzoek met cursor kan er bijvoorbeeld zo uitzien:

GET /api/services?cursor=eyJwYWdlIjoyfQ

Voorbeeld van een API-antwoord:

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

Je moet de antwoordvelden niet meteen in de etalagekaart schrijven. Eerst moet je ze controleren, opslaan in de leverancierscatalogus en koppelen aan interne regels. Het nadeel van alleen met een kant-en-klare kaart werken is dat de import de klantnaam, beschrijving of handmatig gekozen categorie kan overschrijven.

Stel eerst de categorisestructuur in het panel in

Bepaal vóór de import de taxonomie van het panel. Het hoogste niveau beschrijft meestal het platform, het volgende de actie: volgers, weergaven, reacties, reacties, kijkers van een stream of een ander formaat. Binnenin kun je diensten indelen naar geografie, type publiek, snelheid en compensatievoorwaarden.

Stel voor elke categorie verplichte kenmerken in. Bij weergaven kan dat het type link en het formaat van de content zijn, bij volgers het platform, de geografie en het toegestane profieltype. Het nadeel van een te gedetailleerde structuur is dat de catalogus moeilijker te onderhouden wordt en dat vergelijkbare diensten alleen nog in interne details van elkaar verschillen.

Bewaar de koppelingen tussen leverancier en etalage apart

De koppeling tussen een leveranciersdienst en een panelkaart moet in een aparte tabel of entiteit worden opgeslagen. Daarin zijn de leverancier, externe ID, interne kaart, categorie, prijsregel, routeprioriteit, publicatiestatus en datum van de laatste geslaagde controle nodig.

Met dit schema kun je een leverancier vervangen zonder de URL van de kaart te wijzigen en zonder de orderhistorie te verliezen. Voorbeeld van een mappingregel in JSON:

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

Schema van de koppeling tussen de ID van een leveranciersdienst, de SMM-panelcategorie en de etalagekaart

Koppelingen kunnen verschillend zijn, maar bepaal voor elke koppeling vooraf de updateregel.

  • Eén leveranciersdienst — één kaart, als die unieke parameters en een unieke ordervorm heeft.
  • Meerdere diensten van verschillende leveranciers — één kaart, als ze qua vereisten en voorwaarden compatibel zijn.
  • Eén leveranciersdienst — meerdere kaarten, als de etalage die opsplitst naar taal, segment of verkoopmethode.

Het samenvoegen van meerdere leveranciers in één kaart heeft een nadeel: snelheid, beschikbaarheid en feitelijke uitvoeringsvoorwaarden kunnen verschillen. Voeg geen routes samen met verschillende linkformaten, limieten of verplichte velden.

Importeer de catalogus pagina voor pagina

Een leverancier kan de catalogus paginagewijs aanleveren via een nummer, offset of cursor. Het eerste antwoord bevat niet per se alle diensten. Vraag de volgende pagina op zolang de API een cursor, een vervolglink of een ander expliciet signaal doorgeeft dat er gegevens zijn.

Bij cursor-paginering ziet de verwerking er zo uit: het panel haalt een pagina op, slaat alle diensten op, markeert ze als gevonden in de huidige cyclus en gaat pas daarna naar de volgende cursor. Als het veld next_cursor ontbreekt, is de doorloop voltooid.

  1. Maak een identificator voor de huidige synchronisatiecyclus aan.
  2. Vraag de eerste pagina op en sla de ontvangen diensten op.
  3. Werk voor elke dienst het veld last_seen_sync bij met de identificator van de cyclus.
  4. Sla de cursor van de volgende pagina op voordat je het volgende verzoek uitvoert.
  5. Vergelijk na een geslaagde doorloop van alle pagina's de catalogus met de huidige cyclus.

Het nadeel van sequentieel pagina's laden is dat een volledige import langer kan duren. Parallelle verzoeken versnellen het proces, maar verhogen het risico dat je tegen de API-limiet aanloopt of pagina's in een verschillende catalogusstatus ontvangt.

Voorkom duplicaten bij herhaalde synchronisatie

Gebruik voor het vinden van een bestaande dienst een samengestelde sleutel: de leveranciersidentificator en de externe ID van de dienst. Zoek bij elke herhaalde import eerst de record op basis van dit paar en werk daarna de technische velden bij. Maak een nieuwe record alleen aan als deze sleutel ontbreekt.

Gebruik voor deduplicatie niet de naam, prijs of categorie. Twee verschillende diensten kunnen dezelfde waarden hebben, en de leverancier kan een positie hernoemen zonder de externe ID te wijzigen. Voor koppelingen met de etalage is ook unieke controle nodig: dezelfde route mag na een herhaalde uitvoering van de taak niet twee keer verschijnen.

Het is handig om uniciteit op databaseniveau te beperken: supplier_id + external_service_id voor de leverancierscatalogus en supplier_id + external_service_id + showcase_card_id voor de mapping. Het nadeel van een harde beperking is dat je een fout in een oude koppeling expliciet moet corrigeren in plaats van een nieuwe record eroverheen te maken.

Hoe je verwijderde en verdwenen diensten vindt

Een dienst mag pas als verdwenen worden beschouwd na een volledig geslaagde doorloop van alle pagina's. Als de synchronisatie stopt door een fout, een limiet op verzoeken of de onbeschikbaarheid van de API, mogen posities die ontbreken in het al geladen deel van de catalogus niet als verwijderd worden gemarkeerd.

Zoek na een voltooide import de diensten van deze leverancier waarbij last_seen_sync niet gelijk is aan de identificator van de huidige cyclus. Geef ze de status 'niet gevonden' of 'gearchiveerd', sluit ze uit van nieuwe orders en stuur ze naar controle. De externe ID, de wijzigingshistorie en de koppelingen met orders blijven bewaard.

Een verdwenen dienst moet je archiveren, niet verwijderen. De leverancier kan die later terugzetten in de catalogus, het antwoordfilter wijzigen of de positie tijdelijk verbergen. Een gearchiveerde koppeling kan bij de volgende import worden hersteld als dezelfde externe ID weer verschijnt.

Wat je doet bij een wijziging van de externe ID van een dienst

Als de leverancier een nieuwe dienst heeft aangemaakt in plaats van de oude, mag de nieuwe externe ID niet automatisch als voortzetting van de vorige worden beschouwd. Zelfs bij dezelfde naam en prijs kunnen de ordervereisten, geografie, het type publiek of de compensatievoorwaarden van de positie zijn gewijzigd.

Zet de oude koppeling op gearchiveerd, haal de route uit de verkoop en bewaar die voor oude orders. Importeer de nieuwe dienst als een aparte record. Maak daarna een nieuwe mapping aan, handmatig of volgens een veilige regel als de technische parameters volledig compatibel zijn.

Automatische koppeling op naam kan het werk versnellen, maar het nadeel is het risico dat een order naar een andere dienst met ongeschikte voorwaarden wordt gestuurd. Gebruik voor een ID-wijziging liever de status 'vereist controle' dan een stille vervanging van de route.

Stel mapping in op basis van stabiele technische velden

Automatische toewijzing van diensten kun je het beste bouwen op een set velden: platform, type dienst, geografie, linkformaat, minimaal volume, aanvullende parameters en status. Een dienst kan bijvoorbeeld in de categorie weergaven per geo terechtkomen als de API compatibele waarden doorgeeft voor platform, type promotie en land.

Als de leverancier een reactie, een lijst met profielen of een handmatige start vereist, publiceer de route dan niet in het standaardorderformulier. Gebruik een aparte kaart met de benodigde velden of laat de dienst verborgen tot de integratie is aangepast.

De naam mag je alleen als aanvullend kenmerk gebruiken. Het nadeel van zo'n regel is dat de leverancier de formulering kan wijzigen, een afkorting kan toevoegen of een andere spelling kan gebruiken. Koppel kritieke routes aan de externe ID en aan controleerbare antwoordparameters.

Scheid de API-gegevens van de kaartinstellingen

De import mag de etalagekaart niet volledig overschrijven. Inkoopprijs, limieten, beschikbaarheid en technische parameters worden meestal bijgewerkt vanuit de leverancier. De naam voor de klant, beschrijving, zichtbaarheid, weergavevolgorde en opslagregels blijven interne instellingen van het panel.

Wijs voor elk veld de bron van waarheid aan. Het minimale volume komt bijvoorbeeld uit de API, de klantnaam uit het panel en de etalageprijs wordt berekend volgens een interne regel op basis van de inkoopkosten. Zonder deze scheiding kan de synchronisatie een handmatig bewerkte beschrijving wissen of de categorie wijzigen op basis van de externe naam.

Controleer wijzigingen in prijs en parameters

Als de leverancier de prijs heeft gewijzigd, herbereken dan de etalageprijs volgens de regel van de kaart en controleer valuta, commissies en toegestane marge. Bij een ontbrekende prijs, onbekende valuta of een opvallende wijziging van de voorwaarden kun je de route beter op controle zetten.

Werk het orderformulier bij wanneer het minimum, maximum of de stapgrootte van de hoeveelheid verandert. Als het formulier de nieuwe beperkingen niet ondersteunt, haal de route dan uit de verkoop. Anders plaatst de klant een order die de leverancier na verzending afwijst.

Als het linkformaat, een verplicht veld, het type dienst of de startmethode is gewijzigd, blokkeer dan nieuwe orders tot de handmatige controle. Het nadeel van een strikte blokkering is dat een deel van de kaarten tijdelijk uit de etalage verdwijnt, maar dat is veiliger dan incompatibele orders accepteren.

Ga om met API-fouten en limieten op verzoeken

Een fout in één verzoek mag niet automatisch de hele catalogus uitschakelen. Maak onderscheid tussen autorisatiefouten, ongeldige verzoeken, tijdelijke onbeschikbaarheid en limieten op de verzoekfrequentie. Voor elke groep is een apart scenario nodig.

  • Stop bij een autorisatiefout nieuwe orders voor deze leverancier en controleer de toegang.
  • Bewaar bij een fout in het verzoekformaat het API-antwoord en herstel de integratie zonder eindeloze herhalingen.
  • Herhaal het verzoek bij een tijdelijke fout met een oplopende pauze.
  • Bewaar bij een frequentielimiet de huidige cursor en plan de taak opnieuw in.

Markeer diensten niet als verdwenen voordat de uitgestelde synchronisatie succesvol is afgerond. Het nadeel van agressieve herhalingen is dat je de limiet op verzoeken sneller bereikt en de catalogus langer verouderd blijft.

Bewaar routes voor actieve orders

De status van een dienst en de status van een order zijn verschillende entiteiten. Een dienst kan uit de catalogus voor nieuwe klanten verdwijnen, terwijl oude orders ervoor nog steeds worden uitgevoerd. Het archiveren van een kaart of route mag het opvragen van statussen van al aangemaakte orders niet stoppen.

Bewaar voor elke order de externe ID van de dienst, de externe ID van de order, de verzonden parameters, de inkoopkosten op het moment van starten en de statushistorie. Als de leverancier een gedeeltelijke uitvoering, annulering of fout meldt, verwerk de situatie dan volgens de regels van het panel: terugbetaling, compensatie, herstart of handmatige controle.

Het nadeel van het opslaan van een snapshot van de orderparameters is dat er meer ruimte nodig is en een zorgvuldig dat schema. Zonder zo'n snapshot is het onmogelijk vast te stellen onder welke voorwaarden een order is verzonden als de leverancier de dienst later heeft gewijzigd.

Test de mapping voordat je kaarten publiceert

Controleer na de configuratie het volledige pad: een order aanmaken in het panel, de route kiezen, naar de leverancier sturen, de externe ID opslaan, de status ophalen, annuleren en gedeeltelijke uitvoering verwerken. Test groepen diensten met verschillende limieten, links en verplichte velden.

Simuleer apart een herhaalde import, een prijswijziging, het verdwijnen van een dienst na een geslaagde volledige doorloop, een fout halverwege de paginering en een limiet op de verzoekfrequentie. Zo zie je of het panel werkende routes archiveert door een onvolledige cataloguslading.

Besteed extra aandacht aan handmatige diensten en posities met reacties. Hun nadeel is dat het standaardformulier van het panel vaak niet alle gegevens doorgeeft die de leverancier verwacht. Daarvoor is een apart ordersjabloon nodig of een verborgen status tot de API-integratie is aangepast.

Last Articles

Nieuw website-ontwerp

Wat is er veranderd in ontwerp en functionaliteit We hebben de website vernieuwd om er sneller en gemakkelijker mee te werken. De belangrijkste wijzi..

15-08-2026 Nieuw

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 Update

We hebben voor u alle lopende acties en wedstrijden verzameld tot 01.01.2026

1. Gebruik promotiecode "December2025" voor 15% korting voor al onze kijkers2. We hebben tot 1 januari de basisprijzen voor onze configurator en de go..

26-12-2025 Afgelopen

Samenwerking met squads en resellers

Twitch diensten zijn stabiel werken, dus we zijn klaar om samen te werken met squads, resellers, service-eigenaren, bot-eigenaren en vele anderen...

22-10-2025 Voor partners

Twitch-kijkers zijn stabiel, maar er zijn enkele nuances.

We hebben onze Twitch viewer-services volledig bijgewerkt en ze zijn nu stabiel werken. We gebruiken alleen hoogwaardige IP-adressen voor de kijke..

22-10-2025 Update

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 Nieuw

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 Belangrijk

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 Voor partners

PARTNERS EN VERWIJZINGEN: NIEUWE VOORWAARDEN!

Vanwege de enorme populariteit van de partnerschapsdiensten en het verwijzingsprogramma hebben we een samenwerkingstabel gemaakt. De essentie is heel ..

12-08-2020 Voor partners

Kijkersbeheerpaneel [Twitch | Kick | YouTube | VK Video Live]

Stel je eigen persoonlijke tarief samen
Saldo opwaarderen, bestellen met één klik, kortingen en bonussen zijn alleen beschikbaar voor geregistreerde gebruikers. Registreren.
Heb je de juiste dienst niet gevonden of ergens goedkoper gezien? Schrijf naar onze support op Telegram of de chat, dan lossen we het op.
Nieuw

Telegram-bot @BOT_SP_RU_BOT

Bestel of herhaal in een minuut, saldo en bestelstatussen — rechtstreeks in Telegram

Bestelling herhalenBestelstatussenSaldo opwaarderenPromocodes