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>.