Errores y límites

Los errores son predecibles: siempre el mismo envelope, siempre un código de máquina y un mensaje humano.

Formato

401

{
  "error": {
    "code": "invalid_api_key",
    "message": "API key inválida o revocada."
  }
}

Códigos

Parámetro	Tipo	Descripción
`missing_api_key`	401	No llegó ninguna key en el request.
`invalid_api_key`	401	La key no existe o fue revocada.
`insufficient_scope`	403	La key no tiene el scope del endpoint.
`invalid_type / invalid_url / invalid_events`	400	Parámetros mal formados.
`instrument_not_found / account_not_found / webhook_not_found`	404	El recurso no existe (o pertenece a otra ALyC).
`internal_error`	500	Error nuestro. Reintentá; queda logueado y monitoreado.

Rate limits

La demo no aplica límites. En producción cada key tiene un límite por minuto según su plan, con headers x-ratelimit-remaining y respuesta 429 rate_limited al superarlo. El diseño de planes está en el documento de negocio.

Estado del servicio

GET /api/health (readiness con chequeo de base) y GET /api/v1/status (contadores del lake) son públicos y sirven para monitorear la plataforma.