Tokeni za ufikiaji ni za nini
Tokeni za ufikiaji zinaruhusu skripti zako mwenyewe na miunganisho ya wahusika wengine kuzungumza na API ya Storeep kwa niaba ya duka lako. Kila tokeni inabeba seti maalum ya ruhusa, dirisha la data la hiari, na tarehe ya kuisha ya hiari. Tokeni ni salama zaidi kuliko kushiriki kuingia kwako kwa dashibodi kwa sababu unaweka kila moja mawanda ya hasa kile muunganisho unahitaji na unaibatilisha peke yake wakati wowote.
Ili kusimamia tokeni, nenda Settings, Access tokens. Kitufe cha View documentation kinafungua marejeo kamili ya API kwenye kichupo kipya.
Vikomo vya tokeni
- Unaweza kuweka hadi tokeni 40 za ufikiaji kwa duka. Mara ufikiapo 40, kitufe cha Create new token kinatoweka hadi ufute moja.
- Tokeni zinaorodheshwa mpya kwanza, 20 kwa ukurasa.
Kuunda tokeni
Bofya Create new token, jaza fomu, kisha bofya Create.
Jina la tokeni
- Inahitajika, hadi herufi 50.
- Inatumika tu kutambua tokeni kwenye orodha yako. Haitumwi kamwe kwa wahusika wengine.
Ruhusa
Chagua angalau moja ya ruhusa nne. Kila moja inajitegemea, na API inakataa ombi lolote ambalo ruhusa yake hukuipa (jibu la 403 "insufficient permissions" likitaja ruhusa inayohitajika):
- Read products: fikia orodha za bidhaa, maelezo, varianti, na data ya hisa.
- Read orders: fikia historia ya maagizo, maelezo, hali, na vipengele vya mstari.
- Read webhooks: orodhesha na tazama usanidi wako wa webhook.
- Manage webhooks: unda, sasisha, na futa webhooks.
Kama hutachagua chochote, uundaji unashindwa kwa "Please select at least one permission". Webhooks zenyewe zinawekwa chini ya Settings, Webhooks; ruhusa hizi zinadhibiti tu ufikiaji wa API kwao.
Ufikiaji wa data
Hii inadhibiti hadi nyuma kiasi gani kwa wakati tokeni inaweza kusoma data yako. Chagua chaguo lenye vikwazo zaidi ambalo bado linafanya kazi.
- Last 24 hours (chaguo-msingi): tokeni inaona tu data kutoka dirisha la saa 24 linalozunguka, lililohesabiwa upya kwa kila ombi. Salama zaidi, bora kwa milisho ya wakati halisi.
- Set start date: tokeni inaona tu data iliyoundwa katika au baada ya tarehe ya kalenda unayochagua. Kuchagua hii kunafichua kichagua cha Data access start date.
- All time: hakuna kizuizi cha tarehe, tokeni inasoma historia yote. Tumia tu pale muunganisho unahitaji kweli.
Kuisha
- Never expires (chaguo-msingi): halali hadi uifute.
- Set expiration date: inafichua kichagua cha Expiration date. Tarehe lazima iwe angalau siku moja mbele na isizidi mwaka mmoja kuanzia leo. Baada ya kupita, tokeni inaacha kufanya kazi kiotomatiki na ombi lolote la API linarudisha "access token has expired".
Thamani ya tokeni (inaonyeshwa mara moja)
Baada ya kubofya Create, thamani ya tokeni (UUID) inaonekana mara moja kwenye ujumbe wa mafanikio. Nakili na uhifadhi mahali salama mara moja. Storeep haionyeshi tena kamwe na haiwezi kuirejesha. Kama utaipoteza, futa tokeni na uunde mpya.
Kutumia tokeni na API
- Tuma thamani kwenye kichwa cha HTTP kama Authorization: Bearer YOUR_TOKEN. Kichwa kinachokosekana au kisicho sahihi kinarudisha hitilafu ya 401.
- Kila tokeni ina kikomo cha kasi cha maombi 60 kwa sekunde 60. Kuzidi kunarudisha jibu la 429 "rate limit exceeded", hivyo simama na ujaribu tena baada ya dirisha kuanza upya.
- Vituo vya orodha vinakubali kichujio cha market (msimbo wa nchi moja au hadi 20), pamoja na limit (1 hadi 50, chaguo-msingi 20), page (chaguo-msingi 1), na kupanga kwa created_at au updated_at. Ona View documentation kwa URL za vituo na maelezo kamili.
Kuhariri tokeni
Bofya safu yoyote ya tokeni kuhariri jina lake, ruhusa, hali ya ufikiaji wa data, na kuisha. Huwezi kutazama au kubadilisha thamani ya tokeni yenyewe, kuhariri kunasasisha tu mipangilio iliyoambatishwa na tokeni iliyopo, hivyo miunganisho inaendelea kufanya kazi bila thamani mpya.
Safu za orodha ya tokeni
- Name: lebo uliyoipa, ikiwa na tarehe na muda wa kuundwa chini.
- Permissions: ruhusa zilizotolewa (au None).
- Data access: inaonyesha Last 24 hours, All data, au From [date].
- Expiration: tarehe ya kuisha, au Never.
- Last used: tarehe na muda wa ombi la mwisho la API lililothibitishwa la tokeni, au Never.
Kufuta tokeni
Chagua tokeni moja au zaidi na bofya Delete tokens, au tumia kitendo cha kufuta cha kila safu. Kufuta ni mara moja na cha mwisho: muunganisho wowote bado unaotumia thamani hiyo unaanza kupata hitilafu za uthibitishaji za 401 mara moja.
Vidokezo vya usalama
- Toa tu ruhusa ambazo muunganisho unahitaji kweli.
- Weka ufikiaji wa data wa Last 24 hours kwa milisho ya moja kwa moja, na utumie Set start date kwa usawazishaji uliopangwa.
- Weka tarehe ya kuisha kwa wakandarasi wa muda mfupi au kazi za mara moja.
- Angalia safu ya Last used: tokeni ambayo Never imetumika au imekaa bila kazi kwa muda mrefu pengine ni ya muunganisho uliokufa na ni salama kuifuta.