Awtentikazzjoni
- Authorization: ApiKey
- Iċ-ċavetta API tintbagħat biss fil-header Authorization ta’ POST /api/v1/auth/token. Tpoġġihiex f’JSON, f’URL jew f’parametri tal-query.
- Authorization: Bearer
- Uża t-token mogħti għat-talbiet tar-riżorsi u ġeddu skont expires_at; expires_in huwa espress f’sekondi.
Għaliex tikseb token l-ewwel?
Iċ-ċavetta API tintuża biex tikseb token. It-token huwa validu għal 15-il minuta u jista’ jintuża għal diversi talbiet. Għar-riżorsi, ibgħat biss it-token fl-intestatura Authorization: Bearer.
It-talbiet normali ma fihomx iċ-ċavetta API. Token li jkun żvelat jagħti aċċess biss sakemm jiskadi. Ċavetta API misruqa xorta tista’ tippermetti l-kisba ta’ tokens ġodda.
Kemm idum validu token?
- expires_in
- 900 sekonda, jiġifieri 15-il minuta mill-ħruġ. It-talbiet ma jestendux il-validità.
- expires_at
- Il-ħin tal-iskadenza f’UTC. Ir-restrizzjonijiet attwali tal-aċċess jistgħu jimblukkaw it-token qabel.
Meta għandek tikseb token ġdid?
Uża l-istess token għal diversi talbiet u ikseb ieħor qabel expires_at. Titlobx token qabel kull operazzjoni. Uża ċ-ċavetta API biex tikseb it-token il-ġdid.
Aċċess miċħud u tentattivi mill-ġdid
- 401
- 401 mhux dejjem ifisser li t-token skada. Jekk skada, ikseb wieħed ġdid u erġa’ pprova l-qari darba biss. Jekk il-kisba tat-token tagħti 401, iċċekkja ċ-ċavetta u waqqaf it-tentattivi awtomatiċi.
- 403
- Għal 403, iċċekkja l-permessi, ir-restrizzjonijiet IP u l-pjan. Token ġdid ma jirrestawrax aċċess revokat.
Restrizzjonijiet IP
- Token ta’ aċċess ma jevitax il-permessi attwali taċ-ċavetta, id-drittijiet tal-ħanut, ir-revoka jew ir-restrizzjonijiet IP.
- Fejn xieraq, illimita ċ-ċavetta għall-indirizzi tas-sors tal-integrazzjoni.
- L-amministratur jista’ jeditja din il-lista; huma permessi sa 32 indirizz.
Ġestjoni taċ-ċwievet
- Il-ġestjoni taċ-ċwievet API hija separata mill-permessi tar-riżorsi tal-integrazzjoni.
- owner biss jista’ jagħti lill-gruppi permessi amministrattivi biex jaraw, joħolqu, jeditjaw jew iħassru ċwievet; membru awtorizzat jista’ jagħmel biss l-azzjonijiet mogħtija lill-grupp tiegħu.
Limiti tar-rata
Engine ≥ 4.143.0. Kull tweġiba tat-token tinkludi data.rate_limits mill-politika tal-ħanut fil-ħin tal-ħruġ. Iċ-ċwievet kollha jaqsmu dawn il-limiti; token ġdid ma jerġax jibdihom. Bidla fil-pjan tista’ tapplika qabel jiskadi t-token.
- read_per_minute
- Talbiet għall-qari kull minuta.
- write_per_minute
- Talbiet għall-kitba kull minuta; dan il-valur ma jagħtix permessi għall-kitba.
- auth_per_minute
- Talbiet għal token kull minuta, inklużi tentattivi ta’ awtentikazzjoni li fallew.