API
Authentification API
Authentifiez vos requêtes API avec des clés API ou des tokens JWT.
Authentification API
Méthodes d'authentification
Clé API (recommandée pour les intégrations)
Ajoutez votre clé API dans le header Authorization :
curl -H "Authorization: Bearer ak_live_xxxxx" \
https://api.swaloo.com/api/v1/shipmentsToken JWT (pour les applications frontend)
Obtenez un token via l'endpoint de connexion :
curl -X POST https://api.swaloo.com/api/v1/login_check \
-H "Content-Type: application/json" \
-d '{"email": "user@example.com", "password": "secret"}'Réponse :
{
"token": "eyJ...",
"refresh_token": "abc123..."
}Renouvellement du token
Les tokens JWT expirent après 1 heure. Utilisez le refresh token :
curl -X POST https://api.swaloo.com/api/v1/token/refresh \
-H "Content-Type: application/json" \
-d '{"refresh_token": "abc123..."}'Erreurs d'authentification
| Code | Signification |
|---|---|
401 | Token manquant ou expiré |
403 | Permissions insuffisantes |
Ne transmettez jamais vos clés API côté client. Utilisez-les uniquement depuis votre serveur.