https://api.nexscope.ai/woocommerce/productVariationsEjecutar esta API
Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.
Endpoint
| Método | POST |
| Ruta | https://api.nexscope.ai/woocommerce/productVariations |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
storeUrl | string | obligatorio | Público HTTPS almacenar raíz o ruta de instalación de WordPress, sin consulta o fragmento. Ejemplo: https://example.com |
productId | string | obligatorio | ID del producto positivo de la pantalla de almacenamiento, como máximo 19 dígitos decimales. Ejemplo: 34 |
pageNum | integer | opcional | Número de página, por defecto 1. Ejemplo: 1 |
pageSize | integer | opcional | Tamaño de página, por defecto 20, máximo 100. Ejemplo: 20 |
Respuesta de ejemplo
Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.
{
"code": 0,
"cost": "-1",
"data": {
"cacheHit": false,
"fetchedAt": "1792972800000",
"hasMore": false,
"pageNum": 1,
"pageSize": 20,
"parentId": "34",
"products": [
{
"description": "Cotton shirt.",
"id": "34",
"images": [
{
"alt": "Shirt",
"url": "https://example.com/image.jpg"
}
],
"isInStock": true,
"isPasswordProtected": false,
"name": "Cotton Shirt",
"prices": {
"currency": "USD",
"minorUnit": 2,
"price": "11.05"
},
"shortDescription": "Cotton shirt.",
"sku": "SHIRT-34",
"type": "simple",
"url": "https://example.com/product/shirt",
"variation": ""
}
],
"storeUrl": "https://example.com",
"total": 1,
"totalPages": 1
},
"msg": null,
"time": "2026-01-01 00:00:00",
"traceId": null,
"ts": "0"
}Campos de respuesta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | integer | obligatorio | 0 significa aceptado o exitoso; no cero es un error de plataforma. |
cost | string | obligatorio | Se pasó milisegundos, nunca créditos; -1 peticiones externas de la web. |
data | any | obligatorio | Valor de Data usado por esta operación de API. |
msg | string | null | obligatorio | Valor de Msg usado por esta operación de API. |
time | string | obligatorio | Hora local del servidor: aaaa-mm-dd HH:mm:ss. |
traceId | string | null | obligatorio | Valor de Trace id usado por esta operación de API. |
ts | string | obligatorio | Epoch milisegundos. |
Opción 1 de cualquier alternativa — requiere storeUrl, fetchedAt, cacheHit, products, pageNum, pageSize, parentId
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data | object | obligatorio | Valor de Data usado por esta operación de API. |
data.cacheHit | boolean | obligatorio | Si la respuesta fue enviada desde el caché anónimo de 60 segundos. Ejemplo: false |
data.fetchedAt | string | obligatorio | Obtener tiempo en milisegundos de época, no el tiempo de modificación del producto. Ejemplo: 1792972800000 |
data.hasMore | any | opcional | Valor de Has more usado por esta operación de API. |
data.pageNum | integer | obligatorio | Metadatos de paginación; los totales son nulos cuando la tienda omite las cabeceras. Ejemplo: 1 |
data.pageSize | integer | obligatorio | Metadatos de paginación; los totales son nulos cuando la tienda omite las cabeceras. Ejemplo: 20 |
data.parentId | string | obligatorio | Identificación del producto padre solicitado; cada SKU Debe coincidir con él. Ejemplo: 34 |
data.products | array | obligatorio | Productos públicos normalizados. Ejemplo: [] |
data.products[] | object | obligatorio | Elemento de data products. |
data.products[].description | any | opcional | Valor de Description usado por esta operación de API. |
data.products[].id | any | opcional | Valor de Id usado por esta operación de API. |
data.products[].images | array | obligatorio | URLs de imagen pública; las imágenes no son obtenidas por esto API. Ejemplo: [] |
data.products[].images[] | object | obligatorio | Elemento de data products[] images. |
data.products[].images[].alt | string | obligatorio | Etiqueta alternativa de texto plano. Ejemplo: Shirt |
data.products[].images[].url | string | obligatorio | Imagen URL. Ejemplo: https://example.com/image.jpg |
data.products[].isInStock | any | opcional | Valor de Is in stock usado por esta operación de API. |
data.products[].isPasswordProtected | any | opcional | Valor de Is password protected usado por esta operación de API. |
data.products[].name | any | opcional | Valor de Name usado por esta operación de API. |
data.products[].parentId | any | opcional | Valor de Parent id usado por esta operación de API. |
data.products[].prices | object | obligatorio | Precios de tienda anónimos; los valores decimales son cadenas para una precisión exacta. Ejemplo: {} |
data.products[].prices.currency | string | obligatorio | Código de moneda. Ejemplo: USD |
data.products[].prices.maxPrice | any | opcional | Valor de Max price usado por esta operación de API. |
data.products[].prices.maxPriceMinor | any | opcional | Valor de Max price minor usado por esta operación de API. |
data.products[].prices.minPrice | any | opcional | Valor de Min price usado por esta operación de API. |
data.products[].prices.minPriceMinor | any | opcional | Valor de Min price minor usado por esta operación de API. |
data.products[].prices.minorUnit | integer | obligatorio | Precisión decimal de la moneda. Ejemplo: 2 |
data.products[].prices.price | any | opcional | Valor de Price usado por esta operación de API. |
data.products[].prices.priceMinor | any | opcional | Valor de Price minor usado por esta operación de API. |
data.products[].prices.regularPrice | any | opcional | Valor de Regular price usado por esta operación de API. |
data.products[].prices.regularPriceMinor | any | opcional | Valor de Regular price minor usado por esta operación de API. |
data.products[].prices.salePrice | any | opcional | Valor de Sale price usado por esta operación de API. |
data.products[].prices.salePriceMinor | any | opcional | Valor de Sale price minor usado por esta operación de API. |
data.products[].shortDescription | any | opcional | Valor de Short description usado por esta operación de API. |
data.products[].sku | any | opcional | Valor de Sku usado por esta operación de API. |
data.products[].stockQuantity | any | opcional | Valor de Stock quantity usado por esta operación de API. |
data.products[].type | any | opcional | Valor de Type usado por esta operación de API. |
data.products[].url | any | opcional | Valor de Url usado por esta operación de API. |
data.products[].variation | any | opcional | Valor de Variation usado por esta operación de API. |
data.storeUrl | string | obligatorio | Identidad de tienda normalizada. Ejemplo: https://example.com |
data.total | any | opcional | Valor de Total usado por esta operación de API. |
data.totalPages | any | opcional | Valor de Total pages usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.hasMore | boolean | opcional | Nul cuando no se dispone de páginas totales. Ejemplo: false |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.hasMore | null | opcional | Valor de Has more usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].description | string | opcional | Texto plano o identificador de producto público. Ejemplo: Cotton shirt. |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].description | null | opcional | Valor de Description usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].id | string | opcional | Texto plano o identificador de producto público. Ejemplo: 34 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].id | null | opcional | Valor de Id usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].isInStock | boolean | opcional | Almacenar valor, nulo cuando no esté disponible. Ejemplo: true |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].isInStock | null | opcional | Valor de Is in stock usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].isPasswordProtected | boolean | opcional | Almacenar valor, nulo cuando no esté disponible. Ejemplo: false |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].isPasswordProtected | null | opcional | Valor de Is password protected usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].name | string | opcional | Texto plano o identificador de producto público. Ejemplo: Cotton Shirt |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].name | null | opcional | Valor de Name usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].parentId | string | opcional | Almacenar valor; null cuando no esté disponible. Ejemplo: null |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].parentId | null | opcional | Valor de Parent id usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].prices.maxPrice | string | opcional | Cantidad exacta string; null cuando no está disponible. Sufijo menor denota la cantidad original más pequeña-unidad. Ejemplo: null |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].prices.maxPrice | null | opcional | Valor de Max price usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].prices.maxPriceMinor | string | opcional | Cantidad exacta string; null cuando no está disponible. Sufijo menor denota la cantidad original más pequeña-unidad. Ejemplo: null |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].prices.maxPriceMinor | null | opcional | Valor de Max price minor usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].prices.minPrice | string | opcional | Cantidad exacta string; null cuando no está disponible. Sufijo menor denota la cantidad original más pequeña-unidad. Ejemplo: null |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].prices.minPrice | null | opcional | Valor de Min price usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].prices.minPriceMinor | string | opcional | Cantidad exacta string; null cuando no está disponible. Sufijo menor denota la cantidad original más pequeña-unidad. Ejemplo: null |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].prices.minPriceMinor | null | opcional | Valor de Min price minor usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].prices.price | string | opcional | Cantidad exacta string; null cuando no está disponible. Sufijo menor denota la cantidad original más pequeña-unidad. Ejemplo: 11.05 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].prices.price | null | opcional | Valor de Price usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].prices.priceMinor | string | opcional | Cantidad exacta string; null cuando no está disponible. Sufijo menor denota la cantidad original más pequeña-unidad. Ejemplo: null |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].prices.priceMinor | null | opcional | Valor de Price minor usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].prices.regularPrice | string | opcional | Cantidad exacta string; null cuando no está disponible. Sufijo menor denota la cantidad original más pequeña-unidad. Ejemplo: null |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].prices.regularPrice | null | opcional | Valor de Regular price usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].prices.regularPriceMinor | string | opcional | Cantidad exacta string; null cuando no está disponible. Sufijo menor denota la cantidad original más pequeña-unidad. Ejemplo: null |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].prices.regularPriceMinor | null | opcional | Valor de Regular price minor usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].prices.salePrice | string | opcional | Cantidad exacta string; null cuando no está disponible. Sufijo menor denota la cantidad original más pequeña-unidad. Ejemplo: null |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].prices.salePrice | null | opcional | Valor de Sale price usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].prices.salePriceMinor | string | opcional | Cantidad exacta string; null cuando no está disponible. Sufijo menor denota la cantidad original más pequeña-unidad. Ejemplo: null |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].prices.salePriceMinor | null | opcional | Valor de Sale price minor usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].shortDescription | string | opcional | Texto plano o identificador de producto público. Ejemplo: Cotton shirt. |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].shortDescription | null | opcional | Valor de Short description usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].sku | string | opcional | Texto plano o identificador de producto público. Ejemplo: SHIRT-34 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].sku | null | opcional | Valor de Sku usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].stockQuantity | integer | opcional | Siempre null: tienda pública API no expone el inventario exacto. Ejemplo: null |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].stockQuantity | null | opcional | Valor de Stock quantity usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].type | string | opcional | Almacenar valor; null cuando no esté disponible. Ejemplo: simple |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].type | null | opcional | Valor de Type usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].url | string | opcional | Texto plano o identificador de producto público. Ejemplo: https://example.com/product/shirt |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].url | null | opcional | Valor de Url usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].variation | string | opcional | Texto plano o identificador de producto público. Ejemplo: |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.products[].variation | null | opcional | Valor de Variation usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.total | integer | opcional | Metadatos de paginación; los totales son nulos cuando la tienda omite las cabeceras. Ejemplo: 1 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.total | null | opcional | Valor de Total usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.totalPages | integer | opcional | Metadatos de paginación; los totales son nulos cuando la tienda omite las cabeceras. Ejemplo: 1 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.totalPages | null | opcional | Valor de Total pages usado por esta operación de API. |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data | null | obligatorio | Valor de Data usado por esta operación de API. |
Respuestas
| Código | Descripción |
|---|---|
| 200 | Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado. |
| 429 | Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente. |
| 503 | La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente. |
| Opcional | X-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como la ausencia de una clave API (code 11209), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200. |
Fuente de datos, vigencia y limitaciones
La fuente, la vigencia, la cobertura, los límites de frecuencia y las notas de estimación no se especifican en esta definición de API salvo que aparezcan en la documentación de campos de solicitud o respuesta anterior. No supongas datos oficiales del mercado ni actualización en tiempo real cuando no estén documentados explícitamente.