Factuarea API
Eventos

Listar tipos de evento

Lista el catálogo cerrado de tipos de evento que Factuarea puede emitir a los webhook endpoints. Úsalo para poblar una UI de suscripción en lugar de hardcodear los nombres de evento. Cada entrada expone su `name`, `category` (derivada del prefijo `<category>.*`), una `description` en español y un `status`: `available` significa que el tipo se emite hoy y puede suscribirse vía `enabled_events`; `coming_soon` significa que el tipo está reservado para una versión futura — se lista para descubrirlo pero NO es aún suscribible (pasarlo en `enabled_events` devuelve 422). El conjunto de tipos actualmente emitidos (`available`) es la fuente de verdad cerrada `EventName::CATALOG`.

GET
/event-catalog

Authorization

AuthorizationBearer <token>

En: header

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

application/json

{
  "data": [
    {
      "name": "string",
      "category": "string",
      "description": "string",
      "status": "string"
    }
  ]
}

{
  "error": {
    "type": "authentication_error",
    "code": "missing_api_key",
    "message": "No se ha proporcionado una API key válida en el header Authorization.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#missing_api_key",
    "request_id": "req_01HKQS5N8VR7QXJ9K3T6BWPMZA"
  }
}

{
  "error": {
    "type": "authorization_error",
    "code": "insufficient_scope",
    "message": "Esta API key no tiene el scope requerido para esta operación.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#insufficient_scope",
    "request_id": "req_01HKQS5NBC3P8M1KX4V7SLNHQD"
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Has excedido el rate limit de 60 peticiones por minuto. Reintenta tras 30 segundos.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#rate_limit_exceeded",
    "request_id": "req_01HKQS5NKW1C6W9T4G5H0JBZVL"
  }
}

{
  "error": {
    "type": "api_error",
    "code": "internal_error",
    "message": "Ha ocurrido un error inesperado. Si persiste, contacta con soporte adjuntando el request_id.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#internal_error",
    "request_id": "req_01HKQS5NLX2D7X0U5H6J1KCAWM"
  }
}

Actualizar un webhook endpoint

Actualiza un webhook endpoint (URL, descripción, eventos habilitados, estado, lista de acceso de IP).

Listar todos los eventos

Lista los eventos de tu registro de eventos con paginación por cursor. Cada evento registra algo que ocurrió en tu cuenta (se pagó una factura, se aceptó un presupuesto, …) y es el mismo objeto que se entrega a tus webhook endpoints. Admite filtrado por `type[in]` y `created[gte|lte]`.