Avisos al terminar

​

Registrar la URL

curl -sS -X PUT "https://apis.ecorpa.com/v2/notificaciones" \
  -H "Authorization: Bearer ecorpa_key_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"Url":"https://integrador.example/ecorpa"}'

​

Reglas

• Una sola URL, para todos los módulos.
• La URL es HTTPS, sin usuario ni contraseña en la dirección, y tiene que resolver a una IP pública.
• El aviso llega al cerrar el lote, en éxito y en error.
• Data es el mismo objeto del GET de ese módulo.
• En afiliaciones, cuando una consulta de certificados cambia el estado de alguien, llega otro aviso del mismo IdSolicitud. Data.Registros trae solo esas personas, con JobId y el EstadoEntidad nuevo. Quien sigue en radicado no va. El mensaje es Actualización de certificados.
• Responde 2xx para confirmar que lo recibiste.
• Un 4xx distinto de 408 y 429 no se reintenta.
• Fallos de red, 408, 429 y 5xx se reintentan con espera creciente (5 s, 10 s, 20 s, 40 s). A la quinta vez se deja de intentar.
• X-Ecorpa-Delivery se repite en los reintentos del mismo aviso. Úsalo para no procesarlo dos veces.
• El GET de estado sigue disponible. Espera al menos 10 segundos entre dos consultas del mismo IdSolicitud. Puedes hacer como máximo 30 GET por minuto. Si pasas el límite, la respuesta es 429 y Retry-After indica los segundos de espera.

{
  "Modulo": "formularios_afiliacion",
  "IdSolicitud": "<uuid>",
  "Success": true,
  "Message": "Consulta de solicitud recuperada.",
  "Data": {}
}

​

Seguridad

• Registrar, consultar y apagar la URL exige tu API Key (Authorization: Bearer ecorpa_key_…).
• La URL no puede ser HTTP, localhost, una red privada ni la dirección de metadata de la nube. Tampoco se siguen redirecciones.
• El secreto no vuelve a salir en el GET.
• Cada POST trae X-Ecorpa-Signature: sha256= más el HMAC-SHA256 del cuerpo crudo, calculado con ese secreto. Firma los bytes que recibes, sin volver a serializar el JSON.
• El aviso espera como máximo 8 segundos. Si tu servidor no responde, el lote igual termina.