Autentisering
- Authorization: ApiKey
- API-nøkkelen sendes bare i Authorization-headeren til POST /api/v1/auth/token. Ikke legg den i JSON, en URL eller spørringsparametere.
- Authorization: Bearer
- Bruk tokenet som returneres, til ressursforespørsler, og forny det i henhold til expires_at; expires_in angis i sekunder.
Hvorfor hente et token først?
API-nøkkelen brukes til å hente et token. Tokenet er gyldig i 15 minutter og kan brukes til flere forespørsler. Send bare tokenet til ressurser i headeren Authorization: Bearer.
Vanlige forespørsler inneholder ikke API-nøkkelen. Et lekket token kan gi tilgang høyst til det utløper. En stjålet API-nøkkel kan fortsatt gjøre det mulig å hente nye tokener.
Hvor lenge er et token gyldig?
- expires_in
- 900 sekunder, altså 15 minutter fra utstedelsen. Forespørsler forlenger ikke gyldigheten.
- expires_at
- Utløpstidspunkt i UTC. Gjeldende tilgangsbegrensninger kan blokkere tokenet tidligere.
Når skal du hente et nytt token?
Bruk samme token til flere forespørsler, og hent et nytt før expires_at. Ikke hent et token før hver operasjon. Bruk API-nøkkelen til å hente det nye tokenet.
Tilgang nektet og nye forsøk
- 401
- 401 betyr ikke alltid at tokenet er utløpt. Hvis det er utløpt, hent et nytt og gjenta lesingen høyst én gang. Hvis henting av tokenet gir 401, kontroller nøkkelen og stopp automatiske forsøk.
- 403
- Ved 403 må du kontrollere rettigheter, IP-begrensninger og abonnement. Et nytt token gjenoppretter ikke tilbakekalt tilgang.
IP-begrensninger
- Et tilgangstoken omgår ikke nøkkelens gjeldende tilganger, butikkens abonnementsrettigheter, tilbakekalling eller IP-begrensninger.
- Begrens eventuelt en nøkkel til integrasjonens kildeadresser.
- Administratoren kan redigere denne listen; maksimalt 32 adresser godtas.
Nøkkeladministrasjon
- Administrasjon av API-nøkler er atskilt fra integrasjonens ressurstilganger.
- Bare owner kan gi grupper administrative rettigheter til å se, opprette, redigere eller slette nøkler; et autorisert gruppemedlem kan bare utføre handlingene gruppen har fått tilgang til.
Forespørselsgrenser
Engine ≥ 4.143.0. Hvert tokensvar inneholder data.rate_limits fra butikkens gjeldende policy ved utstedelsen. Alle nøkler deler disse budsjettene; et nytt token nullstiller dem ikke. En abonnementsendring kan gjelde før tokenet utløper.
- read_per_minute
- Leseforespørsler per minutt.
- write_per_minute
- Skriveforespørsler per minutt; verdien gir ikke skrivetilgang.
- auth_per_minute
- Tokenforespørsler per minutt, inkludert mislykkede autentiseringsforsøk.