Authentification
Chaque requête a besoin d'une clé d'API, envoyée dans le header HTTP Authorization.
Obtenir votre clé d'API
Écrivez à wino@isagri.com. Il y a une clé d'API par environnement, staging ou production (voir Environnements).
La garder secrète
- Traitez votre clé comme un mot de passe. Stockez-la dans un gestionnaire de secrets ou une variable d'environnement, jamais dans votre dépôt de code.
- Utilisez-la uniquement depuis un serveur. Ne la mettez jamais dans un site web, une application mobile ou tout ce qui s'exécute sur les appareils de vos clients : n'importe qui pourrait l'y lire.
- En cas de fuite, écrivez immédiatement à wino@isagri.com.
L'utiliser dans vos requêtes
Ajoutez ce header à chaque requête, GraphQL et REST :
Authorization: Bearer <your API key>
Les exemples de cette documentation lisent la clé depuis une variable d'environnement nommée WINO_API_KEY, pour qu'elle n'apparaisse jamais dans votre code. Définissez-la une fois, par exemple avec export WINO_API_KEY="<your API key>". Le header, dans chaque langage :
- curl
- JavaScript
- PHP
- Python
-H "Authorization: Bearer $WINO_API_KEY"
headers: {
Authorization: `Bearer ${process.env.WINO_API_KEY}`;
}
'header' => 'Authorization: Bearer ' . getenv('WINO_API_KEY')
headers={"Authorization": f"Bearer {os.environ['WINO_API_KEY']}"}
Pour une première requête complète, voir le Démarrage rapide.
Sans clé valide, l'API GraphQL répond avec une erreur UNAUTHENTICATED, et l'API des webhooks avec 401 Unauthorized : voir Erreurs.