Ruka hadi kwenye maudhui makuu

Unganisha utaratibu wa mahali, si endpoint tu

Uunganishaji bora zaidi wa Alkax huhifadhi kitambulisho cha kudumu cha mahali, hutenganisha data binafsi ya utaratibu na data ya umma ya mahali, na huchagua kiwango cha uaminifu kinachofaa uamuzi.

Njia za kawaida​

Pata mahali​

Tumia utafutaji wa Alkax mtumiaji au mwendeshaji anapohitaji kuchagua mahali palipo kwa jina, eneo, Plus Code, viwianishi, kategoria au ukaribu.

Hifadhi: kitambulisho cha mahali cha Alkax na sehemu zinazohitajika kwa kuonesha.
Kagua tena: data ya kuonesha inayobadilika inapohitaji kuwa ya sasa.

Rekodi mahali panapokosekana​

Ruhusu mtumiaji aliyeidhinishwa kuunda mahali utafutaji usipopata kinacholingana. Onesha maonyo ya nakala rudufu badala ya kulazimisha kuunda kiotomatiki.

Hifadhi: kitambulisho cha mahali kilichorudishwa.
Epuka: kuchukulia kila anwani ya uwasilishaji ya maandishi huru kuwa mahali papya pa umma.

Thibitisha au ongeza taarifa​

Tumia endpoint husika ya washirika uamuzi wa uendeshaji unapohitaji kiashiria thabiti zaidi cha ubora wa anwani au uthibitishaji.

Hifadhi: matokeo, muhuri wake wa muda na kitambulisho chochote cha sera/toleo.
Epuka: kutafsiri kiashiria cha uaminifu wa jukwaa kuwa uthibitisho wa umiliki wa ardhi au hali ya kisheria.

Thibitisha kabla ya kutuma mzigo​

Tumia Delivery Intelligence mpokeaji anapolazimika kuidhinisha au kusahihisha mahali palipopendekezwa kabla ya kutimiza agizo.

Hifadhi: kitambulisho cha ombi, rejeleo la mfanyabiashara, nakala isiyobadilika iliyothibitishwa, hali ya mzunguko wa maisha na kitambulisho cha tukio.
Linda: mawasiliano ya mpokeaji, kiungo cha uthibitisho, maelekezo binafsi, picha za kiingilio, kitambulisho cha mfanyabiashara na siri ya kutia sahihi.

Fungua mwongozo wa Delivery Intelligence →

Your frontend → Your backend → Alkax API
                         ↘ Your webhook receiver

Kivinjari huwasiliana na backend yako. Backend yako huhifadhi kitambulisho cha mradi mahususi kwa mazingira, huita Alkax, hutekeleza kanuni za tenant na kurudisha data ambayo kivinjari kinahitaji tu.

Orodha ya ukaguzi wa uunganishaji wa Production​

  • Tumia kitambulisho tofauti cha mradi kwa Sandbox na Production.
  • Hifadhi vitambulisho na siri za webhook katika kidhibiti cha siri.
  • Weka muda wa mwisho wa kusubiri na majaribio ya kurudia yenye kikomo.
  • Tumia funguo za idempotency pale utaratibu unapozihitaji.
  • Hifadhi vitambulisho vya Alkax badala ya kulinganisha kwa kichwa baadaye.
  • Ondoa urudiaji wa matukio ya webhook kabla ya kutekeleza athari.
  • Ficha data binafsi na viungo salama kwenye kumbukumbu.
  • Fuatilia mgao, 429, kushindwa kwa uthibitishaji wa utambulisho na mrundikano wa webhook.
  • Jaribu hali zisizofanikiwa: nakala rudufu, marekebisho, kuisha muda, ubatilishaji na majaribio ya kurudia.

Tumia marejeleo ya API kwa miundo kamili baada ya kuchagua njia.