Avec la pagination, vous récupérez un flux de produits par parties au lieu de recevoir tous les produits en une seule réponse. Combinez-la avec des filtres pour ne récupérer que les produits dont vous avez besoin.
Veuillez noter : la pagination ne fonctionne qu'avec une seule campagne par requête. Si vous combinez records avec plusieurs valeurs program_id[], vous recevez une erreur 400. Utilisez une URL de flux distincte pour chaque campagne.
Quand utiliser la pagination
Toujours. Sans le paramètre records, vous recevez le flux de produits complet en une seule réponse, ce qui peut représenter des centaines de mégaoctets ou plus pour les flux volumineux. Une requête s'arrête après environ 5 minutes : sans pagination, un flux volumineux sera donc incomplet.
Comment utiliser la pagination
- Ajoutez
&records=1000à l'URL du flux. Vous recevez les 1000 premiers produits. - Lisez l'en-tête de réponse
X-Next-Url. Il contient l'URL complète de la page suivante. - Appelez cette URL pour recevoir les 1000 produits suivants.
- Répétez jusqu'à ce que la réponse ne contienne plus d'en-tête
X-Next-Url. Vous avez alors tous les produits.
Utilisez toujours le X-Next-Url exactement tel que vous le recevez. Il ajoute une valeur search_after qui fait référence au dernier produit de la page précédente : vous ne pouvez donc pas la calculer vous-même. Cela signifie aussi que votre logiciel doit pouvoir lire les en-têtes de réponse. Si ce n'est pas le cas, utilisez des filtres pour garder le flux léger.
Chaque réponse contient aussi :
- X-Current-Count : le nombre de produits sur cette page. C'est la valeur que vous avez demandée, sauf pour la dernière page.
- X-Total-Count : le nombre total de produits dans le flux. Utilisez-le pour vérifier que vous avez reçu tous les produits.
Pagination et limite de requêtes
Chaque page compte comme une requête pour la limite de 30 requêtes par minute et par adresse IP. Demandez les pages les unes après les autres, jamais en même temps. Si vous recevez une réponse 429, attendez le nombre de secondes indiqué dans l'en-tête Retry-After avant de demander la page suivante. Pour en savoir plus, consultez Règles et consignes pour télécharger et traiter les flux de produits.
Exemple d'URL de flux avec pagination
Cet exemple demande un flux de produits avec 50 produits par page :
https://daisycon.io/datafeed/?media_id=22848&standard_id=1&language_code=fr&locale_id=3&type=xml&program_id=21835&records=50&encoding=utf8
Exemple d'en-têtes de réponse
Les en-têtes de réponse pour la requête ci-dessus :
X-Total-Count: 80 X-Current-Count: 50 X-Next-Url: https://daisycon.io/datafeed/?media_id=22848&standard_id=1&language_code=fr&locale_id=3&type=xml&program_id=21835&records=50&encoding=utf8&search_after=%5B%229ddb817799f9e33217cc07a4d6ff295e%22%5D
Ce flux contient 80 produits. La première requête renvoie 50 produits, la requête vers le X-Next-Url renvoie les 30 restants. Cette dernière réponse ne contient pas d'en-tête X-Next-Url : tous les produits ont donc été récupérés.