tlha' Doch API Qaghmey

tlha' Doch Qagh reference

tlha' Doch Seng-De' responses stable machine-readable ngogh lo'lu'bogh De' chel. client pagh developer pItlh nuq ta'nIS 'e' wuq DaneHchugh, free-form English textDaq ghelbe'taHvIS navvam yIlo'.

Seng-De' mIw

{
  "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
}

tlha' Doch Qagh Hoch Seng-De' payload 'oHbe'. ngogh lookup misses Qapla' payload motlh { "found": false } cheghmoHtaH, vaj rItlhwI' lookup UI ngeD pollaH.

Qagh ngoghmey

ngogh Dotlh leng motlh qech client QaHghach
trackable_not_found 404 chu'moH, ghom SeHghach, yIQaw' Hemey target tlha' Doch tu'be' pagh mI'vamDaq DelchoHlaHbe'. tlhegh yIchoHqa', nejghach yIrunqa', qoj GUID yIQov.
trackable_comment_not_found 404 qID update pagh yIQaw' target tlha' Doch qID trackablevetlhDaq tu'be'qa'. refresh qIDmey je yIteq stale ui qonta'.
trackable_journey_stop_not_found 404 leng mevDaq yIQaw' leng mevDaq tlhoblu'bogh trackablevetlhDaq tu'be'qa'. leng yIrenew je stale action affordance yIteq.
trackable_already_activated 400 POST /api/trackables/{trackableId}/activate rItlhwI'vetlh ghajwI' botlh ghajta'bogh tlha' Doch chu'moHqa' neH. laD DaH De' nav instead bopbogh repeating chu'moHghach.
trackable_activation_required 400 pong Hutlhbogh pagh 'elmeH rInbogh qID/journey-stop ghItlhmey Dochvam chu'moHlu'pu'be'taH, vaj DaH qIDmey chu' qoj He mIwmey lajlaHbe'. prompt eligible 'elta'bogh ghajwI' meH chu'moH tlha' Doch first.
trackable_access_code_required 403 pongHa' qIDmey je leng mevDaq writes rItlhwI' 'elmeHbe' je tlha' DochvetlhvaD lI' web leghwI' poH qawlu'bogh pagh valid pegh-backed chaw' credential latlh ghajbe'. mach pegh ngogh chu' qoj QR token yItlhob; browservamDaq tlha' Doch yIpoltaH qoj 'elmeH yInob.
trackable_access_code_invalid 403 pongHa' qIDmey je leng mevDaq writes chaw' credential noblu'bogh tlha' Dochvam chu' DelchoHbe'. rItlhwI' yIja': ngogh latlh itemvaD 'oH pagh lughbe'lu'pu'.
trackable_group_detach_forbidden 403 DELETE /api/trackables/{trackableId}/group rItlhwI'vetlh wa'DIch chu'moHwI' ghaHbe'; DaH ghom botlhDaq loHwI' lI' ghaHbe' je. grouped Dochvetlh SeHtaHbogh lo'wI' DaH yIlo'.
trackable_group_attach_forbidden 403 POST /api/trackables/{trackableId}/group tlha' Doch chImmoHlu'ta'boghvetlh ghom pImvaD rarmeH chaw'be'lu' rItlhwI'. activator wa'DIchDaq pagh control context chaw'lu'boghDaq yIchegh.
trackable_comment_edit_forbidden 403 PUT /api/trackables/{trackableId}/comments/{commentId} toblu'bogh qID yIchoHlaH neH ghItlhwI' Daq'ellu'ta'bogh. hide yIchoH controls vaD everyone else.
trackable_comment_delete_forbidden 403 qID yIQaw' rItlhwI''e' 'elmeH qID ghItlhwI' ghaHbe', SeHnuDghach power ghajbogh ghajwI'/team loHwI' ghaHbe' je. keep yIQaw' as SeHghach-neH action.
trackable_journey_stop_delete_forbidden 403 leng mevDaq yIQaw' rItlhwI''e' mevDaqvetlh ghItlhwI' toblu'bogh ghaHbe', ghajwI'/team loHwI' ghaHbe' je. DaH lo'wI' mevDaqvetlh moderatelaHchu'chugh neH, mevDaq Qaw'ghach yIcha'.
trackable_journey_stop_convert_forbidden 403 web Daq mojchoH mIw toblu'bogh nIt ja'ghach chenmoHpu'bogh 'elta'bogh nuv neH noteDaq choHmoHlaH. pongHa' mevDaqmey qoj mevDaqmey latlh-party ghItlhboghvaD convert mIwmey yIcha'Qo'.
trackable_journey_stop_convert_rejected 400 web Daq mojchoH mIw mevDaq tu'lu', 'ach QIn conversion tlhoblu'bogh mevDaqvetlh QInvetlh je botlh lughbe'. ghotvaD yIja': Daq wIvlu'ta'boghvo' QIn chu' yIchenmoH.
trackable_request_rejected 400 pagh 403 cheghqa'ghach tlha' Doch pab poQvam qIl, 'ach machine ngogh pIm noblu'be'. human-readable QIjmeH De' text je He context nIteb yIlo'.

Separate taH place, history, chaw': snapped Quv pol leng mevDaq, editable recordDaj pol QIn, je QIn leghlaHghach poQlu'bogh chaw' laH je QIn ngaSbogh Dochmey yIpoSlaHbogh mIw Del.

leng reads polta'bogh mevDaq je currentNotesAtCoordinate cha'ang. DaHjaj same coordinateDaq leghlaHbogh QIn laD model ghaH collectionvam'e', reH wa' QIn lo'lu'bogh mI'na' 'oHbe'.

nejghach pujghachmey Seng-De' ghobe'

{
  "found": false,
  "error": "Code not found."
}

lookup API intentional Qapla' payload naDev lo', typing mistakes lu'lojlhtaHmo' je UI lookup modeDaq ratlh neH law', Qagh handlingDaq choHbe'.

ngogh latlh QaptaHbogh systemDaq toy'chu'chugh pagh SoH ngogh flow lo'nISchugh, lookup payloadDaq origin web Daq pagh single-tlha' Doch chenmoH pageDaq ghoSmoHbogh QaH rarwI' je tu'lu'laH.