Support
Zuordnung von Anbieterleistungen zu SMM-Panel-Kategorien über die API

Wie man Anbieterleistungen über die API mit SMM-Panel-Karten verknüpft

Warum der Anbieterkatalog vom Schaufenster des Panels getrennt werden sollte

Die API des Anbieters liefert in der Regel einen technischen Katalog: externe ID, Name, Preis, Limits, Status und Bestellparameter. Im SMM-Panel muss dieselbe Position in eine für den Kunden verständliche Struktur eingeordnet werden: Plattform, Art der Promotion, Geografie, Linkformat, Zielgruppenqualität oder Startgeschwindigkeit.

Wenn man den externen Katalog ohne Aufbereitung ausgibt, erscheinen im Schaufenster technische Bezeichnungen, Duplikate und nicht verfügbare Positionen. Das Mapping trennt die Einkaufslogik von der Kundenkarte. Eine Anbieterleistung muss nicht zwingend eine eigene Leistung im Panel sein.

Welche Daten über die API abgerufen werden müssen

Speichern Sie die Ausgangsdaten des Anbieters getrennt von den Einstellungen des Schaufensters. Die externe ID darf nicht durch eine interne Kennung des Panels ersetzt werden: Sie wird für die Bestellerstellung, den Statusabruf, die Stornierung und die Fehleranalyse benötigt. Es ist außerdem sinnvoll, den Zeitpunkt der letzten Synchronisierung und die vollständige API-Antwort oder einen Snapshot davon zu speichern.

  • Anbieterkennung und externe ID der Leistung.
  • Name, Beschreibung und externe Kategorie.
  • Einkaufspreis, Währung und Berechnungseinheit.
  • Minimales und maximales Volumen sowie Mengenschritt.
  • Verfügbarkeitsstatus, Restbestand und Kennzeichen für vorübergehende Aussetzung.
  • Anforderungen an Link, Login, Veröffentlichung, Kommentar und Geografie.
  • Kennzeichen für manuellen Start, Stornierung, Nachstart und Teilausführung.

Der Nachteil des automatischen Imports besteht darin, dass Anbieter gleiche Felder unterschiedlich benennen und manchmal unvollständige Daten übermitteln. Der Name der Leistung eignet sich nicht für eine stabile Verknüpfung: Er kann ohne Änderung der externen ID geändert werden.

Beispiel für Anfrage und Antwort des Leistungskatalogs

Das API-Format hängt vom Anbieter ab, die Logik ist jedoch meist gleich: Das Panel übergibt den Zugriffsschlüssel und die Seitenparameter und erhält als Antwort ein Array von Leistungen. Eine Kataloganfrage mit Cursor kann beispielsweise so aussehen:

GET /api/services?cursor=eyJwYWdlIjoyfQ

Beispielhafte API-Antwort:

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

Die Antwortfelder sollten nicht direkt in die Schaufensterkarte geschrieben werden. Zuerst müssen sie geprüft, im Anbieterkatalog gespeichert und mit den internen Regeln abgeglichen werden. Der Nachteil der Arbeit nur mit der fertigen Karte besteht darin, dass der Import den Kundennamen, die Beschreibung oder die manuell gewählte Kategorie überschreiben kann.

Zuerst die Kategoriestruktur im Panel festlegen

Definieren Sie vor dem Import die Taxonomie des Panels. Die oberste Ebene beschreibt in der Regel die Plattform, die nächste die Aktion: Abonnenten, Aufrufe, Reaktionen, Kommentare, Zuschauer im Stream oder ein anderes Format. Innerhalb dieser Ebenen lassen sich Leistungen nach Geografie, Zielgruppentyp, Geschwindigkeit und Ausgleichsbedingungen unterteilen.

Legen Sie für jede Kategorie Pflichtmerkmale fest. Bei Aufrufen kann das der Linktyp und das Inhaltsformat sein, bei Abonnenten die Plattform, die Geografie und der zulässige Profiltyp. Der Nachteil einer zu detaillierten Struktur besteht darin, dass der Katalog schwerer zu pflegen ist und sich ähnliche Leistungen nur noch durch interne Nuancen unterscheiden.

