Desarrollo De Plugins API En Woocommerce

Llave de acceso: cuándo autenticar en REST

¿Cómo saber si una llamada a la REST API de WooCommerce va autenticada y con permisos mínimos? En esta sección se describe cómo usar API Keys para autenticar peticiones REST, definir el usuario y limitar el alcance para reducir exposición de credenciales. Se aplica cuando integras un plugin con endpoints de WooCommerce desde servidor a servidor.

Puntos de control para consumir endpoints

• Autenticación: usa `consumer_key` y `consumer_secret` como credenciales HTTP Basic vía librería (o firma equivalente que exponga la librería).
• Base REST: `/wp-json/wc/v3/`
• Métodos típicos:
• `GET` (consultas): productos, pedidos, clientes
• `POST` (creación): creación de recursos (p. ej. pedidos/actualizaciones según endpoint)
• `PUT`/`PATCH` (actualización): cambios de recursos
• Parámetros relevantes:
• `per_page`, `page` (paginación)
• `orderby`, `order` (orden)
• `context` (en algunos endpoints: `view`/`edit`)

Opciones y parámetros del esquema de autenticación (API Keys)

Ejemplo funcional con API Keys desde PHP (cliente server-side)

 true,
    'consumer_key' => $consumerKey,
    'consumer_secret' => $consumerSecret,
    'version' => 'wc/v3',
    'query_string_auth' => false, // evita pasar secretos en la query
  ]
);

// Llamada autenticada: listar productos paginados
$response = $woocommerce->get('products', [
  'per_page' => 20,
  'page' => 1,
  'orderby' => 'date',
  'order' => 'desc',
]);

// $response es un array/objeto según el cliente
var_dump($response);

Estructura esperada de la respuesta JSON (ejemplo: listado de productos)

[
  {
    "id": 123,
    "name": "Camiseta técnica",
    "slug": "camiseta-tecnica",
    "permalink": "https://tudominio.com/product/camiseta-tecnica/",
    "date_created": "2026-01-15T10:22:33",
    "date_modified": "2026-02-01T08:10:05",
    "status": "publish",
    "type": "simple",
    "sku": "SKU-TECN-001"
  }
]

Campos clave:

• `id` (number): identificador del recurso
• `name` (string): nombre visible
• `status` (string): estado del producto (`publish`, `draft`, etc.)
• `date_created` / `date_modified` (string ISO-8601): timestamps
• `sku` (string|null): SKU si existe

Consideraciones al usar API Keys en WooCommerce

• Permisos mínimos: crea un usuario REST con solo capacidades necesarias (p. ej. lectura de productos vs. edición/pedidos), evitando acceso global.
• No exponer credenciales: nunca embebas `consumer_secret` en frontend; usa variables de entorno y configura el plugin para leerlas desde el servidor.
• Manejo de errores: contempla `401/403` (credenciales/permisos) y `429` (limitación por tasa). Loguea `status code` y cuerpo.
• Paginación y límites: usa `per_page` y `page` para no saturar el servidor; respeta tiempos de respuesta y aplica `timeout`.

La siguiente sección aterriza la configuración del usuario REST en el panel de WordPress y cómo traducir “permisos mínimos” a un set concreto de capacidades para cada endpoint.