Hitelesítés
- Authorization: ApiKey
- Az API-kulcsot kizárólag a POST /api/v1/auth/token kérés Authorization fejlécében küldje el. Ne tegye JSON-ba, URL-be vagy lekérdezési paraméterbe.
- Authorization: Bearer
- Az erőforrásokhoz a kapott tokent használja, és az expires_at szerint újítsa meg; az expires_in másodpercben adja meg az élettartamot.
Miért kell először tokent kérni?
Az API-kulccsal tokent kérhet. A token 15 percig érvényes, és több kéréshez is használható. Az erőforrásokhoz csak a tokent küldje az Authorization: Bearer fejlécben.
A szokásos kérések nem tartalmazzák az API-kulcsot. A kiszivárgott token legfeljebb a lejáratáig biztosít hozzáférést. Az ellopott API-kulcs azonban továbbra is lehetővé teheti új tokenek kérését.
Meddig érvényes a token?
- expires_in
- A kiadástól számított 900 másodpercig, vagyis 15 percig. A kérések nem hosszabbítják meg az érvényességet.
- expires_at
- A lejárat időpontja UTC szerint. Az aktuális hozzáférési korlátozások korábban is letilthatják a tokent.
Mikor kérjen új tokent?
Használja ugyanazt a tokent több kéréshez, és az expires_at előtt kérjen újat. Nem kell minden művelet előtt tokent kérnie. Az új tokenhez az API-kulcsot használja.
Hozzáférés megtagadva és újrapróbálkozás
- 401
- A 401 nem mindig jelenti a token lejártát. Ha lejárt, kérjen újat, és az olvasást legfeljebb egyszer ismételje meg. Ha a tokenkérés 401-et ad vissza, ellenőrizze a kulcsot, és állítsa le az automatikus próbálkozásokat.
- 403
- 403 esetén ellenőrizze a jogosultságokat, az IP-korlátozásokat és a csomagot. Az új token nem állítja vissza a visszavont hozzáférést.
IP-korlátozások
- A hozzáférési token nem kerüli meg a kulcs aktuális jogosultságait, az áruház csomagkorlátozásait, a visszavonást vagy az IP-korlátozásokat.
- Szükség esetén korlátozza a kulcsot az integráció forráscímeire.
- A rendszergazda módosíthatja a listát; legfeljebb 32 cím engedélyezett.
Kulcskezelés
- Az API-kulcsok kezelése külön jogosultság az integráció erőforrás-jogosultságaitól.
- Csak az owner adhat a csoportoknak jogot kulcsok megtekintésére, létrehozására, szerkesztésére vagy törlésére; a csoport tagja csak a csoportnak engedélyezett műveleteket végezheti el.
Kéréskorlátok
Engine ≥ 4.143.0. Minden tokenválasz tartalmazza a kiadáskor érvényes áruházi szabályzat data.rate_limits értékeit. Az összes kulcs közösen használja ezeket a kereteket; új token nem állítja vissza őket. A csomagváltás a token lejárta előtt is érvényesülhet.
- read_per_minute
- Olvasási kérések percenként.
- write_per_minute
- Írási kérések percenként; ez az érték nem ad írási jogosultságot.
- auth_per_minute
- Tokenkérések percenként, a sikertelen hitelesítési kísérletekkel együtt.