Bonnes pratiques relatives aux API

Voici les meilleures pratiques recommandées.

Ressource Products

Réduisez le nombre de demandes que vous envoyez en mettant à jour uniquement les produits qui ont changé.
Vous devez fournir une date d’expiration pour vos produits. Si ce n’est pas le cas, les produits expireront 30 jours à compter de la date à laquelle vous les ajoutez.
Veillez à mettre à jour vos produits avant leur expiration. Si un produit arrive à expiration, vous devez l’ajouter à nouveau, ce qui entraîne un délai pendant que le produit fait l’objet d’une révision éditoriale. Vous devez suivre les produits qui approchent de l’expiration et avant qu’ils expirent, mettez à jour leur date d’expiration ou mettez simplement à jour le produit (vous n’avez pas besoin de mettre à jour les champs du produit), ce qui étend automatiquement la date d’expiration de 30 jours. Si vous définissez explicitement la date d’expiration, vous devez définir vous-même une nouvelle date d’expiration. La mise à jour du produit ne prolongera pas automatiquement la date d’expiration de 30 jours dans ce cas.

Utilisez le traitement par lots chaque fois que vous traitez plusieurs éléments. L’utilisation du traitement par lots réduit les coûts généraux associés aux requêtes HTTP ; au lieu d’engager les coûts pour chaque élément si vous envoyiez les demandes individuellement, vous n’encourez le coût qu’une seule fois.
Pour les opérations par lots, utilisez le schéma de compression Gzip pour compresser le corps de la demande et de la réponse. Si vous utilisez la compression, incluez l’en-tête Content-Encoding de requête HTTP et définissez-le sur gzip. L’API de contenu prend uniquement en charge la compression Gzip.

Si vous envisagez d’offrir plus de 50 millions de produits, contactez votre responsable de compte Microsoft ou votre représentant du support technique avant de créer votre application.

Le rapport status catalogue contient TOUTES les offres précédemment chargées et rejetées au cours des 30 derniers jours. Étant donné que la taille du rapport peut être très importante en fonction de la quantité d’activité, vous devez limiter la fréquence à laquelle vous le demandez à toutes les heures.