PRÉ-REQUIS : URL DE RAPPEL DU RÉSULTAT DE LA REQUÊTE POUR LES WEBHOOKS
Amzpecty nécessite une URL de rappel pour les notifications de l'API push de données Webhook. Ils informent votre application des résultats de la requête (y compris la charge utile des données). L'URL de rappel doit être accessible globalement, via le protocole https POST et avec un certificat SSL valide. Amzpecty peut ne pas être en mesure d'envoyer avec succès des webhooks à des certificats SSL auto-signés.
En Java, vous pouvez utiliser HttpServlet avec la méthode doPost pour recevoir la charge utile des données Amzpecty. Dans d'autres langages de programmation, vous pouvez implémenter la même solution équivalente. Vous pouvez implémenter votre écouteur webhook à l'aide de n'importe quel langage de programmation prenant en charge le protocole HTTPS Post.
Veuillez vous assurer que votre URL de rappel est prête et saisie dans le champ Tableau de bord Amzpecty https://api.amzpecty.com/preferences. Une fois qu'Amzpecty a fini de rechercher les données, Amzpecty publiera HTTPS sur cette URL les données de résultat au format JSON. Lorsque l’en-tête AMZPECTY_CALLBACK_URL est ajouté à l’appel de requête, il aura priorité sur les paramètres d’URL de rappel des préférences.
Un en-tête http nommé AMZPECTY-API-SECRET-KEY sera inclus dans la publication https pour que l'écouteur du webhook puisse valider l'origine de la requête.
ÉTAPES ET PROCÉDURE
- Passer un appel Ajouter [ Ajouter un Asin/ISBN à la file d'attente de requêtes d'instantanés Asin ] ou [Ajouter un Asin parent à la file d'attente de requêtes de variantes de produit] ou [ Faire correspondre l'ID du produit à la file d'attente de requêtes ASIN ] etc. pour placer votre demande dans la file d'attente des requêtes.
- Le serveur API Amzpecty appellera votre URL de rappel pour envoyer les résultats dès que la recherche est terminée.
- Votre application peut utiliser le débarras de la réponse Ajouter un appel pour faire correspondre le rappel à votre demande initiale.
Remarque: Pour les appels sans variante, veuillez vous assurer que l'ASIN n'est pas un ASIN parent ou un ASIN abandonné.
Vous n’avez pas besoin d’effectuer la requête Get facultative à moins qu’un temps considérable ne se soit écoulé et qu’aucun rappel ne soit reçu. Veuillez vous abstenir de faire des appels d'ajout successifs du même ASIN.
REMPLACEMENT DE L'AGENT UTILISATEUR
Les clients peuvent remplacer l'en-tête User-Agent par défaut pour un en-tête spécifique en spécifiant la clé et la valeur AMZPECTY-USER-AGENT lors d'un appel Add.
L'API Amzpecty définira la valeur User-Agent lors des appels post-back.
CODAGE
- Le codage des données de requête/réponse doit être UTF-8
POINT DE FIN
Contactez l'assistance pour les URL personnalisées pour les serveurs exclusifs ou personnalisés.
SÛRETÉ
- Toutes les connexions d'échange de données entre Amzpecty et les pairs doivent se faire via HTTPS (SSL/TLS) avec un certificat SSL valide
- Amzpecty émettra une clé secrète pour l'authentification de la demande (le nom du paramètre est secretKey) – La clé secrète se trouve sur la page Préférences > API Amzpect > Votre clé secrète API.
TEMPS DE RÉPONSE À LA REQUÊTE
Bien que nous fassions de notre mieux pour traiter toutes les demandes de requête dans les meilleurs délais, nous ne garantissons pas la rapidité du rappel des résultats. Veuillez tenir compte des délais de réponse dans votre mise en œuvre.
DEMANDE D'ACCÉLÉRATEUR
Veuillez vous assurer que vos requêtes sont définies à des intervalles d'au moins 1 à 2 secondes pour éviter les appels d'API rejetés. Nous avons mis en place des contrôles pour éviter les demandes excessives de rafales. Veuillez contacter l'assistance pour les exceptions sur les serveurs personnalisés.
DÉDUCTIONS DE CRÉDIT
Le crédit n'est déduit qu'une fois la récupération réussie des données. Les appels comme Get by RID ne déduiront aucun crédit.