Verknüpfungen zwischen Anbieter und Schaufenster getrennt speichern

Die Verknüpfung zwischen einer Anbieterleistung und einer Panel-Karte sollte in einer separaten Tabelle oder Entität gespeichert werden. Darin werden Anbieter, externe ID, interne Karte, Kategorie, Preisregel, Routing-Priorität, Veröffentlichungsstatus und Datum der letzten erfolgreichen Prüfung benötigt.

Dieses Schema ermöglicht es, den Anbieter auszutauschen, ohne die URL der Karte zu ändern und ohne die Bestellhistorie zu verlieren. Beispiel einer Mapping-Zeile 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 der Verknüpfung der Anbieterleistungs-ID mit der SMM-Panel-Kategorie und der Schaufensterkarte

Die Verknüpfungen können unterschiedlich sein, aber legen Sie für jede im Voraus eine Aktualisierungsregel fest.

  • Eine Anbieterleistung — eine Karte, wenn sie eindeutige Parameter und ein eindeutiges Bestellformular hat.
  • Mehrere Leistungen verschiedener Anbieter — eine Karte, wenn sie hinsichtlich Anforderungen und Bedingungen kompatibel sind.
  • Eine Anbieterleistung — mehrere Karten, wenn das Schaufenster sie nach Sprache, Segment oder Verkaufsart aufteilt.

Die Zusammenführung mehrerer Anbieter in einer Karte hat einen Nachteil: Geschwindigkeit, Verfügbarkeit und tatsächliche Ausführungsbedingungen können sich unterscheiden. Fassen Sie keine Routen mit unterschiedlichen Linkformaten, Limits oder Pflichtfeldern zusammen.

Katalog seitenweise importieren

Der Anbieter kann den Katalog seitenweise über Nummer, Offset oder Cursor ausgeben. Die erste Antwort enthält nicht zwingend alle Leistungen. Fordern Sie die nächste Seite an, solange die API einen Cursor, einen Weiter-Link oder ein anderes eindeutiges Signal für weitere Daten liefert.

Bei der Cursor-Paginierung sieht die Verarbeitung so aus: Das Panel erhält eine Seite, speichert alle Leistungen, markiert sie als im aktuellen Zyklus gefunden und geht erst dann zum nächsten Cursor über. Fehlt das Feld next_cursor, gilt der Durchlauf als abgeschlossen.

  1. Erstellen Sie eine Kennung für den aktuellen Synchronisierungszyklus.
  2. Fordern Sie die erste Seite an und speichern Sie die erhaltenen Leistungen.
  3. Aktualisieren Sie für jede Leistung das Feld last_seen_sync mit der Zykluskennung.
  4. Speichern Sie den Cursor der nächsten Seite, bevor Sie die nächste Anfrage ausführen.
  5. Vergleichen Sie nach dem erfolgreichen Durchlauf aller Seiten den Katalog mit dem aktuellen Zyklus.

Der Nachteil des sequenziellen Ladens von Seiten besteht darin, dass ein vollständiger Import länger dauern kann. Parallele Anfragen beschleunigen den Prozess, erhöhen aber das Risiko, an das API-Limit zu stoßen oder Seiten in unterschiedlichen Katalogzuständen zu erhalten.

Keine Duplikate bei erneuter Synchronisierung erzeugen

Verwenden Sie zum Auffinden einer vorhandenen Leistung einen zusammengesetzten Schlüssel: Anbieterkennung und externe ID der Leistung. Suchen Sie bei jedem erneuten Import zuerst nach dem Datensatz anhand dieses Paares und aktualisieren Sie dann die technischen Felder. Legen Sie einen neuen Datensatz nur an, wenn dieser Schlüssel fehlt.

Verwenden Sie für die Deduplizierung nicht Name, Preis oder Kategorie. Zwei verschiedene Leistungen können diese Werte teilen, und der Anbieter kann eine Position umbenennen, ohne die externe ID zu ändern. Auch für die Verknüpfungen mit dem Schaufenster ist eine eindeutige Kontrolle erforderlich: Dieselbe Route darf nach einem erneuten Aufgabenlauf nicht zweimal erscheinen.

