Geotrackable API pat

tlha' Doch ra'lu'boghvaD Daq yIchenmoH

wa' mIwDaq full Daq QIn je tlha' Doch leng mevDaq je atomically chenmoH routevam. chu'moHlu'ta'nIS tlha' Doch, 'ej nIteb ghajwI'Daj pagh owning team active admin ghaHnIS bearer-token account'e'. team tlha' DochvaD ghom rapDaq QIn chenmoHlu'.

curl -X POST "https://Geotrackable.com/api/trackables/<TRACKABLE_ID>/notes" \
  -H "Authorization: Bearer <access token>" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Dropped off at spot #1",
    "body": "Left near the park.",
    "contentLanguage": "en-US",
    "latitude": 41.8827,
    "longitude": -87.6233,
    "visibility": "Private",
    "commentPolicy": "Disabled"
  }'

{
  "trackableId": "13a2c0b1-582f-4a7b-92aa-16922f7bdb63",
  "journeyStopId": "3a223d33-5442-4cf7-84a1-3d937a253f30",
  "note": {
    "noteId": "26f84cdd-02e7-4c18-a153-f2754418f435",
    "title": "Dropped off at spot #1",
    "body": "Left near the park.",
    "latitude": 41.8827,
    "longitude": -87.6233
  },
  "message": "Location note created and added to the trackable journey."
}

outcome Sovbe'lu'bogh timeout qaSpu'DI' POST yIngeHqa'Qo'; Qob. yInIDqa'pa', tlha' Doch leng je DaqmeylIj je tIrefresh, vaj duplicate QIn je mevDaq je chenmoHbe' client.

pegh access pagh active-session access DaghajDI' Daq yIrar

tlha' Doch ra'be'bogh tu'wI' cha' calls lo'nIS: wa'DIch Daq motlh chenmoH, responsevetlhvo' noteId laD, vaj pegh ngoghDaj lo'taHvIS wa' tlha' Doch chu'moHlu'ta'bogh rar. cookie-backed browser session rapDaq active trackablesvaD neH selectedActiveTrackableIds lo'lu'.

curl -X POST "https://Geotrackable.com/api/public/notes/<NOTE_ID>/trackables" \
  -H "Authorization: Bearer <access token>" \
  -H "Content-Type: application/json" \
  -d '{
    "trackableSecretCodes": "<TRACKABLE_SECRET_CODE>"
  }'

property pong plural 'oHtaH trackableSecretCodes'e', 'ach tlhobghach HochDaq wa' ngogh neH laj. Quvmey ghajnIS QIn, 'ej chu'moHlu'ta'nIS tlha' Doch. latlh tlha' Doch rarmeH association request yIngeHqa'.

Quvmey ghajbogh lightweight leng pointvaD, 'ach pong, body, Segh, full Daq QIn je Hutlhbogh, POST /api/trackables/{trackableId}/journey-stops yIlo'.

code tlhoblu'bogh ghajlu'ta'DI'

custom code latlh ghajlu'chugh, code trackable_secret_code_taken ghajbogh HTTP 409 chegh. trackable chenmoHbe' tlhobghachvam. value rap yInIDqa'taHQo': code chenmoHlu'bogh HevmeH secretCode yIchelQo', pagh custom code pIm chaw'lu'bogh yIwIv.

{
  "type": "/en-US/api-docs#errors-and-problem-details",
  "title": "Requested secret code is unavailable.",
  "status": 409,
  "detail": "That secret code is already in use by another Geotrackable identifier. Supplying a secret code is optional: omit it to receive a unique system-generated code, or choose a different code.",
  "instance": "/api/trackables",
  "code": "trackable_secret_code_taken",
  "field": "secretCode",
  "action": "Omit secretCode to receive a unique system-generated code, or submit a different allowed secretCode.",
  "requestId": "0HN7EXAMPLE:00000001",
  "documentation": "/en-US/api-docs#errors-and-problem-details"
}

prefix pollu'bogh Qapqa'meH mIw

• GT Geotrackable system-issued codesvaD pollu'. secretCode yIchelQo'; wa' code nobjaj hostvam.
• LN LocationNotes trackable code 'oH; naDev code Dalo'qa'pa', origin siteDaq item yIta'.
• TB Geocaching.com trackable code 'oH; origin tracking flow yIlo'.
• GK GeoKrety.org trackable code 'oH; origin tracking flow yIlo'.
• GC Geocaching.com geocache identifier 'oH; Geotrackable secret code 'oHbe'.

