Cómo empezar

PUI Gestión recibe registros de su institución y devuelve casos, coincidencias y reportes en JSON. Usted llama el API cuando lo necesita. No publica una API propia y no espera una sincronización programada.

Horus entrega dos datos, por un canal seguro:

Dato	Uso
URL base	Ya incluye el prefijo del ambiente. Las rutas empiezan en `/cliente`.
API key	Header `X-API-Key`. No use `Bearer`. Se muestra una sola vez.

Guarde ambos fuera del código.

export BASE_URL="https://url-que-entrega-horus"
export API_KEY="la-key-que-entrega-horus"

Primera llamada

Esta petición no guarda datos. Confirma que la key corresponde a su empresa.

curl -sS -X POST "$BASE_URL/cliente/sandbox/ping" \
  -H "X-API-Key: $API_KEY" \
  -H "Accept: application/json"

Una key válida responde 200 con ok: true y el nombre de la empresa. Sin header, o con una key revocada, responde 401.

Orden de la primera prueba

POST /cliente/sandbox/ping
POST /cliente/registros/validar (revisa el lote y no escribe)
POST /cliente/registros o POST /cliente/registros/lote
GET /cliente/casos, luego coincidencias y reportes

El cuerpo es application/json. No se envían archivos. Cada API key admite 120 peticiones por minuto.

El detalle de cada ruta está en API Reference. Try it llama https://api.pui360.mx desde el navegador. La URL base y la API key las entrega Horus; no pegue una key real en un repositorio.