Es ist sinnvoll, die Eindeutigkeit auf Datenbankebene zu beschränken: supplier_id + external_service_id für den Anbieterkatalog und supplier_id + external_service_id + showcase_card_id für das Mapping. Der Nachteil einer starren Beschränkung besteht darin, dass eine fehlerhafte alte Verknüpfung ausdrücklich korrigiert werden muss, statt einfach einen neuen Datensatz darüber anzulegen.

Gelöschte und verschwundene Leistungen erkennen

Eine Leistung gilt erst dann als verschwunden, wenn alle Seiten vollständig und erfolgreich durchlaufen wurden. Wenn die Synchronisierung wegen eines Fehlers, eines Anfragelimits oder der Nichtverfügbarkeit der API abgebrochen wurde, dürfen Positionen, die im bereits geladenen Teil des Katalogs fehlen, nicht als gelöscht markiert werden.

Suchen Sie nach einem abgeschlossenen Import die Leistungen dieses Anbieters, bei denen last_seen_sync nicht der Kennung des aktuellen Zyklus entspricht. Ihnen wird der Status „nicht gefunden“ oder „archiviert“ zugewiesen, sie werden von neuen Bestellungen ausgeschlossen und zur Prüfung weitergeleitet. Externe ID, Änderungshistorie und Verknüpfungen mit Bestellungen bleiben erhalten.

Eine verschwundene Leistung muss archiviert und nicht gelöscht werden. Der Anbieter kann sie später wieder in den Katalog aufnehmen, den Antwortfilter ändern oder die Position vorübergehend ausblenden. Eine archivierte Verknüpfung kann beim nächsten Import wiederhergestellt werden, wenn dieselbe externe ID erneut erscheint.

Was bei einer Änderung der externen Leistungs-ID zu tun ist

Wenn der Anbieter eine neue Leistung anstelle der alten erstellt hat, darf die neue externe ID nicht automatisch als Fortsetzung der bisherigen betrachtet werden. Selbst bei gleichem Namen und Preis können sich die Anforderungen an die Bestellung, die Geografie, der Zielgruppentyp oder die Ausgleichsbedingungen der Position geändert haben.

Verschieben Sie die alte Verknüpfung ins Archiv, nehmen Sie die Route aus dem Verkauf und bewahren Sie sie für alte Bestellungen auf. Importieren Sie die neue Leistung als separaten Datensatz. Erstellen Sie anschließend ein neues Mapping manuell oder nach einer sicheren Regel, wenn die technischen Parameter vollständig kompatibel sind.

Die automatische Zuordnung nach Namen kann die Arbeit beschleunigen, ihr Nachteil ist jedoch das Risiko, eine Bestellung an eine andere Leistung mit ungeeigneten Bedingungen zu senden. Für einen ID-Wechsel sollte besser der Status „Prüfung erforderlich“ verwendet werden als ein stiller Austausch der Route.

Mapping nach stabilen technischen Feldern einrichten

Die automatische Zuordnung von Leistungen sollte am besten anhand einer Reihe von Feldern erfolgen: Plattform, Leistungstyp, Geografie, Linkformat, Mindestvolumen, zusätzliche Parameter und Status. Beispielsweise kann eine Leistung in die Kategorie der Aufrufe nach Geo gelangen, wenn die API kompatible Werte für Plattform, Promotion-Typ und Land übermittelt.

Wenn der Anbieter einen Kommentar, eine Profilliste oder einen manuellen Start verlangt, veröffentlichen Sie die Route nicht im Standard-Bestellformular. Verwenden Sie eine separate Karte mit den erforderlichen Feldern oder lassen Sie die Leistung verborgen, bis die Integration fertiggestellt ist.