problem jangghach action documentation link je ghajbogh nob custom values pollu'bogh pagh lughbe'bogh. reH QobHa' fallback: create requestvo' secretCode yIteq.

journey stop yIlog

full location note poQbe'lu'DI', direct journey stop 'oH route update tIS.

curl -X POST "https://Geotrackable.com/api/trackables/13a2c0b1-582f-4a7b-92aa-16922f7bdb63/journey-stops" \
  -H "Content-Type: application/json" \
  -d '{
    "latitude": 41.8818,
    "longitude": -87.6231,
    "accessCode": "GT-SECRET-OR-SCAN-PAYLOAD"
  }'

trackableDaq comment yIghItlh

bearer identity lo'taHvIS comment ghItlhlaH signed-in callers. active secret-backed session ghajDI' clientvam pagh itemvam naQ accessCode ngeHDI', trackable chu'lu'boghDaq comment ghItlhlaH je anonymous callers.

curl -X POST "https://Geotrackable.com/api/trackables/13a2c0b1-582f-4a7b-92aa-16922f7bdb63/comments" \
  -b geotrackable.cookies \
  -H "Content-Type: application/json" \
  -d '{
    "body": "Found near the overlook and moved west.",
    "accessCode": ""
  }'

field names ngaS validation errors

errors object chel HTTP 400 validation QapHa'ghachmey. JSON property pagh tlhobghach area lughmoHnISbogh 'oH key Hoch'e'; rule law' bIvlaH field wa' vaj array 'oH value Hoch'e'.

{
  "type": "/en-US/api-docs#errors-and-problem-details",
  "title": "Request validation failed.",
  "status": 400,
  "detail": "One or more request fields are invalid. Correct every field listed in errors and submit the request again.",
  "instance": "/api/trackables",
  "code": "validation_failed",
  "action": "Correct every field listed in errors and submit the request again.",
  "requestId": "0HN7EXAMPLE:00000003",
  "documentation": "/en-US/api-docs#errors-and-problem-details",
  "errors": {
    "name": ["Name cannot be longer than 160 characters."],
    "secretCode": ["Secret code cannot be longer than 32 characters."]
  }
}

JSON Qagh je content type

JSON lughbe' 'oH request validation QapHa'ghach'e'. requestId yIpol, syntax yIlughmoH, 'ej Content-Type: application/json lo'taHvIS body yIngeHqa'. file-upload endpointsvaD multipart/form-data poQlu' 'ej route-specific field name ghajbogh files pagh file part poQlu'.

syntax lugh ghajlaH body, 'ach business rule lajbe'laH. field QaghmeyvaD errors yIlo'; program logicvaD code; contextvaD detail; mIw vebvaD action. server exception tlhol pagh stack trace lo'wI'pu'vaD yI'angQo'.

chIch writes yInIDqa'

motlh GET tlhobghachmey nIDqa'lu'chugh QobHa'. jangghach Hevpa' client time outchugh, De' chenmoHlaHtaH POST. trackable chenmoHghach Daruchqa'pa', GET /api/trackables/mine yIchu'qa' 'ej result yIrapmoH, vaj duplicate physical items chenmoHbe' network timeout.

HTTP 429 pagh ru'bogh 500 qaSDI', jitter ghajbogh exponential backoff veHlu'bogh yIlo'. tlhobghach'e' choHnISlu' jatlhDI' action, yImev. 400, 403, 404, 405, 409, 413, pagh 415 automatic retry loop yImojmoHQo'.

credentials 'angbe'taHvIS diagnostics lI' yIpol

Authorization headers yIQonoSQo'; bearer pagh refresh tokens, mu'mey pegh, cookies, secretCode, accessCode, QR payloads, scan URLs pegh, pagh /trackable/{code} 'elmeH paths tlhol je yIQonoSQo'. telemetry, QapHa'ghach ja'meH De', jIH mIlloghmey, QaH chelbogh De' jevaD ngeHlu'pa' bIH yISo'.

diagnostic De' QobHa' ngaS requestId, ticketNumber, HTTP status, code choHbe'bogh, method, route template, client version, timestamp je. Daq ghItlh, coordinates naQ, rI' De', pagh trackable credential ngaSlaHchugh request body naQ yIcopyQo'.

POST /api/trackables -> 409
code=trackable_secret_code_taken
requestId=0HN7EXAMPLE:00000001
secretCode=[REDACTED]