HTTP DELETE

Tipo: http-delete · Paquete: HTTP Activities v1.0.5 · Salida: ZoanHttpResponse

Envía una petición DELETE para eliminar un recurso de una API. La URL identifica el recurso a borrar (normalmente con su id). No envía cuerpo.

Cómo funciona

Hace la petición DELETE a la url (con cabeceras y autenticación opcionales) y devuelve un ZoanHttpResponse.

Códigos de respuesta: con 2xx termina bien; cualquier otro código hace fallar la actividad — ver qué códigos hacen fallar la actividad. Ojo: muchas APIs responden 404 si el recurso ya se había borrado, así que un segundo DELETE del mismo id suele fallar.
Tiempos: 30 s para conectar y, por defecto, 5 min para la petición completa (parámetro timeout). Si se agotan, la actividad falla con un error normal que Try / Catch y Retry capturan — ver tiempos de espera.
Sin cuerpo: si la API exige un cuerpo en el DELETE, esta actividad no lo envía.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`url`	`string`	—	URL absoluta del recurso a eliminar.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`headers`	`Dictionary`	—	Cabeceras extra (nombre → valor), en el editor JSON. Ver cabeceras.
`authorization`	`Dictionary`	—	Autenticación en el editor JSON: `bearer`, `basic` o `apikey`. Ver autenticación.
`timeout`	`int`	`300`	Segundos que se espera la petición completa (conexión, envío y respuesta); máximo `3600`, admite decimales (`0.5`). Desde la versión 1.0.5. Ver tiempos de espera.

Salida

Devuelve un ZoanHttpResponse con .StatusCode (2xx), .Ok (siempre true en una salida recibida), .Body y .Headers. Muchas APIs devuelven 204 (sin contenido) cuando la eliminación tiene éxito; en ese caso .Body es "".

Errores comunes

Mensaje	Causa y solución
`El servidor respondió HTTP 404 (Not Found) a la solicitud DELETE.`	El recurso no existe (o ya se eliminó), o el servidor respondió con otro código fuera de 2xx (401/403, 409, 5xx). Si “ya no existe” te sirve como éxito, captúralo con Try / Catch y revisa `error.Message.Contains("HTTP 404")`.
`No such host is known.` (u otro error de red del sistema)	No hubo respuesta. `error.Type` es `"HttpRequestException"`.
`La solicitud DELETE a api.ejemplo.com no terminó en 300 s (tiempo de espera agotado). Sube «Tiempo de espera» si el servicio tarda más.`	El servidor no respondió dentro de `timeout`. `error.Type` es `\"TimeoutException\"`: captúralo con Try / Catch o reintenta con Retry; si la API tarda por naturaleza, sube `timeout`. Si el fallo es al conectar, el mensaje dice `No se pudo conectar con … en 30 s`.
`An invalid request URI was provided. Either the request URI must be an absolute URI or BaseAddress must be set.`	La `url` no es absoluta. Incluye `https://`.
`'url' es obligatorio.`	La expresión de `url` dio nulo.

Ejemplo

HTTP DELETE
  url = "https://api.erp.com/clientes/" + clienteId
  authorization = { "type": "bearer", "token": credential("api-erp")["value"] }
  → output: resp

Log   message = "Cliente eliminado (status " + resp.StatusCode + ")"

Actividades relacionadas

HTTP GET — leer datos.
HTTP POST — crear un recurso.
Try / Catch — manejar respuestas de error.