Hugis ng mga detalye ng problema
{
"title": "Forbidden",
"code": "trackable_access_code_required",
"detail": "Sign in, keep this trackable active on this browser, or provide this trackable's secret code or QR access code before posting comments or location reports.",
"status": 403
}
Hindi lahat ng kabiguan na nauugnay sa trackable ay isang payload ng mga detalye ng problema. Ang mga nawawalang code lookup ay nagbabalik pa rin ng ordinaryong success payload na may { "found": false } para mapanatiling simple ng tumatawag ang lookup UI.
Mga error code
| Kodigo | Katayuan | Karaniwang ruta | Ibig sabihin | Patnubay ng kliyente |
|---|---|---|---|---|
trackable_not_found |
404 | I-activate, pamamahala ng pangkat, tanggalin ang mga ruta | Ang target na nasusubaybayan ay wala o hindi malulutas sa operasyong iyon. | I-refresh ang listahan, muling patakbuhin ang paghahanap, o kumpirmahin ang GUID. |
trackable_comment_not_found |
404 | I-update o tanggalin ang komento | Ang target na nasusubaybayang komento ay wala na sa nasusubaybayang iyon. | I-refresh ang mga komento at alisin ang lipas na entry sa UI. |
trackable_journey_stop_not_found |
404 | Paglalakbay-stop tanggalin | Ang hiniling na paghinto sa paglalakbay ay hindi na umiiral sa masusubaybayang iyon. | I-refresh ang paglalakbay at i-drop ang lipas na affordance ng pagkilos. |
trackable_already_activated |
400 | POST /api/trackables/{trackableId}/activate |
Sinubukan ng tumatawag na i-activate ang isang trackable na mayroon nang saklaw ng may-ari. | I-load ang kasalukuyang pahina ng mga detalye sa halip na ulitin ang pag-activate. |
trackable_activation_required |
400 | Anonymous o naka-sign-in na komento/journey-stop na nagsusulat | Hindi pa rin naka-activate ang item, kaya hindi pa ito makakatanggap ng mga bagong komento o aktibidad sa ruta. | I-prompt ang isang kwalipikadong naka-sign in na may-ari na i-activate muna ang trackable. |
trackable_access_code_required |
403 | Mga anonymous na komento at journey-stop na pagsusulat | Ang tumatawag ay hindi naka-sign in at wala ring aktibong sesyon ng browser o ibang wastong sikretong-backed na kredensyal sa pag-access para sa masusubaybayang iyon. | Humingi ng eksaktong maikling secret code o QR token, panatilihing aktibo ang trackable sa browser na ito, o mag-alok ng pag-sign in. |
trackable_access_code_invalid |
403 | Mga anonymous na komento at journey-stop na pagsusulat | Ang ibinigay na kredensyal sa pag-access ay hindi lutasin sa partikular na masusubaybayang ito. | Sabihin sa tumatawag na ang code ay kabilang sa isa pang item o nailagay nang hindi tama. |
trackable_group_detach_forbidden |
403 | DELETE /api/trackables/{trackableId}/group |
Ang tumatawag ay hindi ang orihinal na activator o isang karapat-dapat na admin ng grupo para sa kasalukuyang konteksto ng grupo. | Gumamit ng user na kasalukuyang kumokontrol sa nakagrupong item na iyon. |
trackable_group_attach_forbidden |
403 | POST /api/trackables/{trackableId}/group |
Ang tumatawag ay hindi pinapayagan na iugnay ang hiwalay na trackable na iyon sa ibang grupo. | Bumalik sa orihinal na activator o isang pinapayagang konteksto ng kontrol. |
trackable_comment_edit_forbidden |
403 | PUT /api/trackables/{trackableId}/comments/{commentId} |
Tanging ang naka-sign-in na may-akda ng isang napatotohanang komento ang makakapag-edit nito. | Itago ang mga kontrol sa pag-edit para sa lahat. |
trackable_comment_delete_forbidden |
403 | Tanggalin ang komento | Ang tumatawag ay hindi ang naka-sign-in na may-akda ng komento o isang may-ari/admin ng koponan na may kapangyarihan sa pag-moderate. | Panatilihin ang pagtanggal bilang isang pagkilos na pamamahala lamang. |
trackable_journey_stop_delete_forbidden |
403 | Paglalakbay-stop tanggalin | Ang tumatawag ay hindi ang napatotohanang may-akda ng stop na iyon o isang may-ari/admin ng team. | Ipakita lamang ang paghinto sa pagtanggal kapag ang kasalukuyang user ay maaari na talagang i-moderate ito. |
trackable_journey_stop_convert_forbidden |
403 | Daloy ng conversion sa website | Tanging ang naka-sign-in na tao na lumikha ng isang napatotohanang direktang ulat ang makakapag-convert nito sa isang tala. | Huwag magpakita ng mga pagkilos sa pag-convert para sa mga hindi nakikilalang o third-party-authored na paghinto. |
trackable_journey_stop_convert_rejected |
400 | Daloy ng conversion sa website | Umiiral ang stop, ngunit ang hiniling na conversion ng tala ay hindi wasto para sa stop o kumbinasyon ng note na iyon. | Hilingin sa user na gumawa ng bagong tala mula sa napiling lokasyon sa halip. |
trackable_request_rejected |
400 o 403 | Pamalit | Tinanggihan ng isang nasusubaybayang panuntunan ang kahilingan, ngunit wala nang mas partikular na machine code ang itinalaga. | Gamitin ang text ng detalyeng nababasa ng tao at ang konteksto ng ruta nang magkasama. |
Ang lugar, kasaysayan, at pag-access ay mananatiling hiwalay: pinapanatili ng paghinto ng paglalakbay ang naputol na coordinate, pinapanatili ng tala ang sarili nitong nae-edit na tala, at ang visibility ng tala kasama ang kinakailangang saklaw ng pag-access ang magpapasya kung sino ang makakapagbukas ng nilalaman ng tala.
Ang pagbabasa ng Paglalakbay ay inilalantad ang naka-save na paghinto kasama ang kasalukuyangNotesAtCoordinate. Ang koleksyon na iyon ay ang nakikitang note read model ngayon para sa parehong coordinate, hindi patunay na permanenteng nagmamay-ari ng isang note ang stop.
Ang mga miss sa paghahanap ay hindi mga detalye ng problema
{
"found": false,
"error": "Code not found."
}
Ang lookup na API ay sadyang gumamit ng success payload dito dahil inaasahan ang mga pagkakamali sa pag-type at karaniwang gustong manatili ng UI sa lookup mode sa halip na lumipat sa paghawak ng error.
Kapag malinaw na kabilang ang code sa isa pang live na system o dapat gumamit ng bring-your-own na daloy, ang lookup payload ay maaari ding magsama ng link ng tulong na tumuturo sa pinagmulang site o sa single-trackable na pahina ng paglikha.