Démarrage : obtenir votre clé API

Votre espace client personnel : un solde commun, jusqu’à 3 clés API, des codes de marketplace et la consommation requête par requête. Dans le bot Telegram et sur app.oneprovider.dev.

Comment ça marche

• Le solde et les clés se trouvent dans votre espace client personnel. C’est le même espace dans le bot et sur le site.
• Vous rechargez un solde commun et créez vous-même vos clés API (3 par défaut ; le support peut relever cette limite). Chaque clé dépense ce solde dans la limite qui lui est propre.
• Une ancienne clé est transférée dans l’espace client, avec son solde restant, quand vous ouvrez le bot.

Ouvrir l’espace client

Se connecter à l’espace client et utiliser une clé API sont deux choses différentes : la clé API reste l’identifiant de type bearer pour les requêtes API, tandis que la connexion sert uniquement à gérer le solde et les clés.

Recharger le solde

1. Bot : « Mon espace » → « Recharger le solde ». Site : « Solde » → « Recharge ».
2. Choisissez un pack ou un montant libre de 100 $ à 5 000 $, puis un moyen de paiement : crypto, cartes internationales / Apple Pay / Google Pay, SBP / QR. Le montant final et les frais s’affichent avant le paiement.
3. Payez via le lien ou la facture. Le solde est crédité automatiquement, en général dans un délai de 1 à 3 minutes.

• SBP/QR. Le client paie 3,5 % de frais ; OneProvider prend en charge 3,5 % de plus.
• Crypto. Des frais de 3 % du prestataire de paiement s’appliquent, plus les frais de réseau à la charge du client.

Les tarifs des packs sont sur la page des tarifs  ; les moyens de paiement sur la page Moyens de paiement . Le solde n’expire pas, et il n’y a ni abonnement ni prélèvement automatique. Vous avez payé, mais le solde n’a pas changé ? Envoyez le reçu à @Oneproviderhelpbot .

Code de marketplace

Acheté sur G2A, Plati, G2G ou une plateforme similaire ? Votre commande est accompagnée d’un code du type OP-XXXX-XXXX. Bot : « Autres » → « Activer un code ». Site : « Solde » → champ « Code OP ». Le montant de la commande est crédité directement sur le solde de l’espace client ; vous créez la clé vous-même (étape suivante).

Créer une clé

1. Bot : « Mon espace » → « Créer une clé ». Site : « Clés » → « Créer une clé ».
2. Définissez un nom (par exemple, le client), une limite de dépense (ou « sans limite ») et une durée : jusqu’à 90 jours, prolongeable ensuite.
3. Copiez la clé tout de suite : la clé complète n’est affichée qu’une seule fois, puis seulement via « Afficher » après une nouvelle connexion.

Utilisez une clé distincte par client ou par projet : vous voyez qui dépense quoi, et on peut arrêter une clé sans toucher aux autres. Vous pouvez avoir 3 clés par défaut (le support peut relever cette limite sur demande) ; si la limite est atteinte, supprimez-en une — son solde est déjà dans l’espace client, rien n’est perdu.

Format de la clé

Les clés sont sk- suivi de 64 caractères hexadécimaux en minuscules — par exemple sk-50e20199...f837fca1. Considérez la valeur comme opaque : rien de ce qu’elle contient n’est exploitable.

Où la stocker

• Développement local : une variable d’environnement dans le fichier rc de votre shell, ou un fichier .env exclu par .gitignore.
• CI : le magasin de secrets de la plateforme (secrets GitHub Actions, variables GitLab CI, etc.).
• Production : un vrai gestionnaire de secrets — 1Password, AWS Secrets Manager, Doppler, Vault.
• Mobile / navigateur : jamais. La clé doit rester derrière un proxy côté serveur que vous contrôlez.

Consommation et solde

La page « Consommation » de l’espace client liste chaque requête avec son modèle, ses jetons et son prix, filtrable par clé. L’API renvoie aussi le solde : GET /v1/dashboard/balance .

Bonus

Le bonus de bienvenue et le bonus de première recharge sont des offres promotionnelles : elles peuvent n’être proposées que pour une durée limitée, et ces bonus ne peuvent être ni retirés ni remboursés (voir les Conditions ). Les offres disponibles sont affichées dans l’espace client ; une fois l’offre expirée, le bonus ne peut plus être obtenu.

Parrainage

L’onglet « Parrainages » de l’espace client contient votre lien personnel. Invitez d’autres personnes et recevez une récompense selon les conditions affichées dans l’espace client. Une inscription via votre propre lien ne donne droit à aucune récompense.

Fusion d’espaces clients

Si vous avez deux espaces clients (par exemple un dans Telegram et un sur le site), écrivez à @Oneproviderhelpbot  : une fois que vous avez prouvé être propriétaire des deux, nous les fusionnons, et le solde et les clés se retrouvent dans un seul espace client.

Pause, suppression, fuites

• La pause arrête une clé sans la supprimer ; « Réactiver » la remet en marche.
• La suppression désactive la clé immédiatement et est irréversible. Le solde reste dans l’espace client.

Activer un code de marketplace : questions

Où saisir le code OP-XXXX-XXXX ?

Dans le bot Telegram, choisissez « Autres » → « Activer un code ». Sur app.oneprovider.dev, ouvrez « Solde » et utilisez le champ « Code OP ». Le montant de la commande est ajouté au solde de votre espace client ; créez ensuite une clé à l’étape « Créer une clé » ci-dessus.

J’active sur redeem.oneprovider.dev. Quel onglet utiliser ?

« Nouvel utilisateur » crée une nouvelle clé à partir du code et du nom d’utilisateur ou de l’e-mail de votre commande. « J’ai déjà une clé » ajoute le solde du code à une ancienne clé sk- que vous possédez déjà. Un second code avec le même e-mail ne crée pas une autre nouvelle clé : utilisez « J’ai déjà une clé » ou un autre e-mail.

Je n’ai pas copié la clé après l’activation

Saisissez de nouveau le même code sur la page d’activation : elle affiche la clé à nouveau, masquée derrière un clic pour la révéler. Les clés créées dans l’espace client peuvent être affichées via « Afficher » après une nouvelle connexion.

« We couldn’t find this code »

Vérifiez qu’il n’y a pas de faute de frappe (le code est OP- suivi de deux groupes de quatre caractères). Un code révoqué ou appartenant à quelqu’un d’autre n’est pas trouvé non plus. Réessayez depuis un autre navigateur, puis écrivez au support en indiquant l’ID de votre commande sur la marketplace.

Puis-je obtenir un remboursement pour un code ?

En général via un litige sur la marketplace où vous l’avez acheté. Nos propres règles figurent dans la Politique de remboursement .