API de Geotrackable

Comprobación de estado

Esta ruta es anónima y es la forma más rápida de confirmar que el host de API de producción responde.

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

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

Registro

Cree una cuenta local con correo electrónico, contraseña y nombre de usuario de perfil público antes de solicitar un token bearer. Los nombres de usuario solo pueden contener letras minúsculas, números y guiones bajos.

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

Inicio de sesión bearer

Use credenciales de cuenta local con cookies deshabilitadas cuando un script, una app o un cliente de API necesite un token 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..."
}

Cuenta actual y perfil

No existe un endpoint de perfil GET /api/account. Use el endpoint manage-info de identidad para los metadatos de la cuenta con sesión iniciada y las páginas de perfil del sitio web para la vista pública del perfil.

GET /api/account no es una ruta de lectura publicada.

GET /api/auth/manage/info devuelve detalles de identidad con sesión iniciada.

DELETE /api/account elimina permanentemente la cuenta actual.

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

Exploración y búsqueda pública

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

La búsqueda por secreto y QR puede crear una sesión activa al estilo del navegador. Conserve el almacén de cookies de la respuesta para llamadas posteriores de la sesión activa, proteja ese archivo como una credencial y elimínelo cuando ya no necesite la sesión.

Crear un rastreable

La solicitud recomendada omite secretCode. Un valor omitido, null, vacío o compuesto solo por espacios pide al servidor que genere el código. Un valor no vacío solicita ese código personalizado exacto después de las comprobaciones de normalización y disponibilidad.

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

Solicitar un código secreto específico

Envíe secretCode solo cuando el elemento ya tenga un identificador personalizado. Si el valor normalizado está disponible, el servidor lo respeta y devuelve HTTP 201. El código público generado es independiente y Geotrackable sigue asignándolo.

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

Los códigos personalizados no pueden superar los 32 caracteres y deben estar disponibles en todo el espacio de nombres de códigos públicos y secretos de rastreables. Los códigos que comienzan por GT, LN, TB, GK o GC están reservados para identificadores emitidos por el sistema o por el sitio de origen y no se pueden adoptar como códigos secretos personalizados de Geotrackable.

La respuesta de creación muestra los secretos una sola vez

Guarde de inmediato los valores secretCode y scanUrl devueltos. Las rutas posteriores de lista, detalle, búsqueda, comentario y recorrido no vuelven a revelar intencionalmente esas credenciales.

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

Acceso secreto activo

Después de que un navegador introduce un código secreto válido o una carga de escaneo, las rutas de sesión activa muestran lo que ese navegador puede volver a abrir actualmente.

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

Imagenes

Las lecturas de listas pueden ser anónimas cuando la página principal es segura para el público. Las rutas de carga y eliminación requieren autenticación 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"

Verificación de enlace externo

Verifique un enlace externo antes de guardarlo en una ubicación, equipo, rastreable o grupo de rastreables.

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

Reportes de contenido y errores

Use reportes para inquietudes sobre contenido de páginas públicas y errores para diagnósticos del cliente que soporte podría necesitar revisar.

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