Cómo utilizar la API de WooCommerce

WordPress es el CMS más popular que se utiliza actualmente. ¿Por qué? Porque se integra fácilmente con miles de herramientas para mejorar el rendimiento y la funcionalidad de su sitio web.

Estas herramientas cubren una amplia gama de industrias, pero los usuarios quedan constantemente impresionados por la cantidad de herramientas disponibles para el comercio electrónico. Una de las herramientas de comercio electrónico más poderosas es la API de WooCommerce.

Comprender la API de WooCommerce

La API de WooCommerce tiene tres componentes principales. Para comprender cuán poderosa puede ser esta API, echemos un vistazo a cada componente individualmente.

API DESCANSO

La API REST de WooCommerce permite a los usuarios acceder a su tienda WooCommerce desde fuera de su sitio web. Este diseño te permitirá acceder a tu tienda desde otras aplicaciones de Internet como Shopify, por ejemplo.

En definitiva, el API DESCANSO facilita la gestión de su tienda. Puede acceder a su tienda WooCommerce desde los paneles de otras aplicaciones y aún tener acceso a la funcionalidad completa de administración de WooCommerce.

API heredada

Habilitar la API heredada solía ser la forma de activar su API para WooCommerce. Sin embargo, esta parte del proceso está quedando obsoleta en versiones más recientes.

La versión más nueva es la API REST de WooCommerce. Se integra directamente con la API de WordPress. La API heredada es la versión anterior de WooCommerce. Los usuarios deben volver a verificar su configuración, ya que WooCommerce tiende a iniciar la API heredada de forma predeterminada.

Ganchos web

Los webhooks permiten que WooCommerce «llame» a otras aplicaciones. Por ejemplo, si desea que las acciones dentro de WooCommerce se activen mediante acciones realizadas en otras aplicaciones, puede utilizar un webhook.

La API logra esto utilizando URL. Puede enviar una alerta de notificación a través de la API a una URL específica. Estas URL pueden provocar eventos en un sitio en particular y desencadenar otra acción en un sitio o página independiente.

Terminología clave de la API de WooCommerce

A medida que recorra la documentación de la API de WooCommerce, encontrará terminología exclusiva de WooCommerce. Repasemos estos términos y definiciones para ayudarle en su proceso de API.

Formato de solicitud/respuesta

Esto indica el formato que utilizará WooCommerce para transmitir tipos particulares de datos. Es importante conocer los diferentes tipos de datos porque ciertas URL y activadores no funcionarán si no reciben datos en el formato adecuado.

El formato estándar para la mayoría de los datos dentro de la API de WooCommerce es JSON. Las fechas del calendario regresan como números enteros, y cualquier número (como dinero, precios o totales) estará en una cadena de texto y tendrá por defecto dos decimales. Todo lo que se deje en blanco se devolverá como una cadena vacía o «nulo».

Autenticación

El proceso de autenticación permite la integración de la API de WooCommerce. Los usuarios pueden conectar la API a otras plataformas mediante claves API.

Para generar una clave API de WooCommerce, debe acceder a su configuración. Hay dos claves disponibles para los usuarios de WooCommerce, una clave secreta y una clave de consumidor.

Las claves de consumidor también se conocen como claves generales o API. Estas claves se emiten a un usuario de diferentes plataformas. Las claves API de WooCommerce le permiten conectarse a otras plataformas como WordPress, Shopify, etc.

La clave secreta se comporta de manera similar para determinadas aplicaciones y plataformas. Cuando conecta herramientas o aplicaciones de terceros a WooCommerce, la clave general o de consumidor actuará como el «nombre de usuario» de sus credenciales de inicio de sesión, mientras que la clave secreta actuará como su contraseña.

Puntos finales

En términos de tecnología API, un punto final es el punto en el que la API interactúa con otra aplicación o plataforma. Un ejemplo de punto final sería la URL de una plataforma específica, como Shopify o Facebook.

Configurando la API de WooCommerce

El proceso de configuración de su API WooCommerce es relativamente sencillo. Siga los pasos a continuación para vincular todas sus herramientas a la plataforma y transformar la experiencia de compra de comercio electrónico de sus clientes.

