trackable API mIw

trackable mIw QonoSta'bogh

nuv wa' trackable SamDI', secret-access flowDaq pawDI', sign-in ta'DI', ghIq ownership law' qoj note-backed stop workflow lo' neHchugh 'ach direct-report option QatlhHa' botlh Qaw'be' neHchugh, paqvam yIlo'.

mIw yItlhej API docs wa'DIch mIw anonymous Qagh reference

mIwvam yIlo'meH poH

mIwvam nIv law' ownership taHbogh, commentmey choHlaHbogh, note choHmoH, moderation HoS, pagh pItlh cheghqa'taHvIS postedpu'bogh SeH DaneHbogh nuvpu'vaD. nuvvetlh login pa' pegh ngogh pagh QR tokenvo' taghlaH, 'ach authenticateDI' access ngogh Hoch write botlh ngeHqa'nISbe'.

mIw 1: Doch tu'lu'bogh yIcher

short website entry route reH /trackable/{code} 'oH. API clients token directly resolve-laH je.

POST https://www.locationnotes.com/api/trackables/lookup
Content-Type: application/json

{
  "code": "LN4C8R2Z"
}

{
  "found": true,
  "trackableId": "f3a8f841-20db-4f1e-a3f8-9f14bc0b3c31",
  "isPublicCodeMatch": false,
  "usesSecretAccess": true,
  "redirectUrl": "/en-US/trackables/active/f3a8f841-20db-4f1e-a3f8-9f14bc0b3c31"
}

usesSecretAccess true 'oHchugh, browservam trackablevetlhvaD active pegh-backed session ghaj. sessionvetlh sign-in rapbe' je user wa'DIch trackable workflow tlhejtaHmeH neH chenmoHlu'.

mIw 2: session payload taHbogh yIlaD

GET https://www.locationnotes.com/api/trackables/active/{trackableId}

clientvaD SovmoH: chu'moHghach poQtaH'a', item ghomDaq chel'a', je sign-in pIq chu'moH context nuq tu'lu'.

mIw 3: bIQonoS 'ej poQDI' yIchu'moH

item chu'moHlu'be'taHchugh, bI'el 'ej ghajwI' nIteb qoj teamvaD yIchu'moH.

POST https://www.locationnotes.com/api/trackables/{trackableId}/activate
Authorization: Bearer <access token>
Content-Type: application/json

{
  "name": "",
  "description": "",
  "statusMessage": "",
  "useGroupDefaultTitle": true,
  "useGroupDefaultDescription": true,
  "useGroupDefaultStatusMessage": true,
  "teamId": null,
  "externalLinkUrl": "",
  "externalLinkDescription": "",
  "useGroupDefaultExternalLink": true,
  "initialJourneyStopLatitude": 47.6205,
  "initialJourneyStopLongitude": -122.3493
}

item ghomvo' ghoSchugh, chu'moHghachDaq item-level identity qav wI'ol. clients explicit name, description, je statusMessage values noblaH qoj blank poltaHvIS useGroupDefaultTitle, useGroupDefaultDescription, je useGroupDefaultStatusMessage lulo'laH, activated itemDaq ghom defaults DaHtaHbogh polmeH.

chu'moHghach location wa'DIch SIbI' chenmoHnISchugh, clients <code>initialJourneyStopLatitude</code> je <code>initialJourneyStopLongitude</code> chellaH.

mIw 4: simple logging path je rich logging path botlh yIwIv

authenticatelu'DI' pIqaD, client lightweight direct-report path pagh note path botlh law' lo'taHlaH. cha' pathmeyvam complementary 'oH; mutually exclusive 'oHbe'.

ngeD mIw: POST /api/trackables/{trackableId}/journey-stops lo'taHvIS direct journey stop yIchenmoH.
nItlh path: notevetlh yIchenmoH 'ej trackablevetlh notevetlhDaq yIrar naDev POST /api/public/notes/{noteId}/trackables.
website-only conversion path: signed-in user direct location-only stopDaj noteDaq pItlh choHlaH, route segment duplicatedmoHbe'taHvIS.

step 5a: yIpol a direct journey stop

POST https://www.locationnotes.com/api/trackables/{trackableId}/journey-stops
Authorization: Bearer <access token>
Content-Type: application/json

{
  "latitude": 41.8819,
  "longitude": -87.6278
}

stop polta'bogh immutable logistics snapshot 'oH. linked note pItlh movechoHchugh, journey coordinate snapped wa'DIch poltaH, vaj route history peghchoHtaHvIS choHbe'.

step 5b: yIchenmoH a note and attach the trackable

POST https://www.locationnotes.com/api/notes/mine
Authorization: Bearer <access token>
Content-Type: application/json

{
  "categoryId": "4de6bb76-f25d-4c73-b8e3-81b9ca3bf08f",
  "title": "North lobby handoff",
  "body": "Visible as a note and as a trackable stop.",
  "latitude": 41.8818,
  "longitude": -87.6231,
  "visibility": "Private"
}

POST https://www.locationnotes.com/api/public/notes/{noteId}/trackables
Authorization: Bearer <access token>
Content-Type: application/json

{
  "trackableSecretCodes": "LN4C8R2Z"
}

saving noteDaq trackable Dararchugh, poHvamDaq journey-stop snapshot je qonlu'. note-backed stopvetlh'e' note map point choHqa'chugh trackable path Hub.

note attachment je note required access scope trackable'e' nob je. place history pol stop, 'ach note visibility scope rules'e' note access SeHtaH.

mIw 6: user QonoSta'bogh DaH yIcomment

POST https://www.locationnotes.com/api/trackables/{trackableId}/comments
Authorization: Bearer <access token>
Content-Type: application/json

{
  "body": "Picked up and moving again."
}

trackable commentmey chenbogh signed-in ghItlhwI' neH editlaH. ghajwI'pu' je team adminpu' DaH taHbogh commentmey qoj journey stops Qaw'laH, 'ach latlh mu'mey chu'laHbe'.

step 7: read the complete route and commentmey

GET https://www.locationnotes.com/api/trackables/{trackableId}/journey
GET https://www.locationnotes.com/api/trackables/{trackableId}/comments

journey De'ghom chronologically HablI'lu'ta' je mapvaD qanglu'ta'. stopvetlh note peghvo' ghertlhu'chugh, leghwI' poSlaHbe'chugh je, API location point cha'laHtaH 'ach note De' Hubta'bogh lanbe'.

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'.

Qapghach ghItlhmey

simple over-map mIw neHchugh signed-in user, yIlo'laHmoH. authentication Qatlh yIteq, UI latlh yIpoQQo'.
user je team exportmey DaH trackable journey stopmey, note-backed stop history, je trackable commentmey ghaj.
wa' account Qaw'lu'chugh, latlhpu' pagh team qunDaj lo'taHchugh, trackable naQ automatic Qaw'lu'be'.

reference'mey botlh: nuq 'oH trackable'e'?, trackable mIw anonymous, je trackable Qagh reference.