DocsAutentificering
Lær hvordan du autentificerer med Cost+ API'et
Al kommunikation med Cost+ API'et kræver TLS 1.2 eller højere og HTTP Basic Authentication.
Sådan fungerer Basic Auth
Autentificer ved at bruge din API-nøgle som brugernavn med et tomt adgangskode. Base64-indkod strengen \{api_key\}: (bemærk det afsluttende kolon — adgangskoden er tom).
Den resulterende Authorization-header ser sådan ud:
Authorization: Basic aHVudGVyMjo=Eksponer aldrig din API-nøgle i klient-side-kode eller offentlige repositories. Hold den kun på server-siden.
Brug af cURL
Direkte (anbefalet)
cURL understøtter Basic Auth direkte med -u-flaget. Angiv din API-nøgle efterfulgt af et kolon:
curl -u YOUR_API_KEY: https://api.costplus.online/v1/orders/Manuel Base64-indkodning
Hvis du foretrækker at konstruere headeren selv, skal du først indkode nøglen:
echo -n "YOUR_API_KEY:" | base64Angiv derefter den indkodede værdi i Authorization-headeren:
curl -H "Authorization: Basic YOUR_BASE64_ENCODED_KEY" https://api.costplus.online/v1/orders/Det afsluttende kolon efter API-nøglen er påkrævet — det adskiller brugernavnet fra det (tomme) adgangskode i Basic Auth-skemaet.
HTTP-statuskoder
API'et bruger standard HTTP-statuskoder til at angive resultatet af en anmodning.
| Statuskode | Betydning | Beskrivelse |
|---|---|---|
| 200 | OK | Anmodningen lykkedes. |
| 201 | Oprettet | Ressourcen blev oprettet. |
| 400 | Ugyldig anmodning | Anmodningen var forkert udformet eller manglede påkrævede felter. |
| 401 | Ikke autoriseret | Autentificering fejlede — tjek din API-nøgle. |
| 403 | Forbudt | Du har ikke tilladelse til at tilgå denne ressource. |
| 404 | Ikke fundet | Den anmodede ressource findes ikke. |
| 500 | Intern serverfejl | Noget gik galt på vores side. |
| 502 | Bad Gateway | Upstream-servicefejl. |
| 503 | Service utilgængelig | API'et er midlertidigt utilgængeligt. |
| 504 | Gateway Timeout | Upstream-servicen svarede ikke i tide. |