Endpoint d'authentification et de compte

Chaque requête porte un seul en-tête. GET /account est l'endpoint que vous appelez pour prouver qu'une clé fonctionne, lire le solde du portefeuille sur lequel vos commandes sont débitées, et confirmer que le compte est actif avant de lancer un traitement par lots.

Comment une requête est authentifiée

L'en-tête Authorization porte un identifiant Bearer formé d'un identifiant de clé et d'un secret réunis par un point. L'identifiant de clé sélectionne le compte et le secret est vérifié par une comparaison HMAC ; un contrôle en échec répond 401 avec MISSING_API_KEY ou INVALID_API_KEY avant même l'exécution de la route. Rien d'autre n'est inspecté — ni cookie, ni token CSRF, ni en-tête d'origine.

Liste d'IP autorisées

Une clé peut être épinglée à un ensemble d'adresses sources. Tant que cette liste n'est pas vide, une requête venant de toute autre adresse est refusée avec IP_NOT_ALLOWED et un HTTP 403 — avant la limitation de débit et avant toute consultation du portefeuille — de sorte qu'un identifiant volé ne peut pas être utilisé hors de votre propre infrastructure. Une liste vide signifie que la clé fonctionne depuis n'importe où.

État du compte

Deux conditions au niveau du compte court-circuitent tous les endpoints : un compte désactivé répond ACCOUNT_DISABLED et un compte gelé répond ACCOUNT_FROZEN, tous deux avec un HTTP 403. Aucune ne se résout d'elle-même : remontez-les à un humain plutôt que de relancer en boucle.

Rotation des clés

Les clés se créent et se suppriment sur la page API Access du panneau revendeur. Le secret n'étant affiché qu'une fois, à la création, la rotation consiste à créer, déployer puis supprimer, et non à modifier sur place. Les identifiants n'expirent pas d'eux-mêmes : le calendrier de rotation vous appartient.

GET

/account

Get Account Info

Retrieve detailed account information including wallet balance, account status, and creation date.

Limite de requêtes60 req / 60s per user

Requête

curl -s "https://shop2topup.com/api/endpoints/v1/account" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"

Exemple de réponse

{
  "success": true,
  "account": {
    "id": 42,
    "email": "[email protected]",
    "username": "partner_store",
    "client_type": "reseller",
    "wallet": "1250.500000",
    "enabled": true,
    "verified": true,
    "created_at": "2024-01-15T10:30:00Z"
  }
}

Envoyez une vraie requête depuis cette page

Collez une clé API pour appeler ces endpoints en direct. La clé reste dans cet onglet du navigateur et n'est envoyée qu'à l'API elle-même.

Enter your API key to use the interactive playground. Get your API key

Choisissez un endpoint

Enter your API key above to try this endpoint.

Response will appear here after sending a request.

Nouveau sur la plateforme ? Commencez par la présentation de l'API de recharge de jeux pour revendeurs, ou lisez la présentation du programme revendeur SHOP2TOPUP pour comprendre le fonctionnement du compte partenaire.