Reseller/Checkliste zur Integration
Checkliste für Reseller
Wenn du die Wokey-API an deine eigenen Nutzer weiterverkaufst, geh die folgende Liste der Reihe nach durch. Jeder Punkt verlinkt auf die ausführliche Beschreibung.
Checklistelink
- 1
X-End-User-Idbei jeder Anfrage mitsendenWenn ein Key viele Endnutzer bedient, gibt dieser Header an, zu welchem Endnutzer eine Anfrage gehört. Verstößt ein Endnutzer wiederholt gegen die Regeln, schränkt Wokey nur diesen Nutzer ein, deine übrigen Nutzer arbeiten normal weiter. Enterprise- und Reseller-Konten können eingeschränkte Nutzer außerdem in der Konsole einsehen und Einschränkungen selbst aufheben.
- 2
Ablehnungen des Modells erkennen
Auch bei einer Ablehnung lautet der HTTP-Status 200, du erkennst sie deshalb an den Feldern der Antwort. Bitte deinen Nutzer in diesem Fall, den Inhalt zu ändern, statt dieselbe Anfrage zu wiederholen.
- 3
Regelverstöße früh abfangen
Wiederholte Ablehnungen führen zu Rate-Limits, gesperrten Modellen und Gebühren für Verstöße. Mit oder ohne
X-End-User-Idzählen Verstöße für dein Konto, filtere Inhalte deshalb, bevor du Anfragen an Wokey sendest. - 4
Fehler nach Statuscode behandeln
Unterscheide zwischen unzureichendem Guthaben (402), Rate-Limits (429) und Upstream-Fehlern (502, 504, 529) und zeige je nach Fall einen Hinweis an oder wiederhole die Anfrage. Gib den Antwort-Header
x-wokey-request-idan, wenn du den Support kontaktierst. - 5
Guthaben und Nutzung überwachen
Das Guthaben des Kontos fragst du mit
/v1/dashboard/balanceab, Nutzung und verbleibendes Limit pro Key mit/v1/usageund/v1/key. Lade rechtzeitig auf, bevor das Guthaben aufgebraucht ist. - 6
Bei Bedarf einen Anbieter festlegen
Hat ein Modell mehrere Anbieter, kannst du mit
providerim Request-Body Anbieter vorgeben oder ausschließen.