Enviar y recibir JSON con encabezados usando PHP y cURL

En este post voy a explicar cómo enviar datos codificados como JSON y cómo recibir datos igualmente de tipo JSON usando PHP y las funciones de cURL.

Al final seremos capaces de enviar datos JSON con PHP así como encabezados HTTP.

Gracias a que veremos cómo hacer esta comunicación podríamos conectar dos servidores de PHP en distintos hosts, o unificar el consumo de APIs de terceros en un solo lugar.

Recomendados

Dentro del código vamos a codificar y decodificar con JSON así que recomiendo pasar por este post. De igual manera vamos a usar el contructor array pero existe una versión más corta.

Nota: en este tutorial vamos a programar el servidor y el cliente con PHP; normalmente solo se haría una cosa, o programar el cliente o el servidor; pero de esta manera vemos cómo recibir y enviar datos.

Enviar datos JSON con cURL y PHP: cliente

Basta de charlas, es hora de mostrar el código. Veamos un ejemplo para enviar datos JSON con el método POST usando cURL en PHP:

1 – Definición de datos

Comenzamos definiendo los datos que se van a enviar. Estos datos podrían venir de un formulario o de cualquier otro lugar. Los he hecho complejos a propósito para demostrar cómo enviar un objeto con arreglos, cadenas, booleanos, enteros, y arreglos de objetos.

2 – Crear objeto con curl_init y establecer opciones

Después creamos un objeto de cURL con curl_init, pasando la url como argumento. En este caso la URL es en localhost, si tú consultas otro servidor pon la url del mismo.

Más tarde establecemos las opciones de cURL como el tipo de petición HTTP (sería POST), los encabezados (En donde indicamos que el contenido es JSON, además de agregar encabezados personalizados) y los datos,  así como CURLOPT_RETURNTRANSFER en true para que devuelva la petición en lugar de imprimirla.

3 – Realizar y procesar petición

Para hacer la petición llamamos a curl_exec y luego comprobamos el código de respuesta; si es 200 significa que todo fue bien pero si no, lo indicamos.

Casi al final leemos la respuesta (veremos más abajo cómo programamos el servidor) que igualmente es json, imprimimos los campos y al final se ve así:

PHP y cURL - petición con JSON

PHP y cURL – petición con JSON

En realidad he cambiado un poco los colores pero el código es el mismo.

Recibir y procesar datos con PHP y JSON

Para recibir los datos no es necesario cURL, pues solamente leemos la petición. Leemos el cuerpo y lo decodificamos, al final tendremos el objeto que fue enviado desde el cliente.

Una vez que llamamos a json_decode podemos acceder al objeto tal y como estaba cuando fue enviado. Este JSON fue enviado desde PHP pero podría haber sido enviado desde otro lenguaje o lugar.

Armamos una respuesta agregando un mensaje personalizado, indicando los encabezados que encontramos para agregar más detalles y la imprimimos.

Una confusión al comenzar a programar es que queremos hacer un return, pero eso no debe hacerse, se debe hacer un echo o alguna forma de imprimir los resultados en el documento.

Conclusión

Este fue un ejemplo muy básico pero lo hice de esta manera para los programadores que apenas comienzan.

Cabe mencionar que cURL no es la única manera de hacer una petición, también existen métodos como file_get_contents, librerías de terceros y más; además de que para las peticiones podemos usar cualquier lenguaje que hable HTTP y no siempre nos comunicaremos con JSON.

Si quieres ver otros ejemplos de consumos de APIs haz click aquí.

Enviar y recibir JSON con encabezados usando PHP y cURL

Por parzibyte Tiempo de lectura: 3 min
1