DocsAuthentification
Découvrez comment vous authentifier auprès de l'API Cost+
Toute communication avec l'API Cost+ nécessite TLS 1.2 ou supérieur et l'authentification HTTP Basic.
Fonctionnement de l'authentification Basic
Authentifiez-vous en utilisant votre clé API comme nom d'utilisateur avec un mot de passe vide. Encodez en Base64 la chaîne \{api_key\}: (notez les deux-points à la fin — le mot de passe est vide).
L'en-tête Authorization résultant ressemble à ceci :
Authorization: Basic aHVudGVyMjo=N'exposez jamais votre clé API dans du code côté client ou dans des dépôts publics. Conservez-la exclusivement côté serveur.
Utilisation avec cURL
Méthode native (recommandée)
cURL prend en charge nativement l'authentification Basic avec le flag -u. Passez votre clé API suivie de deux-points :
curl -u YOUR_API_KEY: https://api.costplus.online/v1/orders/Encodage Base64 manuel
Si vous préférez construire l'en-tête vous-même, encodez d'abord la clé :
echo -n "YOUR_API_KEY:" | base64Puis passez la valeur encodée dans l'en-tête Authorization :
curl -H "Authorization: Basic YOUR_BASE64_ENCODED_KEY" https://api.costplus.online/v1/orders/Les deux-points après la clé API sont obligatoires — ils séparent le nom d'utilisateur du mot de passe (vide) dans le schéma Basic Auth.
Codes de statut HTTP
L'API utilise les codes de statut HTTP standard pour indiquer le résultat d'une requête.
| Code de statut | Signification | Description |
|---|---|---|
| 200 | OK | La requête a réussi. |
| 201 | Créé | La ressource a été créée avec succès. |
| 400 | Requête invalide | La requête est malformée ou des champs obligatoires sont manquants. |
| 401 | Non autorisé | L'authentification a échoué — vérifiez votre clé API. |
| 403 | Interdit | Vous n'avez pas la permission d'accéder à cette ressource. |
| 404 | Non trouvé | La ressource demandée n'existe pas. |
| 500 | Erreur interne du serveur | Un problème est survenu de notre côté. |
| 502 | Mauvaise passerelle | Erreur du service en amont. |
| 503 | Service indisponible | L'API est temporairement indisponible. |
| 504 | Délai de passerelle dépassé | Le service en amont n'a pas répondu à temps. |