Référence des méthodes de l’API revendeur
Chaque point d’accès de l’API revendeur en un tableau, avec scope et idempotence, et un lien vers la spécification OpenAPI 3.1 de OneProvider.
Tous les endpoints de l’API revendeur dans un seul tableau, avec leur autorisation et leur indicateur d’idempotence, plus un lien vers la spécification OpenAPI 3.1.
Tous les modèles, leurs capacités et leurs tarifs Index de la documentation pour les agents IA :https://oneprovider.dev/docs/llms.txt Base URL : https://app.oneprovider.dev/partner/v1. Spécification OpenAPI 3.1 lisible par machine : https://app.oneprovider.dev/partner/v1/openapi.yaml (publique, aucun jeton requis).
La colonne « Idempotency » signale les méthodes qui exigent l’en-tête Idempotency-Key. Dans la colonne « Scope », « any » signifie n’importe quel jeton valide et « none » qu’aucun jeton n’est nécessaire.
| Méthode | Chemin | Scope | Idempotency | Rôle |
|---|---|---|---|---|
GET | /me | any | - | Jeton, autorisations, revendeur. |
GET | /balance | read | - | Solde revendeur, réservé, disponible, prix de gros, prestataires de recharge. |
GET | /balance/transactions | read | - | Transactions du solde (curseur). |
POST | /balance/topups | billing | obligatoire | Crée un paiement de recharge, renvoie pay_url. |
GET | /balance/topups/{order_id} | billing | - | Statut de votre propre paiement. |
GET | /pricing | read | - | Prix de gros, remise, limites. |
GET | /models | read | - | Catalogue des modèles et état en direct. |
GET | /customers | read | - | Liste des clients (?external_id=). |
GET | /customers/{id} | read | - | Un client. |
POST | /customers | keys | - | Crée un client. |
PATCH | /customers/{id} | keys | - | Modifie le nom, la note, le blocage (blocked). |
GET | /customers/{id}/usage | read | - | Consommation d’un client sur toutes ses clés actives, par jour et par modèle (?days=1..90). |
GET | /keys | read | - | Liste des clés (?status=, ?query=, ?customer_id=). |
GET | /keys/{id} | read | - | Une clé sans le secret, avec dashboard_url. |
GET | /keys/{id}/usage | read | - | Consommation d’une clé par jour et par modèle (?days=1..90, 30 par défaut). |
POST | /keys | keys | obligatoire | Émet une clé ; le secret n’est renvoyé qu’une fois. |
POST | /keys/bulk | keys | obligatoire | Émet plusieurs clés identiques d’un coup. |
PATCH | /keys/{id} | keys | - | Limite, expiration (expires_days/hours) ou prolongation (extend_days/hours), nom, libellé du client. |
DELETE | /keys/{id} | keys | - | Supprime une clé (200 ou 202). |
POST | /keys/{id}/topup | keys | obligatoire | Ajoute un montant à la limite de la clé. |
POST | /keys/{id}/rotate | keys | obligatoire | Réémet une clé : nouveau secret, l’ancien cesse de fonctionner. |
POST | /keys/{id}/pause | keys | - | Met une clé en pause. |
POST | /keys/{id}/resume | keys | - | Reprend une clé. |
POST | /orders | keys | obligatoire | Une commande payée d’un client : nouvelle clé ou recharge. |
GET | /orders | read | - | Liste des commandes (?external_order_id=). |
GET | /orders/{id} | read | - | Une commande. |
GET | /plans | read | - | Vos forfaits. |
POST | /plans | plans | - | Crée un forfait. |
PATCH | /plans/{id} | plans | - | Modifie un forfait. |
DELETE | /plans/{id} | plans | - | Supprime un forfait. |
GET | /code-batches | codes | - | Liste des lots de codes. |
POST | /code-batches | codes | obligatoire | Crée un lot de codes. |
GET | /code-batches/{id} | codes | - | Un lot. |
GET | /code-batches/{id}/codes | codes | - | Codes d’un lot (?status=). |
POST | /code-batches/{id}/revoke | codes | - | Révoque les codes non activés. |
GET | /codes/{code} | codes | - | Statut d’un code. |
POST | /codes/{code}/redeem | codes | obligatoire | Transforme un code en clé. |
GET | /stats | read | - | Statistiques quotidiennes (?days=1..90). |
GET | /audit | read | - | Journal des actions (filtres period, actor, action, q). |
GET | /bot | bot | - | Le bot de vente et le bot de support (sans jetons). |
GET | /settings | read | - | Paramètres de la boutique : nom, contact, marque, préfixe des clés, message au client. |
PATCH | /settings | keys | - | Modifie les paramètres de la boutique (uniquement les champs envoyés). |
GET | /payment-providers | bot | - | Moyens de paiement du bot : CryptoBot, xRocket, Platega (sans jetons) ; Stars est toujours activé. |
GET | /webhooks | webhooks | - | Liste des webhooks. |
POST | /webhooks | webhooks | - | Crée un webhook ; le secret n’est affiché qu’une fois. |
DELETE | /webhooks/{id} | webhooks | - | Supprime un webhook. |
POST | /webhooks/{id}/test | webhooks | - | Envoie un événement de test. |
GET | /webhooks/{id}/deliveries | webhooks | - | Journal des livraisons. |
GET | /openapi.yaml | none | - | Spécification OpenAPI 3.1 (publique). |
Les règles communes (pagination, erreurs, limites) sont décrites dans Autorisation et limites .
Dernière mise à jour: 2026-11-08 Vous avez trouvé un bug ? @Oneproviderhelpbot