Manual de la API REST de WooCommerce: Explicación exhaustiva y casos prácticos

Gestionar una tienda online suele ser costoso y a menudo implica lidiar con un montón de tediosos procesos manuales. Pero la buena noticia es.API REST de WooCommerce La llegada de WooCommerce simplifica todo esto. Es como un asistente inteligente que te permite controlar programáticamente la plataforma de comercio electrónico con facilidad, para que puedas gestionar y escalar mejor tu tienda WooCommerce.

Integra, automatiza y amplía la funcionalidad de tu tienda online utilizando la API REST de WooCommerce, y todo el proceso será fluido y sin complicaciones. No solo ahorrarás muchos recursos y tiempo, haciendo que el flujo de trabajo sea más sencillo y eficiente, sino que también podrás personalizar el aspecto de tu tienda como desees con aplicaciones externas flexibles. Con la API REST de WooCommerce, gestionar tu tienda online nunca ha sido tan fácil. A continuación, vamos a sumergirnos en la API REST de WooCommerce para automatizar mediante programación muchas tareas y mejorar aún más la eficiencia de tu negocio de comercio electrónico.

Condiciones de uso de la API REST de WooCommerce

• WooCommerce versión 3.5 o superior.
• WordPress versión 4.4 o superior.
• Cartero tal vezInsomnio Para pruebas e interacción con la API.

Generar credenciales API en WooCommerce

Cree un sitio web WordPress y luego genere las credenciales API en WooCommerce. Para generar las credenciales API de WooCommerce, sigue estos pasos:

1. Acceda al panel de WordPress y seleccione en la barra lateralplug-in (componente de software)>Plug-ins instalados A continuación, active el complemento WooCommerce.

2. Tras activar el complemento, seleccioneWooCommerce  >establecer. A continuación, haga clic en"Avanzado" para acceder a la página de Configuración Avanzada de WooCommerce.

3. A continuación, haga clic enAPI REST.

4. Pulse"Crear clave API" tal vez"Añadir llave" para generar una clave API.

5, a continuación, el sistema le pedirá que introduzcaDetalles clave. Son Descripción, Usuarios y Permisos. Introduzca la descripción de la clave, cambie el usuario según sea necesario y seleccione la opciónLectura/EscrituraPermisos.

6. PulseGeneración de claves API. Utilizando la clave API generada, puede acceder mediante programación a los datos de la tienda y gestionarlos. Anote la clave de usuario y el secreto, ya que se utilizarán para realizar solicitudes de API en la siguiente sección.

Comprender la arquitectura de la API REST de WooCommerce

La API de WooCommerce se basa en una arquitectura REST. Esto le permite leer y realizar operaciones de escritura en los datos de WooCommerce, tales como pedidos, productos y clientes, mediante el envío de solicitudes al punto final a través de los métodos apropiados (GET, POST, PUT, DELETE).

Un endpoint consiste en un método de petición y una URL estándar. A través del endpoint, se puede acceder a diferentes datos almacenados utilizando la herramienta de su elección (Postman o Insomnia).

Obtener lista de productos

Asegúrese de haber añadido algunos productos a la tienda antes de obtener la lista de productos. La estructura permalink debe cambiarse aLlanoestructuras distintas de la que nos ocupa. Haga clic en la barra lateral delestablecer >Enlace permanente y cambiar la estructura del permalink. Si no se realiza este cambio, el punto final de URL estándar no funcionará correctamente. Haga clic en"Guardar cambios".

A continuación, abra Postman y añada una nueva solicitud. En la sección URL, utilicehttps:///wp-json/wc/v3/products. Asegúrese de que la sustitución<yourdomain> para tu dominio web WooCommerce.

En la pestaña Autorización, seleccioneAutenticación básica y, a continuación, introduzca la clave de consumidor comoID de usuario Introduzca la clave de consumidor comocriptográfico. Esta autorización debe añadirse a cada solicitud que envíe a la API REST de WooCommerce. Envíe la solicitud y debería recibir una lista de todos los productos de la tienda.

Gestión de productos a través de la API REST