Deberá navegar por los siguientes menús en su panel de WordPress:

WooCommerce>Configuración>Avanzado>API heredada

Hay una casilla de verificación para indicar si la API está habilitada o no. Asegúrese de que la casilla esté marcada, haga clic en guardar cambios y el acceso API ya estará disponible.

Cómo crear claves API en WooCommerce

Las claves API son la columna vertebral de las funciones API de WooCommerce. Es hora de crear algunas para conectar tus herramientas y plataformas favoritas. Siga los pasos a continuación para hacerlo.

1. Agregar clave

Deberá crear una nueva clave para cada aplicación o plataforma que conecte a WooCommerce. La API generará una clave de consumidor y una clave secreta para cada nueva conexión que cree.

Deberá dirigirse al menú de API REST para agregar una clave. Así es como puedes encontrarlo:

WooCommerce>Configuración>Avanzado>API REST

Una vez que estés allí, haz clic Agregar clave.

2. Configurar los ajustes clave

Una vez que haga clic en «Agregar clave», deberá tomar algunas decisiones. Para cada clave que cree, deberá configurar los siguientes ajustes:

• Descripción – Aquí es donde puedes “nombrar” cada clave para la plataforma correspondiente para ayudar a organizarlas
• Dueño – Asigne una clave al usuario específico responsable de ella dentro de su equipo
• Permisos – Estos dictan qué funciones le estás otorgando a esta clave en particular. Por ejemplo, si necesita una clave específica para eliminar o ajustar datos, deberá otorgar «Permisos de lectura/escritura».

3. Generación de API

Una vez que se complete la configuración, presionará el botón «Generar clave» en la parte inferior de la pantalla. La siguiente página a la que accederá contendrá una clave de consumidor y una clave secreta, y un código QR para esta conexión.

Una vez que salga de la página de Generación de API, no podrá regresar. Entonces, copie estas claves en otro documento de Word o Notes y consérvelas. Los necesitarás para conectarte a tu Configuración de WooCommerce.

4. Usar claves para conectarse a aplicaciones de terceros

Ahora, con sus claves API generadas, podemos comenzar a conectarnos a aplicaciones y plataformas de terceros, conocidas como «clientes API». Deberá seguir los pasos en ambos lados de la conexión en el menú WooCommerce en WordPress y en la aplicación elegida.

Cada plataforma es diferente, por lo que deberá acceder a los recursos de ayuda de esa plataforma en particular. Busque consejos sobre cómo acceder a las credenciales de autorización de la aplicación.

La mayoría de las plataformas ofrecen múltiples tipos de autorización. Querrá seleccionar Autorización básica.

Copie y pegue su clave API general o de consumidor en la barra «Nombre de usuario» y use su clave secreta como contraseña. Al hacer esto, habrá conectado exitosamente WooCommerce con una de sus otras poderosas herramientas de comercio electrónico. El siguiente paso es comenzar a realizar solicitudes de API.

Cómo realizar solicitudes de API de WooCommerce

Las solicitudes de API son donde ocurre la magia. Estas solicitudes hacen posible todas las funciones «interesantes» que le harán la vida más fácil. Estas solicitudes vienen en dos formatos: GET o PUT. Siga los pasos a continuación para configurarlos entre herramientas.

1. Pruebe una solicitud GET

Las solicitudes GET son útiles para obtener datos de otras fuentes, como sugiere el nombre. Un ejemplo práctico de comercio electrónico sería obtener una lista de sus productos WooCommerce. Hacer esto requiere algunos conocimientos de tecnología, pero si sigues las instrucciones, todo estará bien.

Para realizar esta función GET, deberá escribir la siguiente URL:

https://yoursite.com/wp-json/wc/v3/products

Naturalmente, querrás ingresar tu URL donde dice «tu sitio». Cuando se ejecuta, este GET extraerá todos los datos de sus productos enumerados en WooCommerce.

