API ng Geotrackable

Pagsuri ng status

Anonymous ang route na ito at ito ang pinakamabilis na paraan para tiyaking naaabot ang production API host.

curl "https://Geotrackable.com/api/system/status"

{
  "status": "online",
  "utcNow": "2026-06-20T12:00:00Z",
  "androidBetaPageUrl": "https://Geotrackable.com/en-US/Account/Beta"
}

Pagpaparehistro

Gumawa ng lokal na account gamit ang email, password, at pampublikong profile user name bago humiling ng bearer token. Ang mga user name ay maaaring maglaman lamang ng maliliit na titik, numero, at underscore.

curl -X POST "https://Geotrackable.com/api/auth/register" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "tester@example.com",
    "userName": "trail_tester",
    "password": "StrongP@ssw0rd!"
  }'

Pag-login gamit ang bearer token

Gumamit ng local account credentials na naka-disable ang cookies kapag kailangan ng script, app, o API client ng bearer token.

curl -X POST "https://Geotrackable.com/api/auth/login?useCookies=false&useSessionCookies=false" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "tester@example.com",
    "password": "StrongP@ssw0rd!"
  }'

{
  "tokenType": "Bearer",
  "accessToken": "eyJhbGciOi..."
}

Kasalukuyang account at profile

Walang GET /api/account profile endpoint. Gamitin ang identity manage-info endpoint para sa signed-in account metadata, at gamitin ang website profile pages para sa public profile display.

GET /api/account ay hindi published read route.

GET /api/auth/manage/info nagbabalik ng signed-in identity details.

DELETE /api/account permanenteng binubura ang kasalukuyang account.

curl "https://Geotrackable.com/api/auth/manage/info" \
  -H "Authorization: Bearer <access token>"

Public browse at lookup

curl "https://Geotrackable.com/api/trackables/public?contentLanguage=en-US"

curl -X POST "https://Geotrackable.com/api/trackables/lookup" \
  -c geotrackable.cookies \
  -H "Content-Type: application/json" \
  -d '{
    "code": "GT7F3K9"
  }'

Maaaring gumawa ng browser-style active session ang secret at QR lookup. Panatilihin ang cookie jar ng response para sa mga susunod na active-session call, protektahan ang file na iyon na parang credential, at burahin ito kapag hindi na kailangan ang session.

Gumawa ng trackable

Walang secretCode ang inirerekomendang request. Kapag inalis, null, empty, o puro whitespace ang value, hinihiling nito sa server na gumawa ng code. Kapag hindi empty ang value, kahilingan ito para sa eksaktong custom code na iyon pagkatapos ng normalization at availability checks.

curl -X POST "https://Geotrackable.com/api/trackables" \
  -H "Authorization: Bearer <access token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Scout trail coin",
    "description": "Move this coin along family-friendly trails.",
    "visibility": "AlwaysVisibleToEveryone",
    "activateImmediately": true
  }'

Humiling ng partikular na secret code

Ipadala lang ang secretCode kapag mayroon nang custom identifier ang item. Kung available ang normalized value, gagamitin ito ng server at magbabalik ng HTTP 201. Hiwalay ang generated public code at Geotrackable pa rin ang nagtatalaga nito.

curl -X POST "https://Geotrackable.com/api/trackables" \
  -H "Authorization: Bearer <access token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Existing event tag",
    "description": "Uses the identifier already printed on the tag.",
    "visibility": "VisibleOnceAccessed",
    "activateImmediately": true,
    "secretCode": "TAG42"
  }'

Hindi dapat lumampas sa 32 character ang custom codes at dapat available ang mga ito sa buong namespace ng public at secret trackable codes. Ang mga code na nagsisimula sa GT, LN, TB, GK, o GC ay nakalaan para sa mga identifier na inilabas ng system o ng pinagmulang site at hindi maaaring gamitin bilang custom na Geotrackable secret codes.

Isang beses lang ipinapakita ang secrets sa creation response

I-save agad ang ibinalik na secretCode at scanUrl. Sadyang hindi na muling inilalantad ng mga susunod na list, detail, lookup, comment, at journey route ang credentials na iyon.

HTTP/1.1 201 Created
{
  "trackableId": "13a2c0b1-582f-4a7b-92aa-16922f7bdb63",
  "heading": "Scout trail coin",
  "items": [
    {
      "trackableId": "13a2c0b1-582f-4a7b-92aa-16922f7bdb63",
      "name": "Scout trail coin",
      "publicCode": "GT-7F3K9Q",
      "secretCode": "GT8M2Q7V",
      "scanUrl": "https://geotrackable.com/trackable/<private-qr-token>",
      "qrPayload": "<private-qr-token>"
    }
  ]
}

Aktibong secret access

Pagkatapos magpasok ang browser ng valid secret code o scan payload, ipinapakita ng active-session routes kung ano ang kasalukuyang mabubuksan muli ng browser na iyon.

curl "https://Geotrackable.com/api/trackables/active" \
  -b geotrackable.cookies

curl -X POST "https://Geotrackable.com/api/trackables/active/13a2c0b1-582f-4a7b-92aa-16922f7bdb63/message" \
  -b geotrackable.cookies \
  -H "Content-Type: application/json" \
  -d '{
    "statusMessage": "Live hunt in progress"
  }'

Mga imahe

Maaaring anonymous ang list reads kapag public-safe ang parent page. Kailangan ng bearer auth para sa upload at delete routes.

curl "https://Geotrackable.com/api/images/trackables/13a2c0b1-582f-4a7b-92aa-16922f7bdb63"

curl -X POST "https://Geotrackable.com/api/images/trackables/13a2c0b1-582f-4a7b-92aa-16922f7bdb63" \
  -H "Authorization: Bearer <access token>" \
  -F "files=@trail-coin.jpg"

Pag-verify ng external link

I-verify ang external link bago ito i-store sa location, team, trackable, o trackable group.

curl -X POST "https://Geotrackable.com/api/external-links/verify" \
  -H "Authorization: Bearer <access token>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/trail-guide"
  }'

Content at error reports

Gamitin ang reports para sa public-page content concerns at errors para sa client-side diagnostics na maaaring kailangang suriin ng support.

curl -X POST "https://Geotrackable.com/api/compliance/reports" \
  -H "Content-Type: application/json" \
  -d '{
    "pageType": "Trackable",
    "contentType": "Trackable",
    "pageTitle": "Scout trail coin",
    "pageUrl": "https://Geotrackable.com/trackable/GT7F3K9",
    "pageReference": "GT7F3K9",
    "contentLabel": "Trackable page",
    "contentReference": "13a2c0b1-582f-4a7b-92aa-16922f7bdb63",
    "contentPreview": "Move this coin along family-friendly trails.",
    "reportTitle": "Outdated public link",
    "reportExplanation": "The linked trail guide now points somewhere unexpected."
  }'