HTTP POST

Tipo: http-post · Paquete: HTTP Activities v1.0.0 · Salida: ZoanHttpResponse

Envía una petición POST, normalmente para crear un recurso o enviar datos a una API: registrar un cliente, enviar un formulario, disparar una acción. A diferencia de GET, incluye un cuerpo (body) con los datos.

Cómo funciona

Envía el body a la url. El cuerpo puede ser un objeto (se convierte automáticamente a JSON) o un texto. El contentType por defecto es application/json. Devuelve un ZoanHttpResponse. Si el servidor responde con error, la actividad falla — ver manejo de errores.

Parámetros requeridos

Parámetro	Editor	Descripción
`url`	expresión	La URL de la petición.
`body`	expresión	El cuerpo: un objeto (→ JSON) o un texto.

Parámetros opcionales

Parámetro	Editor	Descripción
`contentType`	texto	Tipo de contenido. Por defecto `application/json`.
`headers`	JSON	Cabeceras extra. Ver cabeceras.
`authorization`	JSON	Autenticación: `bearer`, `basic` o `apikey`. Ver autenticación.

Salida

Devuelve un ZoanHttpResponse. Las APIs suelen devolver en .Body el recurso creado (con su nuevo id) y .StatusCode 201.

Ejemplo

Crear un cliente enviando un objeto como JSON:

HTTP POST
  url  = "https://api.erp.com/clientes"
  body = { "nombre": = cliente.nombre, "nit": = cliente.nit, "activo": true }
  authorization = { "type": "bearer", "token": = credential("api-erp").ToPlainText() }
  → output: resp

Log   message = = "Cliente creado con id " + resp.Body["id"]

Actividades relacionadas

HTTP PUT / HTTP PATCH — actualizar un recurso existente.
HTTP GET — leer datos.
Try / Catch — manejar respuestas de error.