API Geotrackable

Перевірка стану

Цей маршрут анонімний і є найшвидшим способом підтвердити, що робочий хост API доступний.

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

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

Реєстрація

Створіть локальний обліковий запис з електронною поштою, паролем та ім’ям користувача публічного профілю, перш ніж запитувати bearer-токен. Імена користувачів можуть містити лише малі літери, цифри та підкреслення.

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!"
  }'

Bearer-вхід

Використовуйте облікові дані локального облікового запису з вимкненими cookie, коли скрипту, застосунку або API-клієнту потрібен bearer-токен.

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

Поточний обліковий запис і профіль

Кінцевої точки профілю GET /api/account немає. Використовуйте кінцеву точку identity manage-info для метаданих облікового запису користувача, який увійшов, а сторінки профілю сайту - для публічного відображення профілю.

GET /api/account не є опублікованим маршрутом читання.

GET /api/auth/manage/info повертає дані ідентичності користувача, який увійшов.

DELETE /api/account остаточно видаляє поточний обліковий запис.

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

Публічний перегляд і пошук

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

Пошук за секретним кодом або QR може створити активний сеанс на зразок браузерного. Збережіть сховище файлів cookie з відповіді для подальших викликів активного сеансу, захищайте цей файл як облікові дані та видаліть його, коли сеанс більше не потрібен.

Створити трекер

У рекомендованому запиті secretCode пропущено. Пропущене значення, null, порожній рядок або лише пробіли вказують серверу згенерувати код. Непорожнє значення запитує саме цей користувацький код після нормалізації та перевірки доступності.

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

Запит певного секретного коду

Надсилайте secretCode лише тоді, коли предмет уже має користувацький ідентифікатор. Якщо нормалізоване значення вільне, сервер приймає його й повертає HTTP 201. Згенерований публічний код є окремим і все одно призначається Geotrackable.

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

Користувацькі коди мають містити не більше 32 символів і бути вільними в усьому просторі публічних і секретних кодів трекерів. Коди, що починаються з GT, LN, TB, GK або GC, зарезервовано для системних ідентифікаторів або ідентифікаторів сайтів походження; їх не можна використовувати як користувацькі секретні коди Geotrackable.

Відповідь на створення — одноразове розкриття

Негайно збережіть повернуті secretCode і scanUrl. Подальші маршрути списку, відомостей, пошуку, коментарів і подорожі навмисно не розкривають ці облікові дані знову.

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

Активний секретний доступ

Після введення браузером дійсного секретного коду або сканованого навантаження маршрути активної сесії показують, що цей браузер зараз може відкрити повторно.

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

Зображення

Читання списків може бути анонімним, коли батьківська сторінка безпечна для публічного доступу. Маршрути завантаження й видалення потребують bearer-автентифікації.

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"

Перевірка зовнішнього посилання

Перевірте зовнішнє посилання перед збереженням його в локації, команді, трекері або групі трекерів.

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

Звіти про вміст і помилки

Використовуйте звіти для питань щодо вмісту публічних сторінок і помилок клієнтської діагностики, які може знадобитися переглянути підтримці.

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