DocsAuthenticatie
Leer hoe u zich authenticeert bij de Cost+ API
Alle communicatie met de Cost+ API vereist TLS 1.2 of hoger en HTTP Basic Authentication.
Hoe Basic Auth werkt
Authenticeer door uw API-sleutel als gebruikersnaam te gebruiken met een leeg wachtwoord. Base64-codeer de string \{api_key\}: (let op de afsluitende dubbele punt — het wachtwoord is leeg).
De resulterende Authorization-header ziet er als volgt uit:
Authorization: Basic aHVudGVyMjo=Stel uw API-sleutel nooit bloot in client-side code of openbare repositories. Bewaar deze uitsluitend aan de serverzijde.
Gebruik van cURL
Standaard (aanbevolen)
cURL ondersteunt Basic Auth standaard met de -u-vlag. Geef uw API-sleutel op gevolgd door een dubbele punt:
curl -u YOUR_API_KEY: https://api.costplus.online/v1/orders/Handmatige Base64-codering
Als u de header liever zelf opbouwt, codeer dan eerst de sleutel:
echo -n "YOUR_API_KEY:" | base64Geef vervolgens de gecodeerde waarde door in de Authorization-header:
curl -H "Authorization: Basic YOUR_BASE64_ENCODED_KEY" https://api.costplus.online/v1/orders/De afsluitende dubbele punt na de API-sleutel is vereist — deze scheidt de gebruikersnaam van het (lege) wachtwoord in het Basic Auth-schema.
HTTP-statuscodes
De API gebruikt standaard HTTP-statuscodes om het resultaat van een verzoek aan te geven.
| Statuscode | Betekenis | Beschrijving |
|---|---|---|
| 200 | OK | Verzoek geslaagd. |
| 201 | Aangemaakt | Resource is succesvol aangemaakt. |
| 400 | Ongeldig verzoek | Het verzoek was onjuist geformuleerd of miste verplichte velden. |
| 401 | Niet geautoriseerd | Authenticatie mislukt — controleer uw API-sleutel. |
| 403 | Verboden | U heeft geen toestemming om toegang te krijgen tot deze resource. |
| 404 | Niet gevonden | De gevraagde resource bestaat niet. |
| 500 | Interne serverfout | Er is iets misgegaan aan onze kant. |
| 502 | Bad Gateway | Upstream-servicefout. |
| 503 | Service niet beschikbaar | De API is tijdelijk niet beschikbaar. |
| 504 | Gateway Timeout | De upstream-service reageerde niet op tijd. |