Der Name darf nur als zusätzliches Merkmal verwendet werden. Der Nachteil einer solchen Regel besteht darin, dass der Anbieter die Formulierung ändern, eine Abkürzung hinzufügen oder eine andere Schreibweise verwenden kann. Binden Sie kritische Routen an die externe ID und an prüfbare Antwortparameter.

API-Daten und Karten-Einstellungen trennen

Der Import darf die Schaufensterkarte nicht vollständig überschreiben. Einkaufspreis, Limits, Verfügbarkeit und technische Parameter werden in der Regel vom Anbieter aktualisiert. Der Kundenname, die Beschreibung, die Sichtbarkeit, die Anzeigereihenfolge und die Aufschlagsregeln bleiben interne Einstellungen des Panels.

Legen Sie für jedes Feld die Quelle der Wahrheit fest. Beispielsweise wird das Mindestvolumen aus der API übernommen, der Kundenname stammt aus dem Panel, und der Schaufensterpreis wird nach einer internen Regel auf Basis der Einkaufskosten berechnet. Ohne diese Trennung kann die Synchronisierung eine manuell bearbeitete Beschreibung löschen oder die Kategorie anhand des externen Namens ändern.

Änderungen von Preis und Parametern prüfen

Wenn der Anbieter den Preis geändert hat, berechnen Sie den Schaufensterpreis nach der Regel der Karte neu und prüfen Sie Währung, Gebühren und zulässige Marge. Bei fehlendem Preis, unbekannter Währung oder einer deutlichen Änderung der Bedingungen sollte die Route besser in den Prüfstatus versetzt werden.

Bei Änderungen des Minimums, des Maximums oder des Mengenschritts aktualisieren Sie das Bestellformular. Wenn das Formular die neuen Beschränkungen nicht unterstützt, nehmen Sie die Route aus dem Verkauf. Andernfalls gibt der Kunde eine Bestellung auf, die der Anbieter nach dem Senden ablehnt.

Wenn sich das Linkformat, ein Pflichtfeld, der Leistungstyp oder die Startmethode geändert haben, blockieren Sie neue Bestellungen bis zur manuellen Prüfung. Der Nachteil einer strikten Blockierung besteht darin, dass einige Karten vorübergehend aus dem Schaufenster verschwinden, aber das ist sicherer, als inkompatible Bestellungen anzunehmen.

API-Fehler und Anfragelimits behandeln

Ein Fehler bei einer einzelnen Anfrage darf nicht automatisch den gesamten Katalog deaktivieren. Unterscheiden Sie Fehler bei der Autorisierung, fehlerhafte Anfragen, vorübergehende Nichtverfügbarkeit und Ratenbegrenzungen. Für jede Gruppe ist ein eigenes Szenario erforderlich.

  • Bei einem Autorisierungsfehler stoppen Sie neue Bestellungen bei diesem Anbieter und prüfen Sie den Zugriff.
  • Bei einem Formatfehler der Anfrage speichern Sie die API-Antwort und korrigieren Sie die Integration ohne endlose Wiederholungen.
  • Bei einem vorübergehenden Fehler wiederholen Sie die Anfrage mit zunehmender Pause.
  • Bei einer Ratenbegrenzung speichern Sie den aktuellen Cursor und verschieben Sie die Aufgabe zur Wiederholung.

Markieren Sie Leistungen erst dann als verschwunden, wenn die aufgeschobene Synchronisierung erfolgreich abgeschlossen wurde. Der Nachteil aggressiver Wiederholungen besteht darin, dass das Anfragelimit schneller ausgeschöpft wird und der Katalog länger veraltet bleibt.

Routen für aktive Bestellungen erhalten

Der Status einer Leistung und der Status einer Bestellung sind unterschiedliche Entitäten. Eine Leistung kann für neue Kunden aus dem Katalog verschwinden, während alte Bestellungen dafür noch ausgeführt werden. Die Archivierung einer Karte oder Route darf die Statusabfrage bereits erstellter Bestellungen nicht stoppen.

