Generelle regler

  • REST API er tilgjengelig under basis-URL-en:

/public/external/api

  • Alle forespørsler må sendes via POST.
  • REST API støtter bare forespørsler via HTTPS.
  • Forespørsler må inneholde følgende overskrifter:
Rediger

Navn på overskrift



Overskriftsverdi



Beskrivelse



Innholdstype



application/json



fast



autorisasjon



123…xyz



API-nøkkel fra fanen «API-tilgang»



underskrift



Base64-kodet signatur



Signaturen til nyttelasten generert med


privat nøkkel fra fanen «API-tilgang»


  • Forespørselen må være et json-kodet objekt som må inneholde følgende verdier:
Rediger

Felt



Felt Eksempel Verdi



Beskrivelse



api



v2/enhet/listdeenheter



Navnet på API-et



tid



1529662725



Unix-tidsstempel (UTC) for klientmaskinen.


Den maksimalt tillatte tidsforskjellen


mellom klienten og serveren er 30


minutter.


  • Hvis API-et lykkes, returnerer det de forespurte dataene (se spørringene nedenfor) og en HTTP-statuskode 200.
  • Hvis det oppstår en feil, vil HTTP-statuskoden være mellom 4xx og 5xx, avhengig av feilen, og svarobjektet vil inneholde en matrise med nøkkelen «errors», som inneholder en liste over feilmeldinger som er lesbare for mennesker.
  • Hvis det ikke finnes noen matchende data for en enhet, returneres en tom matrise.
  • Hvis en enhets-ID ikke finnes, vil returdataene være null.
This site is registered on wpml.org as a development site. Switch to a production site key to remove this banner.