Documentación API

Volver al inicio

Cómo funciona la API de Orion

Orion permite resolver coordenadas geográficas con datos de identidad de celda usando una integración simple y robusta.

Uptime 99.95%Latencia media 120msVersion API v1
POST/api/v1/lookup

Este endpoint resuelve coordenadas geograficas a partir de identidad de celda. Orion busca usando solo los campos presentes en el body.

Base URL

https://api.orion.geminislabs.com/api/v1/

Headers requeridos

x-api-key: <tu-api-key>

Content-Type: application/json

Validacion de busqueda

Debes enviar al menos uno de estos campos:mccmnclaccid

El parametro include acepta solamente el valor "cell".

Requests

POST /api/v1/lookup
curl -X POST https://api.orion.geminislabs.com/api/v1/lookup \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mcc": 310,
    "mnc": 260,
    "lac": "F303",
    "cid": 5678,
    "include": ["cell"]
  }'

Busqueda parcial

{
  "lac": "F303"
}

Busqueda completa

{
  "mcc": 310,
  "mnc": 260,
  "lac": "F303",
  "cid": 5678,
  "include": ["cell"]
}

Responses

200 OKSin include
{
  "matches": [
    {
      "lat": 40.416775,
      "lon": -3.70379,
      "confidence": 1.0
    }
  ],
  "meta": {
    "request_id": "a1b2c3d4e5f6a7b8"
  }
}
200 OKCon include: ["cell"]
{
  "matches": [
    {
      "lat": 41.18549,
      "lon": -80.361315,
      "confidence": 1.0,
      "cell": {
        "mcc": 310,
        "mnc": 260,
        "lac": "F303",
        "cellid": "12345"
      }
    }
  ],
  "meta": {
    "request_id": "a1b2c3d4e5f6a7b8"
  }
}

Campos del body

CampoTipoRequeridoDescripcion
mccnumberNoMobile Country Code.
mncnumberNoMobile Network Code.
lacstringNoLocation Area Code en hexadecimal, ejemplo "F303".
cidnumberNoCell ID.
includearrayNoSolo acepta el valor ["cell"].

Como empezar

  • 1Crear cuenta y verificar mail
  • 2Generar API Key desde el dashboard de Geminislabs
  • 3Comienza a usar
Crear cuenta gratis

Registro en Geminislabs, toma menos de 1 minuto.

Buenas practicas

Envio minimo

Para reducir latencia, envia solo los campos disponibles en tu fuente.

Trazabilidad

Guarda meta.request_id en logs para depurar incidentes con soporte tecnico.

Resiliencia

Aplica timeout y reintentos con backoff para mantener la integracion estable.