Clé API
Une clé API est une longue chaîne aléatoire par laquelle un service sait qui a envoyé une requête : à quel compte elle appartient, à quel forfait et quelles données elle peut recevoir. Pour un programme, la clé joue le rôle d’un mot de passe : quiconque connaît la chaîne agit au nom du propriétaire.
Comment la clé est envoyée
La clé voyage dans un en-tête de chaque requête, tandis que les filtres vont dans l’URL. Dans Genesis API, l’en-tête est X-API-Key et la clé ressemble à gns_live_…. L’exemple demande les signaux alpha notés de Signaux IA :
import os
import requests
key = os.environ.get("GENESIS_API_KEY")
if not key:
raise SystemExit("définissez GENESIS_API_KEY sur le serveur")
r = requests.get(
"https://api.genesisarbitrage.com/v1/ai/signals",
headers={"X-API-Key": key}, # la clé va uniquement dans l’en-tête
params={"category": "alpha"}, # les filtres vont dans l’URL
timeout=10,
)
if r.status_code == 401:
# la clé est absente, invalide ou révoquée
print(r.json()["error"]["code"]) # invalid_key
elif r.ok:
print("signaux alpha :", r.json()["meta"]["count"])
On utilise un en-tête parce que l’URL de la requête, chaîne de requête comprise, se retrouve dans les journaux du serveur web et des proxys, et dans l’historique du navigateur si quelqu’un l’ouvre dedans. La documentation de Genesis API est claire : ne passez jamais la clé dans les paramètres de requête, ne l’intégrez jamais au code d’un site ou d’une application, et faites les requêtes depuis votre propre serveur uniquement. Les exchanges font de même : Binance reçoit la clé dans l’en-tête X-MBX-APIKEY, et les requêtes de compte sont en plus signées avec une seconde clé, l’API secret.
Comment stocker la clé
- Gardez la clé dans une variable d’environnement ou un fichier
.envsur le serveur, et ajoutez.envà.gitignore. - Ne collez jamais la clé dans le code d’un site, une application mobile, un chat ou une capture d’écran.
- Genesis API affiche la clé une seule fois et ne conserve que son hash : une clé perdue ne se récupère pas, elle se réémet.
- Si la clé fuite, cliquez sur « Réémettre » dans votre profil et l’ancienne clé cesse de fonctionner aussitôt. « Révoquer » désactive la clé sans en fournir une nouvelle.
Clé d’exchange et clé Genesis API
| Clé d’exchange | Clé Genesis API | |
|---|---|---|
| Droits | Lire, trader, retirer : ce que vous activez | Lecture des données uniquement |
| Une fuite expose | Les transactions et retraits de votre compte | Votre quota d’appels |
| Protection | Pas de retraits, liste blanche d’IP | Réémission dans votre profil |
Une clé Genesis API est en lecture seule : elle ne peut ni passer d’ordres ni retirer de l’argent. Les erreurs de clé et leurs codes figurent dans les sections Authentification et Erreurs.
Voir aussi : API, endpoint, rate limit, clé API : obtenir, stocker, réémettre et révoquer.
Questions et réponses
Puis-je créer plusieurs clés Genesis API ?
Non, un compte a une seule clé. « Réémettre » vous donne une nouvelle clé et désactive l’ancienne immédiatement.
Où obtenir une clé Genesis API ?
Dans votre profil, dans le bloc « Genesis API », une fois un forfait API payé. Le bouton « Obtenir la clé » ouvre la fenêtre « Votre clé API » avec un bouton « Copier ».