Como empezar

Guarde la URL base y la API key fuera del código. En los ejemplos se usan variables de entorno.

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

Confirme que la key llega y corresponde a su empresa. Esta llamada no guarda datos.

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 recomendado para la primera prueba:

1. POST /cliente/sandbox/ping
2. POST /cliente/registros/validar (no escribe)
3. POST /cliente/registros o POST /cliente/registros/lote
4. GET /cliente/casos, luego coincidencias y reportes

El botón Try it de esta documentación llama la URL publicada en el contrato. Si esa URL es de laboratorio y no es alcanzable desde su navegador, use curl o el cliente HTTP de su integración contra la URL base que entregó Horus.