Los objetos producto tienen una lista de atributos que le permiten agrupar directamente los productos, gestionar el inventario y fijar los precios, todo ello mediante programación.

Suponiendo que quieras añadir el nuevo producto al grupo de productos creado, todo lo que necesitas es el ID del grupo de productos en la propiedad productos_agrupados .

Para gestionar el inventario, utilice la funcióngestionar_stock responder cantandoestado_de_almacenamiento que se establecen enverdadero tal vezfalso yinstockyonbackorderresponder cantandooutofstock .

A continuación, vamos a ver cómo añadir y actualizar detalles de productos existentes.

Añadir productos usando la API de WooCommerce

1. En Postman, añada una nueva solicitud y cambie el método de solicitud aPOST. Vuelva a utilizar la URL del punto final utilizada en la sección anterior. haga clic en"Texto"seleccioneen brutoy luego seleccioneJSONcomo formato del cuerpo. La carga útil JSON contiene el nombre del producto, el tipo (simple, variable o agrupado), la descripción y una breve descripción. También contiene categorías, etiquetas e imágenes que puede añadir según sea necesario.

{
 "name": "iPhone 15 Pro Max",
 "type": "simple",
 "description": "",
 "short_description": "",
 "categories": [
 ], "tags".
 "tags": [],
 "images": []
}

2. Ejecute la solicitud. Si el producto se ha creado correctamente, debería recibir un objeto producto como respuesta. Anote el ID del producto, ya que lo utilizará en la siguiente sección.

Editar productos con la API de WooCommerce

Edita el registro que acabas de crear.

1. En "texto principal (a diferencia de las notas a pie de página) "añada el siguiente texto JSON:

{
  "nombre": "iPhone 15 Pro"
}

Dado que sólo se actualizan los camposnombre En este caso, cámbialo a "iPhone 15 Pro". En este caso, cámbielo por "iPhone 15 Pro". La URL del punto final debe serhttps://yourdomain/wp-json/wc/v3/products/<id>.

2. Sustituciónid es el ID del producto creado en la sección anterior. no olvide cambiar el método de solicitud aPUT. Ejecute la solicitud y debería recibir un objeto producto como respuesta. El nombre del producto en la respuesta se puede comprobar para confirmar que se ha actualizado correctamente.

Gestión de pedidos mediante API REST

La API REST de WooCommerce facilita el procesamiento automatizado de pedidos mediante la recuperación de pedidos y la actualización de su estado. Permite recuperar pedidos mediante programación, filtrarlos en función de varios criterios como la fecha, el estado o el cliente y, a continuación, procesarlos de forma eficiente.

Esto incluye la actualización del estado de los pedidos para reflejar las distintas fases de cumplimiento o procesamiento. La API REST de WooCommerce garantiza un seguimiento y una comunicación precisos con sus clientes. Además, puedes gestionar los reembolsos a través de la API, incluyendo el procesamiento de las solicitudes de reembolso, la automatización de los reembolsos y la actualización del estado del pedido (después de los reembolsos).

Obtener pedidos recientes con la API de WooCommerce

1,En Postman, añada una opción para utilizar un GETUna nueva solicitud para obtener un pedido. La URL del endpoint debería ser como la siguiente:

https:///wp-json/wc/v3/orders

2. En"Parámetros"después deintroduzca las claves y valores de la fecha de creación del pedido. En este caso, utilice el campo2024-03-08t00:00:00. Siéntase libre de modificar esta fecha según sea necesario. Los pedidos pueden filtrarse para mostrar sólo los pedidos posteriores a la fecha indicada. Deje los demás ajustes de Postman por defecto.

3. Asegúrese de que ha realizado algunos pedidos en su tienda WooCommerce para evitar devolver una lista vacía. Ejecutando esta petición obtendrás una lista de todos los pedidos realizados a tu tienda que cumplan los criterios especificados.

Actualizar el estado del pedido

Para actualizar el estado del pedido, obtenga el ID del pedido que ha realizado. añada una nueva solicitud en Postman y cambie su solicitud a PUT. Utilice el siguiente punto final para las actualizaciones: https://yourdomain/wp-json/wc/v3/orders/. En la pestaña Cuerpo, añada el siguiente JSON :

