DocsAutentisering
Lær hvordan du autentiserer mot Cost+ API-et
All kommunikasjon med Cost+ API-et krever TLS 1.2 eller nyere og HTTP Basic-autentisering.
Slik fungerer Basic Auth
Autentiser ved å bruke API-nøkkelen din som brukernavn med et tomt passord. Base64-kod strengen \{api_key\}: (merk det avsluttende kolonet — passordet er tomt).
Den resulterende Authorization-headeren ser slik ut:
Authorization: Basic aHVudGVyMjo=Aldri eksponer API-nøkkelen din i klientside-kode eller offentlige repositorier. Hold den kun på serversiden.
Bruk med cURL
Standard (anbefalt)
cURL støtter Basic Auth direkte med -u-flagget. Send API-nøkkelen din etterfulgt av et kolon:
curl -u YOUR_API_KEY: https://api.costplus.online/v1/orders/Manuell Base64-koding
Hvis du foretrekker å bygge headeren selv, koder nøkkelen først:
echo -n "YOUR_API_KEY:" | base64Deretter sender du den kodede verdien i Authorization-headeren:
curl -H "Authorization: Basic YOUR_BASE64_ENCODED_KEY" https://api.costplus.online/v1/orders/Det avsluttende kolonet etter API-nøkkelen er påkrevd — det skiller brukernavnet fra det (tomme) passordet i Basic Auth-ordningen.
HTTP-statuskoder
API-et bruker standard HTTP-statuskoder for å indikere resultatet av en forespørsel.
| Statuskode | Betydning | Beskrivelse |
|---|---|---|
| 200 | OK | Forespørselen var vellykket. |
| 201 | Opprettet | Ressursen ble opprettet. |
| 400 | Ugyldig forespørsel | Forespørselen var feilformatert eller manglet påkrevde felt. |
| 401 | Ikke autorisert | Autentisering feilet — sjekk API-nøkkelen din. |
| 403 | Forbudt | Du har ikke tilgang til denne ressursen. |
| 404 | Ikke funnet | Den forespurte ressursen finnes ikke. |
| 500 | Intern serverfeil | Noe gikk galt på vår side. |
| 502 | Ugyldig gateway | Feil i oppstrømstjeneste. |
| 503 | Tjenesten utilgjengelig | API-et er midlertidig utilgjengelig. |
| 504 | Gateway-tidsavbrudd | Oppstrømstjenesten svarte ikke i tide. |