Riferimento dei metodi dell'API rivenditori
Tutti gli endpoint dell'API rivenditori in una tabella con scope e flag di idempotenza, più il link alla specifica OpenAPI 3.1 di OneProvider da importare.
Ogni endpoint dell'API per rivenditori in un'unica tabella con scope e flag di idempotenza, più un link alla specifica OpenAPI 3.1.
Tutti i modelli, le funzionalità e i prezzi Indice della documentazione per agenti AI:https://oneprovider.dev/docs/llms.txt Base URL: https://app.oneprovider.dev/partner/v1. Specifica OpenAPI 3.1 leggibile da macchina: https://app.oneprovider.dev/partner/v1/openapi.yaml (pubblica, non serve alcun token).
La colonna «Idempotency» segna i metodi che richiedono l'header Idempotency-Key. Scope «any» significa qualsiasi token valido, «none» significa che non serve alcun token.
| Metodo | Percorso | Scope | Idempotency | Scopo |
|---|---|---|---|---|
GET | /me | any | - | Token, scope, rivenditore. |
GET | /balance | read | - | Saldo da rivenditore, riservato, disponibile, prezzo all'ingrosso, provider di ricarica. |
GET | /balance/transactions | read | - | Transazioni del saldo (cursore). |
POST | /balance/topups | billing | obbligatoria | Crea un pagamento di ricarica, restituisce pay_url. |
GET | /balance/topups/{order_id} | billing | - | Stato di un tuo pagamento. |
GET | /pricing | read | - | Prezzo all'ingrosso, sconto, limiti. |
GET | /models | read | - | Catalogo dei modelli e stato in tempo reale. |
GET | /customers | read | - | Elenco dei clienti (?external_id=). |
GET | /customers/{id} | read | - | Un cliente. |
POST | /customers | keys | - | Crea un cliente. |
PATCH | /customers/{id} | keys | - | Modifica nome, nota, blocco (blocked). |
GET | /customers/{id}/usage | read | - | Consumo di un cliente su tutte le sue chiavi attive, per giorno e per modello (?days=1..90). |
GET | /keys | read | - | Elenco delle chiavi (?status=, ?query=, ?customer_id=). |
GET | /keys/{id} | read | - | Una chiave senza il segreto, con dashboard_url. |
GET | /keys/{id}/usage | read | - | Consumo giornaliero e per modello di una chiave (?days=1..90, predefinito 30). |
POST | /keys | keys | obbligatoria | Emette una chiave; il segreto viene restituito una sola volta. |
POST | /keys/bulk | keys | obbligatoria | Emette più chiavi identiche in una volta. |
PATCH | /keys/{id} | keys | - | Limite, scadenza (expires_days/hours) o prolungamento (extend_days/hours), nome, etichetta del cliente. |
DELETE | /keys/{id} | keys | - | Elimina una chiave (200 o 202). |
POST | /keys/{id}/topup | keys | obbligatoria | Aggiunge un importo al limite della chiave. |
POST | /keys/{id}/rotate | keys | obbligatoria | Riemette una chiave: nuovo segreto, il vecchio smette di funzionare. |
POST | /keys/{id}/pause | keys | - | Mette in pausa una chiave. |
POST | /keys/{id}/resume | keys | - | Riattiva una chiave. |
POST | /orders | keys | obbligatoria | Un ordine pagato di un cliente: nuova chiave o ricarica. |
GET | /orders | read | - | Elenco degli ordini (?external_order_id=). |
GET | /orders/{id} | read | - | Un ordine. |
GET | /plans | read | - | I tuoi piani. |
POST | /plans | plans | - | Crea un piano. |
PATCH | /plans/{id} | plans | - | Modifica un piano. |
DELETE | /plans/{id} | plans | - | Elimina un piano. |
GET | /code-batches | codes | - | Elenco dei lotti di codici. |
POST | /code-batches | codes | obbligatoria | Crea un lotto di codici. |
GET | /code-batches/{id} | codes | - | Un lotto. |
GET | /code-batches/{id}/codes | codes | - | Codici di un lotto (?status=). |
POST | /code-batches/{id}/revoke | codes | - | Revoca i codici non riscattati. |
GET | /codes/{code} | codes | - | Stato di un codice. |
POST | /codes/{code}/redeem | codes | obbligatoria | Riscatta un codice in una chiave. |
GET | /stats | read | - | Statistiche giornaliere (?days=1..90). |
GET | /audit | read | - | Registro delle azioni (filtri period, actor, action, q). |
GET | /bot | bot | - | Il bot di vendita e il bot di assistenza (senza token). |
GET | /settings | read | - | Impostazioni del negozio: nome, contatto, brand, prefisso delle chiavi, messaggio al cliente. |
PATCH | /settings | keys | - | Modifica le impostazioni del negozio (solo i campi inviati). |
GET | /payment-providers | bot | - | Metodi di pagamento del bot: CryptoBot, xRocket, Platega (senza token); i pagamenti in Stars sono sempre attivi. |
GET | /webhooks | webhooks | - | Elenco dei webhook. |
POST | /webhooks | webhooks | - | Crea un webhook; il segreto viene mostrato una sola volta. |
DELETE | /webhooks/{id} | webhooks | - | Elimina un webhook. |
POST | /webhooks/{id}/test | webhooks | - | Invia un evento di test. |
GET | /webhooks/{id}/deliveries | webhooks | - | Registro delle consegne. |
GET | /openapi.yaml | none | - | Specifica OpenAPI 3.1 (pubblica). |
Le regole comuni (paginazione, errori, limiti) sono descritte in Autorizzazione e limiti .
Ultimo aggiornamento: 2026-11-08 Hai trovato un errore? @Oneproviderhelpbot