AÑADIR ASIN PRINCIPAL A LA COLA DE CONSULTAS DE VARIACIONES DE PRODUCTO
La solicitud para agregar un ASIN principal a la cola de consultas de Variaciones de productos.
DEDUCCIÓN DE CRÉDITO
1 (una) deducción de crédito por cada variante después de la recuperación exitosa de los datos. Ejemplo: si hay 5 variantes, se deducirán 5 (cinco) créditos si se recupera con éxito la información de las 5 variantes.
SOLICITAR
| URI | /api/query/requestvariants/ {PARENTASIN}?domain={dominio}&secretKey={secretKey} | {PARENTASIN }: obligatorio: el ASIN principal que se agregará a la cola de búsqueda de variantes. {dominio}: opcional: el valor predeterminado es www.amazon.com si no se especifica. Ver Dominios de Amazon compatibles para la lista. |
| Encabezado HTTP (opcional) | AMZPECTY_CALLBACK_URL={Su URL de devolución de llamada} | |
| Ejemplo | /api/query/requestvariants/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx | |
RESPUESTA
| Cabezales | |
| Tipo de medios | aplicación / json |
| Datos JSON |
JSON
{
"status": "OK",
"allowed": 999,
"dailyAllowed": 100,
"messageId": null,
"message": null,
"data": null,
"rid": "5e70778ce4b09ae7cdd98243",
"dateProcessed": null
}CONSULTA DE VARIACIONES DE PRODUCTO DEVOLUCIÓN DE LLAMADA
CONSULTA DE VARIACIONES DE PRODUCTO SOLICITUD DE DEVOLUCIÓN DE LLAMADA
| URI | Ejemplo: https://your.server.com/amzpecty_result | {Proporcione la URL en la página de preferencias} La URL debe tener SSL habilitado. AMZPECTY-API-SECRET-KEY (nombre del encabezado): se incluirá el encabezado de la clave secreta para que el servidor de devolución de llamada valide el origen de la solicitud. |
| Tipo de medios | aplicación / json |
VARIACIONES DE PRODUCTO CONSULTA DEVOLUCIÓN DE LLAMADA DATOS DE MUESTRA JSON
| Cabezales | |
| Tipo de medios | aplicación / json |
| Datos JSON |
JSON
{
"status": "OK",
"responsefor": "productvariations",
"allowed": 142658,
"dailyAllowed": 9828,
"messageId": null,
"message": null,
"data": {
"parentAsin": "B077HN95T8",
"itemName": "Pendleton Women’s Heritage Chelsea Slip-Resistant Rain Boot",
"salesRank": 31070,
"options": [
"Size",
"Color"
],
"totalVariations": 86,
"variants": [
{
"asin": "B0772WW76G",
"productUrl": "https://www.amazon.com/dp/B0772WW76G?th=1&psc=1",
"option1": "Size",
"option1Value": "6",
"option2": "Color",
"option2Value": "Rainier Red",
"BBSellerName": "Fishbone Apparel",
"BBPrice": 109.95,
"BBQuantity": 2,
"BBType": "FBA",
"salesRank": 31070,
"totalOffers": 1,
"dimension": "3.8 x 9.5 x 11.7 inches",
"imageUrl": "https://m.media-amazon.com/images/I/31wd4kuv6IL._SCLZZZZZZZ__SL80_.jpg",
"weight": "3.351 pounds",
"reviewPercentage": 2.08,
"reviewCount": 2,
"globalRatingsPositive": 4486,
"globalRatingsCritical": 421,
"globalReviewPositive": 1286,
"globalReviewCritical": 271,
"recentReview": "March 7, 2020",
"searchStatus": "completed"
},
{
"asin": "B07PJT8S6K",
"productUrl": "https://www.amazon.com/dp/B07PJT8S6K?th=1&psc=1",
"option1": "Size",
"option1Value": "6",
"option2": "Color",
"option2Value": "Starwatchers Blue Print",
"BBSellerName": "new pairs",
"BBPrice": 109.95,
"BBQuantity": 2,
"BBType": "FBA",
"salesRank": 31070,
"totalOffers": 1,
"dimension": "4.25 x 10.87 x 13.07 inches",
"imageUrl": "https://m.media-amazon.com/images/I/41ooAxDOy5L._SCLZZZZZZZ__SL80_.jpg",
"weight": "3.4502 pounds",
"reviewPercentage": 0,
"reviewCount": 0,
"globalRatingsPositive": 0,
"globalRatingsCritical": 0,
"globalReviewPositive": 0,
"globalReviewCritical": 0,
"recentReview": "",
"searchStatus": "completed"
}
]
},
"rid": "5e70778ce4b09ae7cdd98243",
"dateProcessed": 1584429103564,
"domain": "www.amazon.com",
"totalCreditsDeducted": 1
}VARIACIONES DE PRODUCTO CONSULTA DEVOLUCIÓN DE LLAMADA RESPUESTA ATRIBUTOS JSON
| Nombre del Atributo | Detalles |
|---|---|
| estado | El estado de la solicitud. |
| respuesta para | Valor de “variaciones de producto” para el resultado de la consulta Variaciones de producto |
| permitido | El recuento de solicitudes permitidas actualmente. Se reinicia mensualmente. |
| diarioPermitido | El recuento de solicitudes diarias permitidas actualmente. Se reinicia diariamente. |
| mensajeId | La identificación del mensaje (si corresponde). |
| mensaje | El mensaje real (si lo hay). Por favor consulte Mensajes de error. |
| librar | La identificación de la solicitud. Esto se puede utilizar para hacer coincidir esta respuesta con la solicitud original. |
| fechaProcesado | La fecha en que se procesó la solicitud en formato de hora Unix. |
| dominio | El dominio de Amazon de destino. |
| totalCréditosDeducidos | Este campo indica cuántos créditos API de Amzpecty se utilizaron para cumplir con esta solicitud. |
| datos.parentAsin | El ASIN principal de las variantes del producto. |
| datos. nombre del árticulo | El nombre del artículo del producto. |
| datos. Rango de ventas | El rango de ventas del producto principal. |
| datos. opciones[] | La lista de opciones disponibles. Por ejemplo, [“Tamaño”, “Color”] |
| datos.totalVariaciones | El número total de variaciones para el Asin principal. |
| datos. variantes[] | La lista de variantes del Asin principal. |
| datos.variantes[n].asin | El Asin de esta variante. |
| datos.variantes[n].productUrl | La URL del producto de esta variante. |
| datos.variantes[n].opción1 | La clave para esta primera opción aparece en data.options[]. Por ejemplo, "tamaño" |
| datos.variantes[n].opción1Valor | El valor de esta primera opción. Por ejemplo, "9" |
| datos.variantes[n].opción2 | La clave para esta segunda opción aparece en data.options[]. Por ejemplo, "color" |
| datos.variantes[n].opción2Valor | El valor de esta segunda opción. Por ejemplo, “amarillo Yellowstone” |
| datos.variantes[n].opción* | La clave para esta enésima opción que figura en data.options[]. |
| datos.variantes[n].opción*Valor | El valor de esta enésima opción. |
| datos.variantes[n].BBSellerName | El nombre del vendedor de Buybox de esta variante. |
| datos.variantes[n].BBPrice | El precio de buybox de esta variante sin incluir el envío. |
| datos.variantes[n].BBCantidad | La cantidad disponible para el vendedor de Buybox de esta variante. |
| datos.variantes[n].BBType | El tipo de vendedor de esta variante. “FBA” o “FBM” |
| datos.variantes[n].salesRank | El rango de ventas de esta variante. |
| datos.variantes[n].totalOfertas | El número de ofertas de esta variante. |
| datos.variantes[n].dimensión | La dimensión de esta variante. |
| datos.variantes[n].imageUrl | La URL de la imagen de esta variante. |
| datos.variantes[n].peso | El peso de esta variante. |
| datos.variantes[n].porcentajederevisión | Esta variante (recuento de reseñas / recuento de todas las reseñas) X 100. |
| DEPRECADO a partir del 11 de septiembre de 2020. Utilice globalReviewPositive y globalReviewCritical en su lugar. | |
| datos.variantes[n].globalRatingsPositive | NUEVO. Agregado el 11 de septiembre de 2020. El recuento total de calificaciones positivas globales de esta variante. |
| data.variants[n].globalRatingsCritical | NUEVO. Agregado el 11 de septiembre de 2020. El recuento total de calificaciones críticas globales de esta variante. |
| datos.variantes[n].globalReviewPositive | NUEVO. Agregado el 11 de septiembre de 2020. El recuento total de revisiones positivas globales de esta variante. |
| datos.variantes[n].globalReviewCritical | NUEVO. Agregado el 11 de septiembre de 2020. El recuento total de revisiones críticas globales de esta variante. |
| datos.variantes[n].revisiónreciente | Fecha de revisión más reciente de esta variante. |
| datos.variantes[n].estadodebúsqueda | El estado de la consulta de esta variante. “en curso” o “completado” |
OBTENER VARIACIONES DE PRODUCTOS CONSULTAR DATOS DE RESULTADOS POR ASIN PRINCIPAL
0 (cero) deducción de crédito por la llamada Get.
La solicitud para obtener los datos del resultado de la consulta de variaciones de producto por ASIN principal.
SOLICITAR
| URI | /api/query/getmatchasins/rid/{rid}?domain={dominio}&secretKey={secretKey} | { PARENTASIN } – el ASIN principal para obtener la lista de variantes más reciente {dominio} – opcional – el valor predeterminado es www.amazon.com si no se especifica. Ver Dominios de Amazon compatibles para la lista. |
| Ejemplo | /api/query/getvariants/asin/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx | |
RESPUESTA
See Consulta de variaciones de productos Datos de muestra JSON de devolución de llamada
OBTENER VARIACIONES DE PRODUCTOS SOLICITAR DATOS DE RESULTADOS MEDIANTE ID DE SOLICITUD
La solicitud para obtener los datos del resultado de la consulta de variaciones del producto por ID de solicitud.
DEDUCCIÓN DE CRÉDITO
0 (cero) deducción de crédito por la llamada Get.
SOLICITAR
| URI | /api/query/getvariants/rid/{ RID }?domain={dominio}&secretKey={secretKey} | {RID}: el ID de solicitud para obtener la lista de variantes más reciente {dominio} - opcional - el valor predeterminado es www.amazon.com si no se especifica. Ver Dominios de Amazon compatibles para la lista. |
| Ejemplo | /api/query/getvariants/rid/ 5e712345e4b04dd8c8b7e490?domain=www.amazon.com&secretKey= xxxxxxxxxx | |
RESPUESTA
See Consulta de variaciones de productos Datos de muestra JSON de devolución de llamada
