Skip to main content
Eventos, firma y reintentos: Webhooks (REST). Formato de endpoint en las salidas: líneas - ID, - URL, - Descripción, - Eventos, - Activo, - Secreto.

registrarWebhook

Salida: Webhook registrado: + endpoint con el secreto en claro, una sola vez. Error: Error registrando webhook: <mensaje> (URL no https, destino no permitido, tipo de evento desconocido).

listarWebhooks

Sin parámetros. Salida: Webhooks (<n>): + un bloque por endpoint (secreto enmascarado), o No hay endpoints de webhook registrados.

verWebhook

Salida: Webhook: + endpoint (secreto enmascarado). Error: Error obteniendo webhook: <mensaje>.

actualizarWebhook

Campos vacíos = sin cambio. Salida: Webhook actualizado: + endpoint. Error: Error actualizando webhook: <mensaje>.

eliminarWebhook

Salida: Webhook eliminado. Error: Error eliminando webhook: <mensaje>. Las entregas ya realizadas quedan en el historial.

rotarSecretoWebhook

Salida: Secreto rotado para el webhook <id> + el nuevo secreto, una sola vez. El anterior deja de validar de inmediato. Error: Error rotando secreto: <mensaje>.

listarEntregasWebhook

Salida: Entregas (<n>): + por entrega - ID, - Evento: <tipo> (<eventId>), - Estado: <estado> | intentos: <i>/<max>, - Último código HTTP, - Último error, - Próximo intento, - Entregado; o No hay entregas registradas para ese endpoint. Último error es genérico: HTTP <código>, No se pudo conectar con el endpoint o no respondió a tiempo, Destino del webhook no permitido, Endpoint inactivo o eliminado (significado).

reenviarEntregaWebhook

Salida: Re-entrega encolada: + detalle de la entrega. Error: Error re-encolando entrega: <mensaje>.