1. Accueil
  2. Docs
  3. Documentation Amzpecty
  4. Spécifications de l'API Amzpecty
  5. API de variantes de produits

API de variantes de produits

AJOUTER UN ASIN PARENT À LA QUEUE DE REQUÊTE DES VARIATIONS DE PRODUIT

La demande d'ajout d'un ASIN parent à la file d'attente de requêtes de variantes de produit.

DÉDUCTION DE CRÉDIT

1 (un) crédit de déduction pour chaque variante après récupération réussie des données. Exemple : S'il y a 5 variantes, 5 (cinq) crédits seront déduits si les informations des 5 variantes sont récupérées avec succès.

DEMANDE
URI /api/query/requestvariants/ {PARENTASIN}?domain={domain}&secretKey={secretKey} {PARENTASIN } – obligatoire – l'ASIN parent à ajouter à la file d'attente de recherche de variantes {domaine} – facultatif – par défaut www.amazon.com s'il n'est pas spécifié. Voir Domaines Amazon pris en charge pour la liste.
En-tête HTTP (facultatif) AMZPECTY_CALLBACK_URL={Votre URL de rappel}
Exemple /api/query/requestvariants/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx
RÉPONSE
En-têtes
Type de support application / json
Données JSON
JSON
{
  "status": "OK",
  "allowed": 999,
  "dailyAllowed": 100,
  "messageId": null,
  "message": null,
  "data": null,
  "rid": "5e70778ce4b09ae7cdd98243",
  "dateProcessed": null
}

RAPPEL DE REQUÊTE DE VARIATIONS DE PRODUIT

DEMANDE DE RAPPEL DE REQUÊTE DE VARIATIONS DE PRODUIT
URI Exemple : https://your.server.com/amzpecty_result {Veuillez fournir l'URL dans la page Préférences} L'URL doit être activée pour SSL. AMZPECTY-API-SECRET-KEY (nom de l'en-tête) – l'en-tête de clé secrète sera inclus pour que le serveur de rappel valide l'origine de la demande
Type de support application / json
VARIATIONS DU PRODUIT RAPPEL DE REQUÊTE ÉCHANTILLONS DE DONNÉES JSON
En-têtes
Type de support application / json
Données 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
}
VARIATIONS DU PRODUIT RÉPONSE DE RAPPEL À LA REQUÊTE ATTRIBUTS JSON
Nom d'attributDétails
statutsLe statut de la demande.
réponsepourValeur « productvariations » pour le résultat de la requête Variations de produit
permisLe nombre de demandes actuellement autorisées. Se réinitialise mensuellement.
quotidiennementAutoriséNombre de demandes quotidiennes actuellement autorisées. Se réinitialise quotidiennement.
ID du messageL'identifiant du message (le cas échéant).
messageLe message réel (le cas échéant). Veuillez vous référer à Messages d'erreur.
débarrasserL’identifiant de la demande. Cela peut être utilisé pour faire correspondre cette réponse à la demande initiale.
dateTraitéDate à laquelle la demande a été traitée au format d'heure Unix.
domaineLe domaine Amazon cible.
totalCréditsDéduitCe champ indique combien de crédits API Amzpecty ont été utilisés pour répondre à cette demande.
data.parentAsinL'ASIN parent des variantes du produit.
données. nom de l'articleLe nom de l'élément du produit.
données. classement des ventesLe classement des ventes du produit parent.
données. options[]La liste des options disponibles. Par exemple [ "Taille", "Couleur" ]
data.totalVariationsNombre total de variantes pour l'Asin parent.
données. variantes[]La liste des variantes du Parent Asin.
data.variants[n].asinL'Asin de cette variante.
data.variants[n].productUrlL'URL du produit de cette variante.
data.variants[n].option1La clé de cette première option telle que répertoriée sur data.options[]. Par exemple, « Taille »
data.variants[n].option1ValueLa valeur de cette première option. Par exemple, « 9 »
data.variants[n].option2La clé de cette deuxième option telle que répertoriée sur data.options[]. Par exemple "Couleur"
data.variants[n].option2ValueLa valeur de cette deuxième option. Par exemple, « Jaune Yellowstone »
data.variants[n].option*La clé de cette nième option telle que répertoriée sur data.options[].
data.variants[n].option*ValeurLa valeur de cette nième option.
data.variants[n].BBSellerNameLe nom du vendeur buybox de cette variante.
data.variants[n].BBPrixLe prix buybox de cette variante hors frais de port.
data.variants[n].BBQuantitéLa quantité disponible pour le vendeur buybox de cette variante.
data.variants[n].BBTypeType de vendeur de cette variante. « Expédié par Amazon » ou « FBM »
data.variants[n].salesRankLe classement des ventes de cette variante.
data.variants[n].totalOffersLe nombre d'offres de cette variante.
data.variants[n].dimensionLa dimension de cette variante.
data.variants[n].imageUrlL'URL de l'image de cette variante.
data.variants[n].poidsLe poids de cette variante.
data.variants[n].reviewPercentageCette variante (nombre d'avis / nombre d'avis) X 100 .
data.variants[n].reviewCountDÉCONSEILLÉ depuis le 11 septembre 2020. Utilisez plutôt globalReviewPositive et globalReviewCritical.
data.variants[n].globalRatingsPositiveNOUVEAU. Ajouté le 11 septembre 2020. Nombre total d’évaluations positives mondiales pour cette variante.
data.variants[n].globalRatingsCriticalNOUVEAU. Ajouté le 11 septembre 2020. Le nombre total de notes critiques mondiales de cette variante.
data.variants[n].globalReviewPositiveNOUVEAU. Ajouté le 11 septembre 2020. Nombre total d’avis positifs dans le monde pour cette variante.
data.variants[n].globalReviewCriticalNOUVEAU. Ajouté le 11 septembre 2020. Nombre total d’examens critiques mondiaux de cette variante.
data.variants[n].recentReviewDate de révision la plus récente de cette variante.
data.variants[n].searchStatusStatut de requête de cette variante. « en cours » ou « terminé »