{
  "estado": "completado"
}

Tras ejecutar la solicitud, se recibe una respuesta y la orden se marca como completada.

Gestión de clientes y compromiso

Con la API REST de WooCommerce, es fácil crear nuevos perfiles de clientes, modificar los detalles de los clientes existentes y acceder fácilmente a información completa sobre su historial de compras y sus preferencias. Con esta información, las empresas pueden comprender con mayor precisión los hábitos de compra de sus clientes para diseñar estrategias de marketing personalizadas. Ya se trate de lanzar promociones específicas, recomendar los productos adecuados u ofrecer premios de fidelidad, los clientes pueden sentirse más conectados.

Este tipo de gestión granular de los datos de los clientes no sólo ayuda a las organizaciones a establecer relaciones más estrechas con sus clientes, sino que también mejora enormemente su satisfacción y les anima a volver a comprar.

Añadir clientes usando la API de WooCommerce

1. Enviar un mensaje a esta URL de punto finalPOSThttps:///wp-json/wc/v3/customersSolicitud: . No olvide añadir la autorización como antes.

2. En"Texto"utilice este objeto JSON para crear el cliente:

{
  "email": "a.briann@gmail.com",
  "nombre": "Brian",
  
  "role": "customer", "username": "abraham", "abraham
  
  "facturación": {
    "first_name": "Brian", "last_name": "Abraham", "billing": {
    
    "empresa": "", "dirección_1".
    "address_1": "969 Market", "address_2": "", "address_2": "969 Market", "address_3": "969 Market
    "address_2": "", "city": "San Francisco".
    
    "estado": "CA", "código postal": "9410".
    
    
    "correo electrónico": "a.brian@gmail.com", "teléfono":"(555)
    "phone": "(555) 555-5555"
  }, "shipping": {{{{{}}}
  "shipping": {
    
    "last_name": "Abraham", "company": ",
    "company": "", "address_1".
    "address_1": "969 Market", "address_2": ",
    "address_2": "", "city": "San Francisco".
    
    "state": "CA", "postcode": "9410".
    "postcode": "94103", "country": "US".
    "country": "US"
  }
}

El objeto JSON contiene datos básicos del cliente, como correo electrónico, nombre, función y nombre de usuario. También proporciona información de facturación y envío, incluida la dirección, la ubicación y el número de teléfono del cliente.

3. Ejecute la solicitud y recibirá una respuesta que contiene el objeto cliente. Recuerde el ID de cliente, lo utilizará para recuperar el cliente en la siguiente sección.

resúmenes

La API REST de WooCommerce es una potente herramienta que facilita la gestión programática de los datos de la tienda, mejora la experiencia de compra del comercio electrónico y amplía la funcionalidad de tu tienda online. Con ella, una configuración normal de WordPress puede transformarse en una plataforma más potente. Para empezar, todo lo que tienes que hacer es instalar el plugin de WooCommerce en tu aplicación de WordPress y consultar los ejemplos de este artículo para explorar las distintas funciones de la API REST. Estos ejemplos serán la base de tu solución personalizada.

La velocidad es un factor clave para los sitios de comercio electrónico; cuanto más rápido se cargue una página, mejor será la experiencia de compra para los clientes. Y la API de WooCommerce admite múltiples solicitudes desde el front-end al back-end de WordPress, lo que subraya la importancia de optimizar el rendimiento del back-end. Con ella, tu sitio web funcionará mejor y ofrecerá a tus clientes una mejor experiencia de compra.

Contacte con nosotros
¿No puede leer el tutorial? Póngase en contacto con nosotros para obtener una respuesta gratuita. Ayuda gratuita para sitios personales y de pequeñas empresas	Servicio de atención al cliente WeChat
① Tel: 020-2206-9892
② QQ咨询：1025174874
(iii) Correo electrónico: info@361sale.com
④ Horario de trabajo: de lunes a viernes, de 9:30 a 18:30, días festivos libres