Godkendelse
- Authorization: ApiKey
- API-nøglen sendes kun i Authorization-headeren til POST /api/v1/auth/token. Sæt den ikke i JSON, en URL eller forespørgselsparametre.
- Authorization: Bearer
- Brug det returnerede token til ressourceforespørgsler, og forny det i henhold til expires_at; expires_in angives i sekunder.
Hvorfor hente et token først?
Din API-nøgle bruges til at hente et token. Tokenet er gyldigt i 15 minutter og kan bruges til flere kald. Send kun tokenet til ressourcer i headeren Authorization: Bearer.
Almindelige kald indeholder ikke din API-nøgle. Et lækket token kan højst give adgang, indtil det udløber. En stjålet API-nøgle kan stadig gøre det muligt at hente nye tokens.
Hvor længe er et token gyldigt?
- expires_in
- 900 sekunder, altså 15 minutter fra udstedelsen. Kald forlænger ikke gyldigheden.
- expires_at
- Udløbstidspunkt i UTC. Aktuelle adgangsbegrænsninger kan blokere tokenet tidligere.
Hvornår skal du hente et nyt token?
Genbrug tokenet til flere kald, og hent et nyt før expires_at. Hent ikke et token før hver handling. Brug API-nøglen til at hente det nye token.
Adgang nægtet og nye forsøg
- 401
- 401 betyder ikke altid, at tokenet er udløbet. Hvis det er udløbet, skal du hente et nyt og gentage læsningen højst én gang. Hvis hentning af tokenet giver 401, skal du kontrollere nøglen og stoppe automatiske forsøg.
- 403
- Ved 403 skal du kontrollere rettigheder, IP-begrænsninger og abonnement. Et nyt token gendanner ikke tilbagekaldt adgang.
IP-begrænsninger
- Et adgangstoken omgår ikke nøglens aktuelle rettigheder, butikkens abonnementsrettigheder, tilbagekaldelse eller IP-begrænsninger.
- Begræns eventuelt en nøgle til integrationens kildeadresser.
- Administratoren kan redigere listen; højst 32 adresser accepteres.
Administration af nøgler
- Administration af API-nøgler er adskilt fra integrationens ressourcerettigheder.
- Kun owner kan tildele grupper de administrative rettigheder til at se, oprette, redigere eller slette nøgler; et autoriseret gruppemedlem kan kun udføre de handlinger, gruppen har fået adgang til.
Forespørgselsgrænser
Engine ≥ 4.143.0. Hvert tokensvar indeholder data.rate_limits fra butikkens politik ved udstedelsen. Alle nøgler deler disse budgetter; en ny token nulstiller dem ikke. En abonnementsændring kan gælde, før tokenen udløber.
- read_per_minute
- Læseanmodninger pr. minut.
- write_per_minute
- Skriveanmodninger pr. minut; værdien giver ikke skriverettigheder.
- auth_per_minute
- Tokenanmodninger pr. minut, inklusive mislykkede godkendelsesforsøg.