Tambua tatizo kwa hali na msimbo thabiti
Hifadhi X-Request-Id, kitambulisho cha kitendo na hali. Usiweke kamwe ufunguo wa API, URL ya mpokeaji, mawasiliano, picha ya ushahidi au mwili ghafi wa webhook kwenye kumbukumbu. Baadhi ya endpoint hurudisha code yenye muundo, nyingine hurudisha hitilafu za uhakiki au 401/403/404 isiyo na mwili. Usidhani kila hitilafu ina umbo lilelile la JSON, na usifanye maamuzi kulingana na maandishi ya ujumbe yaliyotafsiriwa.
| Msimbo au hali | Chanzo kinachowezekana | Kurudia na hatua ya kusahihisha |
|---|---|---|
| 401 | Kitambulisho kinakosekana, hakijaundwa vizuri, kimebatilishwa au kimeisha muda | Sahihisha kitambulisho; usijaribu tena bila kubadilisha |
| 403 | Ruhusa ya kitendo au akaunti inakosekana | Kagua ruhusa ya kitendo na mazingira; sasisha vitambulisho baada ya mabadiliko ya usanidi |
| 404 | Kitambulisho/mazingira yasiyo sahihi au uwezo wa ufikiaji ulioisha muda/batili | Kagua usomaji rasmi uliothibitishwa na mazingira |
| 429 | Kikomo cha kasi/mgao | Heshimu Retry-After; ongeza muda wa kusubiri kwa hatua za kizidishi pamoja na utofauti wa nasibu |
| 5xx / kushindwa kwa usafirishaji | Kushindwa kwa muda kwa huduma/mtandao | Tumia tena vitambulisho na data ileile, weka kikomo cha majaribio na kagua hali rasmi baada ya matokeo yasiyo na uhakika |
returns_paused | Uandishi wa urejeshaji haupatikani kwa muda | Jaribu baadaye kwa vitambulisho vilevile; usomaji bado unapatikana |
idempotency_key_invalid | Ufunguo wa kuunda unakosekana/ni mkubwa mno | Toa ufunguo thabiti usio tupu, upeo wa herufi 160 |
idempotency_conflict | Ufunguo umetumiwa tena kwa kitendo tofauti | Rejesha ombi la awali au tumia ufunguo kwa kitendo kipya kweli |
event_id_invalid | UUID inakosekana/ni tupu | Zalisha na hifadhi UUID moja kwa kila tukio |
occurred_at_invalid | Muda wa tukio wa baadaye | Sahihisha saa/muhuri wa muda; hifadhi muda halisi wa kutokea |
return_not_eligible | Hali ya shehena ya kwenda hairuhusu aina hii ya urejeshaji | Urejeshaji wa mteja unahitaji Delivered; RTS ya uwasilishaji ulioshindwa inahitaji DeliveryAttempted |
return_state_conflict | Mpito batili, utegemezi wa ushahidi au tukio linalokinzana | Soma hali rasmi na mahitaji ya ushahidi; sahihisha kabla ya kujaribu tena |
return_conflict | Sharti la urejeshaji wa wakati mmoja/kitambulisho | Soma urejeshaji wa sasa; usiunde kazi rudufu ya kimwili |
return_origin_invalid, return_destination_invalid | Nakala ya wakati huo inakosekana/ni batili | Toa sehemu halali za anwani iliyothibitishwa na viwianishi |
return_event_invalid | Data batili ya tukio | Sahihisha data kwa kutumia marejeleo ya API |
return_pickup_confirmation_not_allowed | Ufikiaji wa kuchukua hauruhusiwi katika hali ya sasa | Kagua hali ya idhini/makabidhiano kabla ya kutoa kiungo kipya |
return_proof_asset_missing | Rejeleo halielekezi kwenye faili ya urejeshaji iliyopakiwa | Pakia PNG kwanza yenye urejeshaji/ushahidi/aina zinazolingana; tumia rejeleo lililorudishwa |
return_proof_invalid, proof_image_invalid | Picha au sehemu za ushahidi ni batili | Sahihisha mbinu, kusudi, vipimo, ukubwa na muhuri wa muda |
return_proof_conflict | UUID ya ushahidi imetumiwa tena kwa maudhui tofauti | Jaribu ushahidi uleule tena; usibadilishe ushahidi usiobadilika |
return_destination_required | Sera ya RTS inahitaji mahali pa kwenda | Toa mahali pa mtumaji/mfanyabiashara palipokubaliwa |
Matatizo ya kawaida ya uunganishaji
Ufunguo ulionakiliwa unaanza na [object Object]: nakili kitambulisho tena kutoka dashibodi. Ufunguo hauna aikoni, markup au maandishi ya ziada ya kuonesha mwishoni. Sanidi thamani ghafi kamili.
Hali ya uwasilishaji haijasonga mbele baada ya kuwasilisha ushahidi: kagua usawazishaji wa ushahidi. Ruhusa ya delivery:proof ni tofauti na delivery:events. Ushahidi ulioshindwa huzuia tukio la ukamilishaji linaloutegemea. Rekebisha usanidi na ujaribu tena kitendo cha awali kwa vitambulisho vilevile.
Barua pepe yangu inalingana lakini kiungo cha mpokeaji hakifanyi kazi: hakiki kwamba mawasiliano rasmi ya shehena ni sahihi na mawasiliano ya akaunti yamethibitishwa. Mawasiliano yanayotumiwa kwa uthibitisho wa anwani pekee hayabadilishi umiliki wa shehena. Ufuatiliaji wa umma huonesha maendeleo, si idhini ya mpokeaji.
Hakuna chaguo la kurejesha: uwasilishaji lazima uunganishwe na uwe katika hali rasmi ya Delivered kabla ya urejeshaji wa mteja kuanza.
URL ya ushahidi wa urejeshaji imekataliwa: pakia PNG halisi kupitia API ya faili za urejeshaji. Sahihi ya maandishi au URL yoyote ya mfanyabiashara haitimizi mkataba huu.
Sahihi ya webhook inashindwa: hifadhi baiti ghafi, hakiki siri sahihi ya usajili, kagua usasa wa muhuri wa muda na uepuke kuunda upya JSON. Tazama mwongozo wa webhook.