Opis metod API resellera
Wszystkie endpointy API resellera w jednej tabeli z zakresem i flagą idempotentności oraz link do specyfikacji OpenAPI 3.1 OneProvider, gotowej do importu.
Wszystkie endpointy API resellera w jednej tabeli z uprawnieniem i flagą idempotentności oraz link do specyfikacji OpenAPI 3.1.
Wszystkie modele, możliwości i ceny Indeks dokumentacji dla agentów AI:https://oneprovider.dev/docs/llms.txt Base URL: https://app.oneprovider.dev/partner/v1. Specyfikacja OpenAPI 3.1 do odczytu maszynowego: https://app.oneprovider.dev/partner/v1/openapi.yaml (publiczna, token niepotrzebny).
Kolumna „Idempotentność” oznacza metody wymagające nagłówka Idempotency-Key. Uprawnienie „dowolne” oznacza dowolny ważny token, „brak” oznacza, że token nie jest potrzebny.
| Metoda | Ścieżka | Uprawnienie | Idempotentność | Przeznaczenie |
|---|---|---|---|---|
GET | /me | dowolne | - | Token, uprawnienia, reseller. |
GET | /balance | read | - | Saldo resellera, zarezerwowane, dostępne, cena hurtowa, bramki doładowań. |
GET | /balance/transactions | read | - | Transakcje salda (kursor). |
POST | /balance/topups | billing | wymagana | Tworzy płatność doładowania, zwraca pay_url. |
GET | /balance/topups/{order_id} | billing | - | Status twojej płatności. |
GET | /pricing | read | - | Cena hurtowa, rabat, limity. |
GET | /models | read | - | Katalog modeli i status na żywo. |
GET | /customers | read | - | Lista klientów (?external_id=). |
GET | /customers/{id} | read | - | Klient. |
POST | /customers | keys | - | Tworzy klienta. |
PATCH | /customers/{id} | keys | - | Edycja nazwy, notatki, blokady (blocked). |
GET | /customers/{id}/usage | read | - | Zużycie klienta ze wszystkich jego działających kluczy, według dni i modeli (?days=1..90). |
GET | /keys | read | - | Lista kluczy (?status=, ?query=, ?customer_id=). |
GET | /keys/{id} | read | - | Klucz bez sekretu, z dashboard_url. |
GET | /keys/{id}/usage | read | - | Zużycie klucza według dni i modeli (?days=1..90, domyślnie 30). |
POST | /keys | keys | wymagana | Wydaje klucz; sekret jest zwracany tylko raz. |
POST | /keys/bulk | keys | wymagana | Wydaje kilka identycznych kluczy naraz. |
PATCH | /keys/{id} | keys | - | Limit, termin ważności (expires_days/hours) lub przedłużenie (extend_days/hours), nazwa, etykieta klienta. |
DELETE | /keys/{id} | keys | - | Usuwa klucz (200 lub 202). |
POST | /keys/{id}/topup | keys | wymagana | Dodaje kwotę do limitu klucza. |
POST | /keys/{id}/rotate | keys | wymagana | Rotacja klucza: nowy sekret, stary przestaje działać. |
POST | /keys/{id}/pause | keys | - | Wstrzymuje klucz. |
POST | /keys/{id}/resume | keys | - | Wznawia klucz. |
POST | /orders | keys | wymagana | Opłacone zamówienie klienta: nowy klucz lub doładowanie. |
GET | /orders | read | - | Lista zamówień (?external_order_id=). |
GET | /orders/{id} | read | - | Zamówienie. |
GET | /plans | read | - | Twoje plany. |
POST | /plans | plans | - | Tworzy plan. |
PATCH | /plans/{id} | plans | - | Edytuje plan. |
DELETE | /plans/{id} | plans | - | Usuwa plan. |
GET | /code-batches | codes | - | Lista partii kodów. |
POST | /code-batches | codes | wymagana | Tworzy partię kodów. |
GET | /code-batches/{id} | codes | - | Partia. |
GET | /code-batches/{id}/codes | codes | - | Kody partii (?status=). |
POST | /code-batches/{id}/revoke | codes | - | Unieważnia niezaktywowane kody. |
GET | /codes/{code} | codes | - | Status kodu. |
POST | /codes/{code}/redeem | codes | wymagana | Aktywuje kod w klucz. |
GET | /stats | read | - | Statystyki dzienne (?days=1..90). |
GET | /audit | read | - | Dziennik działań (filtry period, actor, action, q). |
GET | /bot | bot | - | Bot sklepu i bot wsparcia (bez tokenów). |
GET | /settings | read | - | Ustawienia sklepu: nazwa, kontakt, marka, prefiks klucza, wiadomość dla klienta. |
PATCH | /settings | keys | - | Edytuje ustawienia sklepu (tylko wysłane pola). |
GET | /payment-providers | bot | - | Bramki płatności bota: CryptoBot, xRocket, Platega (bez tokenów); Stars są zawsze włączone. |
GET | /webhooks | webhooks | - | Lista webhooków. |
POST | /webhooks | webhooks | - | Tworzy webhook; sekret jest widoczny tylko raz. |
DELETE | /webhooks/{id} | webhooks | - | Usuwa webhook. |
POST | /webhooks/{id}/test | webhooks | - | Wysyła zdarzenie testowe. |
GET | /webhooks/{id}/deliveries | webhooks | - | Dziennik dostarczeń. |
GET | /openapi.yaml | brak | - | Specyfikacja OpenAPI 3.1 (publiczna). |
Wspólne zasady (paginacja, błędy, limity) opisano w Autoryzacja i limity .
Ostatnia aktualizacja: 2026-11-08 Widzisz błąd? @Oneproviderhelpbot