> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ecorpa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Registrar URL de aviso

> PUT para registrar la URL donde quieres recibir el resultado cuando un lote termina. El secreto de firma sale una sola vez.

Registra la URL donde quieres recibir el resultado. Vale para todos los módulos. La respuesta trae `Data.Secreto` una sola vez.

Usa tu API Key. No necesitas un scope de un módulo.

<ParamField body="Url" type="string" required>
  HTTPS público, sin usuario ni contraseña. Se rechazan localhost, redes privadas y la metadata de la nube.
</ParamField>

<ResponseField name="Data.Url" type="string">
  URL guardada.
</ResponseField>

<ResponseField name="Data.Activa" type="boolean">
  `true` después de este PUT.
</ResponseField>

<ResponseField name="Data.Secreto" type="string">
  Secreto para verificar `X-Ecorpa-Signature`. No vuelve a salir en el GET.
</ResponseField>

<RequestExample>
  ```bash Request theme={"system"}
  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"}'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"system"}
  {
    "Success": true,
    "Message": "URL de notificación guardada. Guarde el secreto; no se volverá a mostrar.",
    "Data": {
      "Url": "https://integrador.example/ecorpa",
      "Activa": true,
      "Secreto": "…"
    }
  }
  ```

  ```json 400 theme={"system"}
  {
    "Success": false,
    "Message": "La URL de notificación debe usar HTTPS."
  }
  ```

  ```json 401 theme={"system"}
  {
    "Success": false,
    "Message": "No se pudo autenticar la solicitud."
  }
  ```

  ```json 403 theme={"system"}
  {
    "Success": false,
    "Message": "Este recurso solo está disponible mediante API key."
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.