Clés API
Gérez la clé API de votre organisation pour intégrer Swaloo dans vos systèmes.
Clés API
Chaque organisation de Swaloo dispose d'une clé API unique, utilisée pour authentifier les intégrations externes (serveur à serveur) auprès de l'API externe.
La clé est une longue chaîne hexadécimale (64 caractères) générée aléatoirement pour l'organisation. Il n'y a ni préfixe ak_live_/ak_test_, ni distinction Live/Test : une seule clé par organisation.
Utilisation
La clé se transmet dans le header X-API-KEY (et non Authorization: Bearer) :
curl -H "X-API-KEY: votre_cle_api" \
https://api.swaloo.com/api/v1/external/shipments/{id}Elle n'est reconnue que sur les routes /api/v1/external/... et attribue à l'organisation le rôle ROLE_EXTERNAL_API. Voir Authentification.
Où trouver la clé
La clé API est disponible dans les Paramètres de l'organisation.
Gardez votre clé API secrète. Ne l'intégrez jamais dans du code côté client ni dans un dépôt public. Utilisez-la uniquement depuis votre serveur.
Portée
La clé API donne accès à l'API externe (création et suivi d'expéditions). Elle ne donne pas accès aux endpoints du dashboard, qui requièrent un token JWT.
Voir aussi : Authentification API | API externe | Endpoints