La integración de la API de WooCommerce le devolverá estos datos en formato JSON. Si se hace correctamente, la plataforma a la que se conecta WooCommerce analizará estos datos para que terminen en un formato fácil y utilizable para sus usuarios finales.

Si ejecuta esta función GET y recibe un 401 u otro código numerado, significa que hay algún error. Es posible que tengas que regresar o consultar más recursos de ayuda de la plataforma para solucionar el problema. Si la solicitud GET se realiza correctamente, debería ver la cadena JSON en la sección «Cuerpo» de su panel.

2. Pruebe una solicitud PUT

Utilizando los datos de nuestra solicitud GET en el paso 1, querrás verificar también una solicitud PUT. Para nuestro ejemplo, digamos que el producto que estamos usando para esta solicitud tiene un ID de producto de 101. Para ejecutar la solicitud GET, nuestra URL se verá un poco diferente:

https://yoursite.com/wp-json/wc/v3/products/101

El proceso para convertir esto en una función PUT en lugar de GET es simple:

• Al lado del campo URL, hay un menú desplegable
• Selecciónelo y cambie la función de GET a PUT.
• En el panel Cuerpo del panel, elija la opción «Sin procesar».
• Abra el menú desplegable «texto» y seleccione JSON

Una vez completados esos pasos, ahora puede realizar su solicitud. Un ejemplo de uso de esto podría ser si quisiera cambiar el precio del producto n.° 101. Para hacerlo, ingresaría el siguiente texto:

{
"regular_price": "50"
}

Después de eso, puede publicar los resultados en su sitio presionando Enviar.

Solicitudes útiles de API de comercio electrónico

Varias solicitudes de API serán útiles en su tienda de comercio electrónico. Puede que sea necesario investigar para encontrar una solicitud de API que haga exactamente lo que está buscando, pero a continuación enumeramos algunas básicas para que pueda comenzar.

OBTENER solicitudes

Estas son las URL de algunas solicitudes GET que puedes poner en práctica en tu tienda de comercio electrónico:

• OBTÉN todos los productos: https://yoursite.com/wp-json/wc/v3/products/
• OBTENER todos los clientes: https://yoursite.com/wp-json/wc/v3/customers/
• CONSIGUE un solo cliente: https://yoursite.com/wp-json/wc/v3/customers/{ID de cliente}
• OBTÉN todas las categorías de productos: https://yoursite.com//wp-json/wc/v3/products/categories
• OBTÉN una variación del producto: https://yoursite.com/wp-json/wc/v3/products/{ID de producto}/variations/{ID de variación}
• CONSIGUE un solo producto: https://yoursite.com/wp-json/wc/v3/products/{ID de producto}

solicitudes de colocación

Aquí hay algunas solicitudes PUT básicas que pueden resultarle útiles para su tienda.

Actualizar los atributos del producto (color, tamaño, etc.)

{
"id": 1,
"name": "Color”,
"slug": "pa_color",
"type": "select",
"order_by": "name",
"has_archives": true,
"_links": {
"self": [
{
"href": "https://example.com/wp-json/wc/v3/products/attributes/6"
}
],
"collection": [
{
"href": "https://example.com/wp-json/wc/v3/products/attributes"
}
]
}
}

Actualizar el nombre completo del cliente

{
"first_name": "John",
"last_name": "Doe"
}

Actualizar el precio del producto para una variante

{
"regular_price": "81"
}

Utilice una solicitud para actualizar el precio y la cantidad de inventario

{
"regular_price": "50",
"stock_quantity": 30
}

Actualizar dirección de envío

{
"shipping": {
"first_name": "Jane",
"last_name": "Doe",
"company": "Jane Doe Co",
"address_1": "361 Outside Rd",
"address_2": "Suite 101",
"city": "Las Vegas",
"state": "NV",
"postcode": "89102",
"country": "US"
}
}

Actualizar una reseña de producto

