Acabo de enseñarte a hacer una petición HTTP de tipo GET usando el lenguaje de programación C con la librería cURL.

En una petición GET no puedes enviar datos más allá de los parámetros GET en la URL, pero en una petición POST puedes enviar un payload de cualquier tipo ya sea JSON, archivo binario, etcétera.

Justamente eso veremos hoy: cómo enviar datos JSON en una petición HTTP POST usando ANSI C. Te digo desde ahora que enviaremos los datos ya codificados, no los codificaremos directamente en C ya que si bien es posible eso queda fuera de este tutorial.

Sobre la función que recibe datos

Recuerda que estamos hablando de C, y aquí tenemos que escribir más código que el que escribiríamos en otros lenguajes, incluso para manejar la respuesta de la petición.

En este caso la librería cURL necesita que indiquemos la CURLOPT_WRITEFUNCTION que será invocada cada vez que haya datos, así como inicializar los datos con CURLOPT_WRITEDATA.

Yo lo he hecho con una cadena dinámica, y le he dedicado un post completo a las funciones previamente mencionadas: Hablando sobre WRITEFUNCTION y WRITEDATA de cURL.

Nota: leyendo, vi que existen funciones análogas para leer el payload, es decir, existe CURLOPT_READFUNCTION para proporcionar un callback de lectura de datos, aunque en este caso no es necesario pero se me hizo interesante.

Haciendo petición POST

Hacer una http request con ANSI C de tipo POST es casi lo mismo que hacer una GET: la respuesta se maneja igual, así como las otras opciones como la asignación de la URL. Lo que cambia en este ejemplo es:

1. Vamos a enviar una lista de encabezados con CURLOPT_HTTPHEADER. Esto es válido para cualquier tipo de petición, pero en el ejemplo de petición GET no lo hicimos
2. Estableceremos CURLOPT_POST en 1L para indicar que haremos una petición post. Esto hace que el content type sea application/x-www-form-urlencoded, por ello es que enviamos unos encabezados personalizados con la opción anterior
3. Finalmente colocaremos los datos a enviar con CURLOPT_POSTFIELDS que recibe un arreglo de tipo char; por lo que en este caso podemos enviar una simple cadena.

Entonces el código que se diferencia al de la petición GET queda como se ve a continuación:

char *url = "https://jsonplaceholder.typicode.com/posts";
char *cargaUtil = "{\"nombre\":\"Luis\"}";
struct curl_slist *list = NULL;
list = curl_slist_append(list, "Content-Type: application/json");
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, list);
curl_easy_setopt(curl, CURLOPT_URL, url);
curl_easy_setopt(curl, CURLOPT_POST, 1L);
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, cargaUtil);
res = curl_easy_perform(curl);
if (res == CURLE_OK)
{
 printf("La respuesta del servidor es: %s", miCadena->datos);
}
else
{
 fprintf(stderr, "Error en la petición: %s\n", curl_easy_strerror(res));
}

No te preocupes, dejaré el código completo al final del post. Quiero que te fijes en que la URL es la misma que con el ejemplo de petición GET, ya que justamente esa URL detectará si la petición es POST o GET (así está programado el servidor); si es POST entonces devolverá los datos que le enviamos (en formato JSON igualmente) pero agregando un id.

Obviamente si en tu caso la API o sitio tiene una URL distinta para la petición POST, cambia lo necesario.

Lo más importante es que veas que el JSON enviado con C está siendo pasado con CURLOPT_POSTFIELDS y que en caso de que la petición sea exitosa la respuesta estará en miCadena->datos.

Código completo y compilación

El código completo lo dejaré en GitHub. Recuerda que aquí estoy asumiendo que ya sabes cómo instalar la librería cURL, tienes conocimientos sobre la cadena dinámica y has leído el post sobre cómo hacer una petición HTTP GET con C.

Compila así:

gcc http-request-post.c -Wall -lcurl -o post.exe

Luego ejecuta con:

post.exe

También te dejo con un vídeo explicando todo el post paso por paso y demostrando que la petición sirve perfectamente: