Reseller-API: Methodenreferenz
Jeder Endpunkt der Reseller-API in einer Tabelle mit Scope und Idempotenz-Flag, dazu der Link zur OpenAPI-3.1-Spezifikation von OneProvider zum Import.
Jeder Endpoint der Reseller-API in einer Tabelle mit Scope und Idempotenz-Kennzeichen sowie ein Link zur OpenAPI-3.1-Spezifikation.
Alle Modelle, Funktionen und Preise Dokumentationsindex für KI-Agenten:https://oneprovider.dev/docs/llms.txt Base URL: https://app.oneprovider.dev/partner/v1. Maschinenlesbare OpenAPI-3.1-Spezifikation: https://app.oneprovider.dev/partner/v1/openapi.yaml (öffentlich, kein Token nötig).
Die Spalte „Idempotency“ markiert die Methoden, die den Header Idempotency-Key verlangen. Der Scope „any“ steht für jeden gültigen Token, „none“ bedeutet, dass kein Token nötig ist.
| Methode | Pfad | Scope | Idempotency | Zweck |
|---|---|---|---|---|
GET | /me | any | - | Token, Scopes, Reseller. |
GET | /balance | read | - | Reseller-Guthaben, reserviert, verfügbar, Großhandelspreis, Aufladeanbieter. |
GET | /balance/transactions | read | - | Guthabentransaktionen (Cursor). |
POST | /balance/topups | billing | erforderlich | Eine Aufladezahlung erstellen, liefert pay_url. |
GET | /balance/topups/{order_id} | billing | - | Status Ihrer eigenen Zahlung. |
GET | /pricing | read | - | Großhandelspreis, Rabatt, Limits. |
GET | /models | read | - | Modellkatalog und aktueller Status. |
GET | /customers | read | - | Kunden auflisten (?external_id=). |
GET | /customers/{id} | read | - | Ein Kunde. |
POST | /customers | keys | - | Einen Kunden erstellen. |
PATCH | /customers/{id} | keys | - | Name und Notiz bearbeiten, sperren (blocked). |
GET | /customers/{id}/usage | read | - | Verbrauch eines Kunden über alle seine aktiven Schlüssel, pro Tag und pro Modell (?days=1..90). |
GET | /keys | read | - | Schlüssel auflisten (?status=, ?query=, ?customer_id=). |
GET | /keys/{id} | read | - | Ein Schlüssel ohne Secret, mit dashboard_url. |
GET | /keys/{id}/usage | read | - | Verbrauch eines Schlüssels pro Tag und pro Modell (?days=1..90, Standard 30). |
POST | /keys | keys | erforderlich | Einen Schlüssel ausstellen; das Secret wird einmal zurückgegeben. |
POST | /keys/bulk | keys | erforderlich | Mehrere identische Schlüssel auf einmal ausstellen. |
PATCH | /keys/{id} | keys | - | Limit, Laufzeit (expires_days/hours) oder Verlängerung (extend_days/hours), Name, Kundenkennzeichnung. |
DELETE | /keys/{id} | keys | - | Einen Schlüssel löschen (200 oder 202). |
POST | /keys/{id}/topup | keys | erforderlich | Einen Betrag zum Schlüssellimit hinzufügen. |
POST | /keys/{id}/rotate | keys | erforderlich | Einen Schlüssel rotieren: neues Secret, das alte funktioniert nicht mehr. |
POST | /keys/{id}/pause | keys | - | Einen Schlüssel pausieren. |
POST | /keys/{id}/resume | keys | - | Einen Schlüssel fortsetzen. |
POST | /orders | keys | erforderlich | Eine bezahlte Kundenbestellung: neuer Schlüssel oder Aufladung. |
GET | /orders | read | - | Bestellungen auflisten (?external_order_id=). |
GET | /orders/{id} | read | - | Eine Bestellung. |
GET | /plans | read | - | Ihre Tarife. |
POST | /plans | plans | - | Einen Tarif erstellen. |
PATCH | /plans/{id} | plans | - | Einen Tarif bearbeiten. |
DELETE | /plans/{id} | plans | - | Einen Tarif löschen. |
GET | /code-batches | codes | - | Code-Chargen auflisten. |
POST | /code-batches | codes | erforderlich | Eine Code-Charge erstellen. |
GET | /code-batches/{id} | codes | - | Eine Charge. |
GET | /code-batches/{id}/codes | codes | - | Codes einer Charge (?status=). |
POST | /code-batches/{id}/revoke | codes | - | Die nicht eingelösten Codes widerrufen. |
GET | /codes/{code} | codes | - | Status eines Codes. |
POST | /codes/{code}/redeem | codes | erforderlich | Einen Code in einen Schlüssel einlösen. |
GET | /stats | read | - | Tagesstatistik (?days=1..90). |
GET | /audit | read | - | Aktionsprotokoll (Filter period, actor, action, q). |
GET | /bot | bot | - | Der Verkaufs-Bot und der Support-Bot (ohne Tokens). |
GET | /settings | read | - | Shop-Einstellungen: Name, Kontakt, Marke, Schlüsselpräfix, Kundennachricht. |
PATCH | /settings | keys | - | Die Shop-Einstellungen bearbeiten (nur die gesendeten Felder). |
GET | /payment-providers | bot | - | Zahlungsmethoden des Bots: CryptoBot, xRocket, Platega (ohne Tokens); Stars sind immer aktiv. |
GET | /webhooks | webhooks | - | Webhooks auflisten. |
POST | /webhooks | webhooks | - | Einen Webhook erstellen; das Secret wird einmal angezeigt. |
DELETE | /webhooks/{id} | webhooks | - | Einen Webhook löschen. |
POST | /webhooks/{id}/test | webhooks | - | Ein Testereignis senden. |
GET | /webhooks/{id}/deliveries | webhooks | - | Zustellungsprotokoll. |
GET | /openapi.yaml | none | - | OpenAPI-3.1-Spezifikation (öffentlich). |
Gemeinsame Regeln (Paginierung, Fehler, Limits) stehen unter Autorisierung & Limits .
Zuletzt aktualisiert: 2026-11-08 Fehler gefunden? @Oneproviderhelpbot