{
"id": 20,
"date_created": "2018-09-08T21:47:19",
"date_created_gmt": "2018-09-09T00:47:19",
"product_id": 31,
"status": "approved",
"reviewer": "Claudio Sanches",
"reviewer_email": "john.doe@example.com",
"review": "Now works just fine.",
"rating": 5,
"verified": true,
"reviewer_avatar_urls": {
"24": "https://secure.gravatar.com/avatar/908480753c07509e76322dc17d305c8b?s=24&d=mm&r=g",
"48": "https://secure.gravatar.com/avatar/908480753c07509e76322dc17d305c8b?s=48&d=mm&r=g",
"96": "https://secure.gravatar.com/avatar/908480753c07509e76322dc17d305c8b?s=96&d=mm&r=g"
},
"_links": {
"self": [
{
"href": "https://example.com/wp-json/wc/v3/products/reviews/20"
}
],
"collection": [
{
"href": "https://example.com/wp-json/wc/v3/products/reviews"
}
],
"up": [
{
"href": "https://example.com/wp-json/wc/v3/products/31"
}
],
"reviewer": [
{
"embeddable": true,
"href": "https://example.com/wp-json/wp/v2/users/1"
}
]
}
}

Uso avanzado de la API de WooCommerce

Además de lo básico, los usuarios también pueden aprovechar la API de WooCommerce para manejar algunas funciones avanzadas para su tienda de comercio electrónico. Algunas de las características avanzadas de WooCommerce son:

• Paginación personalizada – La API de WooCommerce permite a los usuarios crear un número de artículo personalizado por página para adaptarse al estilo y diseño de su sitio web.
• Ganchos web – Los usuarios pueden programar webhooks de WooCommerce para activar eventos en otros sitios web. Las tiendas de comercio electrónico pueden utilizar esto para ayudar con Opciones de envío de WooCommerceembalaje, proceso de devolución y más
• Tareas asincrónicas – Las tiendas pueden activar tareas asincrónicas para que se activen por separado después de que se haya pagado un pedido o que un cliente haya creado una cuenta con su marca.
• Filtrar y ordenar datos – Puedes añadir campos personalizados para productos WooCommerce e implementar funciones de clasificación personalizadas para mejorar la experiencia de sus clientes

Mejores prácticas y consejos de WooCommerce

La API de WooCommerce te brinda mucha libertad para personalizar tu tienda de comercio electrónico. Es importante no «personalizar demasiado» ni agregar demasiadas «campanas y silbatos» a su tienda de comercio electrónico. A continuación se presentan algunas prácticas recomendadas que debe tener en cuenta al personalizar su tienda de comercio electrónico.

Utilice un complemento

Si solo planeas realizar cambios menores en tu tienda, quizás quieras considerar el uso de un complemento. Todo se maneja dentro del panel y no requiere código ni cadenas de texto adicionales.

JetPack para WordPress es un complemento útil para la personalización básica de WooCommerce. Si las actualizaciones que estás realizando solo implican cambios en la hoja de estilo o en el feed CSS, esta opción es para ti.

Además, hay muchas opciones de complementos CSS disponible si desea tener CSS global que no se pierda cuando cambia el tema activo o el tema secundario.

Utilice un tema hijo

Después de actualizar la hoja de estilo o CSS, es posible que se restablezcan con cada actualización de su sitio web. Para mantener sus personalizaciones mientras WordPress continúa actualizando su sitio, considere usar un tema secundario.

El tema secundario le permite realizar cambios sin agregar código. Además, los cambios que realice se aplican al tema principal, lo que le permitirá realizar actualizaciones de forma segura para mejorar la experiencia general del cliente.

Obtenga alojamiento WooCommerce totalmente administrado

La API de WooCommerce ofrece muchas funciones adicionales que pueden transformar la forma en que administra su negocio de comercio electrónico. Usarlo correctamente puede mejorar la experiencia del cliente, mejorar el rendimiento de la tienda y, en última instancia, aumentar la rentabilidad.

Pero una herramienta poderosa como esta API es tan buena como el alojamiento en el que se ejecuta. Nexcess ofrece WordPress potente y totalmente administrado y Alojamiento WooCommerce. Póngase en contacto con el equipo hoy y vea cómo podemos llevar su negocio (y la experiencia de compra de sus clientes) al siguiente nivel.