Speichern Sie für jede Bestellung die externe Leistungs-ID, die externe Bestell-ID, die gesendeten Parameter, die Einkaufskosten zum Startzeitpunkt und die Statushistorie. Wenn der Anbieter eine Teilausführung, eine Stornierung oder einen Fehler meldet, bearbeiten Sie die Situation nach den Regeln des Panels: Rückerstattung, Ausgleich, Nachstart oder manuelle Prüfung.

Der Nachteil der Speicherung eines Snapshots der Bestellparameter besteht darin, dass mehr Speicherplatz und ein sorgfältiges Datenschema erforderlich sind. Ohne einen solchen Snapshot lässt sich nicht feststellen, zu welchen Bedingungen eine Bestellung gesendet wurde, wenn der Anbieter die Leistung später geändert hat.

Mapping vor der Veröffentlichung der Karten testen

Prüfen Sie nach der Einrichtung den vollständigen Ablauf: Bestellerstellung im Panel, Auswahl der Route, Übermittlung an den Anbieter, Speicherung der externen ID, Statusabruf, Stornierung und Behandlung einer Teilausführung. Testen Sie Leistungsgruppen mit unterschiedlichen Limits, Links und Pflichtfeldern.

Simulieren Sie zusätzlich einen erneuten Import, eine Preisänderung, das Verschwinden einer Leistung nach einem erfolgreichen vollständigen Durchlauf, einen Fehler in der Mitte der Paginierung und eine Ratenbegrenzung. So zeigt sich, ob das Panel funktionierende Routen wegen eines unvollständigen Katalogdownloads archiviert.

Besondere Aufmerksamkeit verdienen manuelle Leistungen und Positionen mit Kommentaren. Ihr Nachteil besteht darin, dass das Standardformular des Panels häufig nicht alle Daten übermittelt, die der Anbieter erwartet. Für sie ist eine separate Bestellvorlage oder ein verborgener Status bis zur Fertigstellung der API-Integration erforderlich.

Last Articles

Neues Website-Design

Was hat sich bei Design und Funktionen geändert Wir haben die Website aktualisiert, damit die Arbeit damit schneller und bequemer ist. Die wichtigste..

15.08.2026 Neu

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

Wir haben für Sie alle aktuellen Aktionen und Verlosungen bis zum 01.01.2026 zusammengestellt

1. Nutzen Sie den Aktionscode "December2025" für 15% Rabatt für alle unsere Zuschauer2. Wir haben bis zum 1. Januar die Grundpreise für unseren Konfig..

26.12.2025 Beendet

Zusammenarbeit mit Squads und Resellern

Twitch-Dienste sind wir arbeiten stabil, daher sind wir bereit, mit Trupps und Wiederverkäufern zusammenzuarbeiten, servicebesitzer, Bot-Besitzer ..

22.10.2025 Für Partner

Twitch-Zuschauer sind stabil, aber es gibt einige Nuancen.

Wir haben unsere Twitch Viewer-Dienste vollständig aktualisiert und sind jetzt verfügbar stabil arbeiten. Wir verwenden nur hochwertige IP-Adresse..

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 Neu

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 Wichtig

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 Für Partner

PARTNER UND EMPFEHLUNGEN: NEUE BEDINGUNGEN!

Aufgrund der großen Beliebtheit der Partnerdienste und des Empfehlungsprogramms haben wir eine Kooperationstabelle erstellt. Das Wesentliche ist ganz ..

12.08.2020 Für Partner

Zuschauer-Steuerungspanel [Twitch | Kick | YouTube | VK Video Live]

Erstelle deinen eigenen individuellen Tarif
Guthaben aufladen, Bestellung mit einem Klick, Rabatte und Boni sind nur für registrierte Nutzer verfügbar. Registrieren.
Wenn du den passenden Service nicht gefunden oder ihn günstiger gefunden hast, schreib an unseren Support in Telegram oder in den Chat – wir lösen jedes Problem.
Neu

Telegram-Bot @BOT_SP_RU_BOT

Bestellen und wiederholen in einer Minute, Guthaben und Bestellstatus – direkt in Telegram

Bestellung wiederholenBestellstatusGuthaben aufladenPromo-Codes