Uthibitishaji wa utambulisho

Alkax hutumia vitambulisho tofauti kwa watu wanaotumia programu na miradi inayounganishwa kutoka seva. Tumia kitambulisho na ruhusa chache zaidi zinazofaa utaratibu.

Vipindi vya watumiaji

Vitendo shirikishi vya watumiaji hutumia tokeni ya ufikiaji ya bearer:

Authorization: Bearer <access-token>

Tokeni zinaweza kutolewa baada ya njia zinazotumika za kuingia kama nenosiri, passkey au mtoa huduma wa utambulisho aliyewashwa. Vipindi vya watumiaji ni kwa vitendo vinavyofanywa kwa niaba ya mtumiaji huyo.

Usinakili tokeni ya mtumiaji katika uunganishaji wa seva unaoendelea kwa muda mrefu.

Vitambulisho vya Developer Platform

Endpoint za seva-kwa-seva hukubali kitambulisho cha mradi:

X-Alkax-Key: ak_test_<key-id>.<secret>

Kila mradi una mazingira tofauti ya Sandbox na Production:

• Funguo za Sandbox huanza na ak_test_.
• Funguo za Production huanza na ak_live_.

Mpango wa Free unaweza kutoa na kutumia vitambulisho vya Sandbox. Usajili wa kulipia unahitajika kutoa, kubadilisha au kutumia vitambulisho vya Production. Matumizi ya kila mwezi ya API yanashirikiwa katika miradi yote na mazingira yanayotozwa kwa mwenye usajili.

Siri kamili huoneshwa tu kitambulisho kinapotolewa au kubadilishwa. Ihifadhi mara moja katika kidhibiti cha siri. Alkax huhifadhi kitambulishi cha ufunguo na hashi iliyotokana na siri, si siri yenyewe.

Ruhusa za awali zinazopatikana ni:

• places:read
• geocode:read
• delivery:read
• delivery:write

Toa vitambulisho tofauti kwa kila huduma na mazingira. Kubadilisha kitambulisho huunda mbadala ili uweze kuusambaza kabla ya kubatilisha kitambulisho cha awali. Ubatilishaji, kuisha muda, kusimamishwa kwa mradi na kusimamishwa kwa mazingira hubatilisha maombi yanayofuata.

Tazama mwongozo wa Developer Platform kwa usanidi wa mradi, data za majaribio za Sandbox, kumbukumbu, vikomo na webhook.

Usalama wa vitambulisho

• Usiweke kamwe vitambulisho vya mradi kwenye JavaScript ya frontend au programu iliyojengwa ya simu.
• Usiweke kamwe kitambulisho, kiungo cha mpokeaji au siri ya kutia sahihi webhook katika URL.
• Ficha siri na data binafsi ya uwasilishaji katika kumbukumbu na ufuatiliaji.
• Chukulia 401 kuwa kitambulisho kinakosekana, hakijaundwa vizuri, ni batili, kimeisha muda au kimebatilishwa. Chukulia 403 kuwa ombi limethibitishwa lakini halina ruhusa ya kitendo hicho.
• Batilisha kitambulisho mara moja ikiwa huenda kimefichuliwa.
• Jumuisha X-Request-Id ya jibu unapowasiliana na usaidizi; usitume kitambulisho chenyewe.

Marejeleo ya API yanaonesha mpango wa uthibitishaji wa utambulisho kwa kila endpoint inayotumika.