¿Qué es la API REST de WooCommerce?

Con la versión 2.1 de WooCommerce se han introducido multitud de mejoras y nuevas funcionalidades. Una de esas nuevas funcionalidades que se han integrado y probablemente la más revolucionaria, es la API REST de WooCommerce.

Pero antes de seguir avanzando, me gustaría aclarar qué es una API (del inglés Application Programming Interface) para que aquellos que no estén familiarizados con este concepto, puedan entender lo que voy a tratar más adelante en este artículo.

Una API se podría definir como un conjunto de funciones o métodos que ofrece cierta biblioteca para que puedan ser utilizados por otro software. La gran ventaja de usar APIs es que permiten implementar funciones o métodos en cualquier proyecto sin necesidad de reescribirlos de nuevo. Lo cual ahorra mucho tiempo y hace que el software tenga una estructura mucho más limpia.

La API REST sin embargo, es un caso particular de API, ya que todos los métodos o funciones de la biblioteca están apoyados en el estándar HTTP. Es decir, se usan para conectar diferentes aplicaciones web.

Por tanto, la API REST de WooCommerce permite que otras aplicaciones web de terceros usen los métodos de su biblioteca para conectarse a tu plataforma e-commerce de manera segura.

¿Qué mejoras supone la nueva API REST de WooCommerce?

Con la nueva API REST de WooCommerce se abre un nuevo mundo de posibilidades para todas las tiendas online implementadas con esta plataforma.

Ahora ya es posible conectar cualquier aplicación web externa a tu tienda online para que pueda tener acceso a todo tipo de información. Siempre bajo tu control claro está.

Con esto quiero decir que desde tu panel de administración de WordPress puedes definir que tipo de privilegios otorgas a la aplicación que quiere conectarse a tu tienda. Existen 3 tipos de permisos:

1. Sólo lectura. La aplicación que se conecte a tu tienda sólo puede leer información para después procesarla y mostrarla a sus usuarios.
2. Sólo escritura. La aplicación con permisos de escritura puede actualizar el estado del pedido.
3. Lectura y escritura. Puede tanto leer información, como modificar el estado de un pedido.

Cómo se activa la API REST de WooCommerce y qué se necesita para usarla.

Para activar la API REST de tu tienda WooCommerce simplemente tienes que entra en «WooCommerce > Ajustes > General» y marca la casilla que dice «Activar la API REST«.

Una vez activada API REST, para que la aplicación en cuestión pueda conectarse a tu tienda y hacer consultas de forma segura -se recomienda tener instalado un certificado SSL-, hay que generar unas claves únicas. Estas claves reciben el nombre de «Clave de cliente« y «Clave secreta«. Para generarlas tienes que seguir los siguientes pasos:

1. Entrar en «Usuarios > Todos los usuarios«, busca el usuario al que deseas dar acceso a la API REST de tu tienda y haz clic sobre él.
2. Una vez dentro del panel de edición del usuario, desplázate abajo del panel para marcar la casilla «Generar clave para la API» y haz clic en «Actualizar perfil«.
3. Vuelve a desplazarte abajo del panel y ya podrás ver las claves generadas para ese usuario. Sólo falta que selecciones que tipo de permisos quieres darle (Leer, Escribir o Leer/Escribir) y por último hacer clic en «Actualizar perfil» para guardar la configuración.
   

Con esto ya tendrás las claves para poder conectar tu aplicación a tu tienda WooCommerce a través de la API REST.

Comunicando con WooCommerce a través de la API REST.

Para comunicarte con tu tienda WooCommerce a través de la API REST puedes hacerlo de forma muy sencilla con una librería cliente escrita en PHP por Gerhard Potgieter, el cual también forma parte del equipo de desarrollo de WooCommerce. Puedes descargarla desde su repositorio de Github.

Incluyendo esta librería en el código de tu aplicación y usando los métodos de la clase cliente «class-wc-api-client.php» podrás conectarte a tu tienda WooCommerce, hacer consultas o actualizar pedidos en base a los permisos que tengas otorgados.

Una consideración que debes tener en cuenta para evitar que la API REST te devuelva un error al conectar con tu tienda WooCommerce, es asegurarte de tener activados y configurados correctamente los enlaces permanentes de WordPress. Puedes comprobarlo en «Ajustes > Enlaces permanentes» y en el apartado «Ajustes comunes» debe estar marcada cualquiera de las opciones excepto la de «Predeterminado«.

Aunque no haya entrado en detalles, reconozco que este artículo ha sido bastante más técnico que los que vengo publicando hasta ahora. Pero tranquilo, no tengo pensado cambiar la línea editorial del blog, sólo que creía conveniente explicar un poco por encima qué es la REST API de WooCommerce, puesto que supone un gran avance para la plataforma.

Así que no te preocupes porque los próximos artículos seguirán en la misma línea de los anteriores, mucho más prácticos y siempre con el objetivo de aclarar dudas sobre la configuración de WooCommerce o resolver problemas que vayan surgiendo.