Registro de llamadas al webhook

GET/api/v1/account/webhook/requests

Cada llamada que factuROA hizo al webhook por los eventos de la cuenta: URL, cabeceras y cuerpo enviados, y código, cabeceras y cuerpo de la respuesta (hasta 64 KB enviados y 4 KB recibidos), con el error si no llegó y la duración. Más reciente primero; se conserva 3 meses. Una casa de software ve las de un cliente con Facturoa-Account.

Parámetros de consulta

document_idstring · uuid
eventstring
Ejemplo: document.accepted
limitinteger
máximo 200, por defecto 50.
cursorstring
next_cursor de la página anterior

Respuestas

200OK

itemsarray<object>
+ Ver 14 campos− Ocultar 14 campos
- idstring · uuid
- account_idstring · uuid
- endpoint_account_idstring · uuid
  Dueña del webhook (la casa de software si es un cliente)
- document_idstring · uuid
- eventstring
  Ejemplo: document.accepted
- urlstring
- request_headersobject<string, string>
- request_bodystring
- response_statusinteger
  0: sin respuesta (error de red o tiempo agotado)
  Ejemplo: 204
- response_headersobject<string, string>
- response_bodystring
- errorstring
- duration_msinteger
  Ejemplo: 180
- created_atstring · date-time
next_cursorstring

400Datos inválidos (details trae los campos)

codestring
Ejemplo: error.document.invalid
messagestring
errorsarray<object>
Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)
+ Ver 2 campos− Ocultar 2 campos
- fieldstring
  Ruta del campo en el JSON enviado
  Ejemplo: lines[0].quantity
- messagestring
  Ejemplo: Cantidad inválida: debe ser mayor que cero.
detailsarray<string>
Rutas de los campos inválidos (compatibilidad; usa errors)
request_idstring

401Falta la key o es inválida, está deshabilitada, vencida o revocada (error.missing_api_key, error.invalid_api_key, error.api_key.disabled, error.api_key.expired, error.api_key.revoked)

codestring
Ejemplo: error.document.invalid
messagestring
errorsarray<object>
Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)
+ Ver 2 campos− Ocultar 2 campos
- fieldstring
  Ruta del campo en el JSON enviado
  Ejemplo: lines[0].quantity
- messagestring
  Ejemplo: Cantidad inválida: debe ser mayor que cero.
detailsarray<string>
Rutas de los campos inválidos (compatibilidad; usa errors)
request_idstring