trackable API Qaghmey

trackable Qagh reference

trackable problem-details responses stable machine-readable code value chel. client pagh developer pItlh nuq ta'nIS 'e' wuq DaneHchugh, free-form English textDaq ghelbe'taHvIS pagevam yIlo'.

problem-details 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
}

trackable Qagh Hoch problem-details payload 'oHbe'. code lookup misses success payload motlh { "found": false } cheghmoHtaH, vaj caller lookup UI ngeD pollaH.

Qagh ngoghmey

ngogh Dotlh leng motlh qech client QaHghach
trackable_not_found 404 activate, ghom management, yIQaw' routes target trackable tu'be' pagh mI'vamDaq DelchoHlaHbe'. tlhegh yIchoHqa', nejghach yIrunqa', qoj GUID yIQov.
trackable_comment_not_found 404 comment update or yIQaw' target trackable comment trackablevetlhDaq tu'be'qa'. refresh commentmey and yIteq the stale ui entry.
trackable_journey_stop_not_found 404 journey-stop yIQaw' journey stop tlhoblu'bogh trackablevetlhDaq tu'be'qa'. journey yIrenew je stale action affordance yIteq.
trackable_already_activated 400 POST /api/trackables/{trackableId}/activate callervetlh ghajwI' botlh ghajta'bogh trackable chu'moHqa' neH. load the current details page instead of repeating chu'moHghach.
trackable_activation_required 400 pong Hutlhbogh pagh sign-in rInbogh comment/journey-stop ghItlhmey itemvam chu'moHlu'pu'be'taH, vaj DaH commentmey chu' qoj route mIwmey lajlaHbe'. prompt an eligible signed-in ghajwI' to activate the trackable first.
trackable_access_code_required 403 anonymous commentmey and journey-stop writes caller sign-inbe' je trackablevetlhvaD active browser session pagh valid secret-backed access credential latlh ghajbe'. mach pegh ngogh chu' qoj QR token yItlhob; browservamDaq trackable yIpoltaH qoj sign-in yInob.
trackable_access_code_invalid 403 anonymous commentmey and journey-stop writes access credential noblu'bogh trackablevam chu' DelchoHbe'. caller yIja': ngogh latlh itemvaD 'oH pagh lughbe'lu'pu'.
trackable_group_detach_forbidden 403 DELETE /api/trackables/{trackableId}/group callervetlh wa'DIch chu'moHwI' ghaHbe'; DaH ghom botlhDaq admin lI' ghaHbe' je. grouped itemvetlh SeHtaHbogh user DaH yIlo'.
trackable_group_attach_forbidden 403 POST /api/trackables/{trackableId}/group trackable chImmoHlu'ta'boghvetlh ghom pImvaD rarmeH chaw'be'lu' caller. activator wa'DIchDaq pagh control context chaw'lu'boghDaq yIchegh.
trackable_comment_edit_forbidden 403 PUT /api/trackables/{trackableId}/comments/{commentId} authenticated comment yIchoHlaH neH ghItlhwI' Daq'ellu'ta'bogh. hide yIchoH controls for everyone else.
trackable_comment_delete_forbidden 403 comment yIQaw' caller'e' sign-in comment ghItlhwI' ghaHbe', moderation power ghajbogh owner/team admin ghaHbe' je. keep yIQaw' as a management-only action.
trackable_journey_stop_delete_forbidden 403 journey-stop yIQaw' caller'e' stopvetlh ghItlhwI' authenticated ghaHbe', owner/team admin ghaHbe' je. DaH user stopvetlh moderatelaHchu'chugh neH, stop deletion yIcha'.
trackable_journey_stop_convert_forbidden 403 website mojchoH mIw authenticated direct report chenmoHpu'bogh signed-in person neH noteDaq choHmoHlaH. anonymous stopmey qoj stops latlh-party ghItlhboghvaD convert mIwmey yIcha'Qo'.
trackable_journey_stop_convert_rejected 400 website mojchoH mIw stop tu'lu', 'ach note conversion tlhoblu'bogh stopvetlh notevetlh je botlh lughbe'. ghotvaD yIja': Daq wIvlu'ta'boghvo' note chu' yIchenmoH.
trackable_request_rejected 400 pagh 403 cheghqa'ghach trackable pab poQvam qIl, 'ach machine code pIm noblu'be'. human-readable detail text je route context nIteb yIlo'.

Separate taH place, history, access: snapped coordinate pol journey stop, editable recordDaj pol note, je note visibility required access scope je note content yIpoSlaHbogh mIw Del.

Journey reads saved stop je currentNotesAtCoordinate cha'ang. DaHjaj same coordinateDaq visible note read model ghaH collectionvam'e', reH wa' note lo'lu'bogh mI'na' 'oHbe'.

nejghach pujghachmey problem-details ghobe'

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

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

ngogh latlh live systemDaq toy'chu'chugh pagh bring-your-own flow lo'nISchugh, lookup payloadDaq origin site pagh single-trackable create pageDaq ghoSmoHbogh QaH link je tu'lu'laH.