OBTENIR LES DONNÉES DE RÉSULTAT DE LA REQUÊTE SUR LES VARIATIONS DU PRODUIT PAR ASIN PARENT

0 (zéro) déduction de crédit pour l’appel Get.

La demande d'obtention des données de résultat de la requête Variations de produit par ASIN parent.

DEMANDE
URI /api/query/getmatchasins/rid/{rid}?domain={domain}&secretKey={secretKey} { PARENTASIN } – l'ASIN parent pour obtenir la liste de variantes la plus récente {domaine} – facultatif – par défaut www.amazon.com s'il n'est pas spécifié. Voir Domaines Amazon pris en charge pour la liste.
Exemple /api/query/getvariants/asin/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx
RÉPONSE

See Variations du produit Requête de rappel Exemples de données JSON

OBTENIR LES DONNÉES DE RÉSULTAT DE LA DEMANDE DE VARIATIONS DE PRODUIT PAR ID DE DEMANDE

La demande pour obtenir les données de résultat de la requête sur les variantes de produit par ID de demande.

DÉDUCTION DE CRÉDIT

0 (zéro) déduction de crédit pour l’appel Get.

DEMANDE
URI /api/query/getvariants/rid/{ RID }?domain={domain}&secretKey={secretKey} { RID } – l'ID de demande pour obtenir la liste de variantes la plus récente {domaine} – facultatif – par défaut www.amazon.com s'il n'est pas spécifié. Voir Domaines Amazon pris en charge pour la liste.
Exemple /api/query/getvariants/rid/ 5e712345e4b04dd8c8b7e490?domain=www.amazon.com&secretKey= xxxxxxxxxx
RÉPONSE

See Variations du produit Requête de rappel Exemples de données JSON

Cet article vous a-t-il été utile ? Oui Non
Comment pouvons-nous vous aider ?