UNLOCK API
Clé API
Clés API et sécurité
MarkdownOpenAPI

Clés API et sécurité

Comment envoyer votre clé, utiliser plusieurs clés et n'autoriser que vos serveurs.

Votre clé

Chaque requête contient la clé API de votre page de compte : clientKey dans les requêtes JSON, key dans in.php et res.php. Une clé fait 32 caractères (0-9, a-f). Gardez-la sur votre serveur ; toute personne qui a la clé peut dépenser votre solde.
POST /getBalance
{
  "clientKey": "YOUR_API_KEY"
}

Clés supplémentaires

Vous pouvez créer jusqu'à 5 clés supplémentaires sur la page de compte, par exemple une par serveur ou par projet. Elles partagent le solde, indiquent leur dernière utilisation et peuvent être désactivées une par une.

Liste d'IP autorisées

Ajoutez jusqu'à 20 adresses IP sur la page de compte : seules ces adresses pourront utiliser vos clés. Les requêtes venant d'autres adresses reçoivent ERROR_IP_NOT_ALLOWED et ne sont pas facturées.
Erreur
{
  "errorId": 1,
  "errorCode": "ERROR_IP_NOT_ALLOWED",
  "errorDescription": "Requests from this IP are not allowed. Add it to the IP allow list on your account page."
}

Appels depuis un navigateur

in.php et res.php ajoutent l'en-tête CORS Access-Control-Allow-Origin: * quand vous envoyez header_acao=1. Appeler l'API depuis une page web publique expose votre clé, réservez donc cet usage à vos propres outils.