DOXTSORBIT API

Gateway para bots de consulta (CC, TI, Nequi, placas, nombres, Telegram). Autenticación con X-API-Key.

GET /api/health — estado del gateway y backend

GET /api — lista JSON de endpoints

Endpoints

Método	Ruta	Body (JSON)
GET	/api/v1/nequi/consulta/{numero}	Nequi → CC → ficha completa (?key= opcional)
POST	/api/v1/nequi/consulta	{"numero":"3001234567"} (solo Nequi)
POST	/api/v1/cc/consulta	{"cedula":"1234567890"}
POST	/api/v1/ti/consulta	{"cedula":"1234567890"}
POST	/api/v1/sisben/consulta	{"cedula":"...","tipo":"CC"}
POST	/api/v1/total/consulta	{"cedula":"...","tipo":"CC"}
POST	/api/v1/placas/consulta	{"placa":"ABC123"}
POST	/api/v1/nombres/consulta	{"query":"JUAN PEREZ","page":0,"page_size":30}
POST	/api/v1/telegram/id	{"telegram_id":"8870305515"}
POST	/api/v1/telegram/user	{"username":"usuario"}

Health check

curl -s "https://doxtsorbit.pages.dev/api/health"

Respuesta cuando el gateway está arriba:

{"status":"ok","gateway":"doxtsorbit","backend":{...}}

Si el backend VPS no responde:

{"status":"degraded","gateway":"ok","backend":"unreachable"}

Ejemplo CC (POST)

curl -s -X POST "https://doxtsorbit.pages.dev/api/v1/cc/consulta" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: TU_API_KEY" \
  -d '{"cedula":"1234567890"}'

Ejemplo Nequi completa (GET)

curl -s "https://doxtsorbit.pages.dev/api/v1/nequi/consulta/3001234567" \
  -H "X-API-Key: TU_API_KEY"

Ejemplo Nequi (POST)

curl -s -X POST "https://doxtsorbit.pages.dev/api/v1/nequi/consulta" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: TU_API_KEY" \
  -d '{"numero":"3001234567"}'

Autenticación: header X-API-Key (te la entregamos por privado; no la publiques en la web).

Integra estos endpoints en tu bot de Telegram (o cualquier cliente HTTP) con el diseño y botones que quieras.