Recherche Rappi Mexique. La vitrine est rappi.com.mx et le site fixe la ville sur Ciudad de México. Les autres domaines pays renvoient 400.
GET https://api.piloterr.com/v2/rappi/search?query=leche
En-tête : x-api-key.
Chaque ligne est l'offre d'un magasin pour un produit. Le même produit peut apparaître plusieurs fois, une fois par magasin. product_id peut se répéter. La paire product_id plus store_id ne se répète pas.
La charge utile n'a pas de page suivante, donc pagination.next est null. Un page supérieur à 1 renvoie 404.
price est un nombre en MXN et price_display est le même montant avec un signe dollar et deux décimales, par exemple 35.9 et $35.90. La page produit peut afficher un autre prix parce que son magasin principal n'est pas le magasin de cette carte.
query est obligatoire. Exemple : leche. Une URL de recherche mexicaine fonctionne : https://www.rappi.com.mx/search?query=leche. Une URL produit est refusée ici.
page est facultatif. Seule la page 1 renvoie des lignes. Exemple : 1.
product_id est l'id de l'offre en magasin. master_product_id est l'id catalogue, par exemple 14069 pour ce lait Santa Clara. name est le nom. url est la page produit sur rappi.com.mx. Ouvrez cette URL sur /v2/rappi/product.
price est un nombre. price_display lui correspond, par exemple $35.90. currency vaut MXN. original_price est le montant avant remise quand has_discount est vrai, sinon null. has_discount et in_stock sont des booléens.
unit_type est une unité courte, par exemple l. unit_price est la chaîne d'unité du site, par exemple 0.0359/ml. image est une image produit.
store_id, store_name et store_url identifient le magasin. eta est une fenêtre de livraison, par exemple 9 - 12 min. shipping_cost est un nombre. has_free_shipping est un booléen. store_promotion est le texte de bannière du magasin, ou null.
pagination.page vaut 1. pagination.per_page est le nombre de lignes de cette réponse. Pour leche c'était 208. pagination.total_results et pagination.total_pages sont null. pagination.next est null parce que la charge utile n'a pas de page suivante.
Il n'y a pas de page 2 à demander.
- Une marque compare les prix du lait Santa Clara entre les magasins de Mexico dans une seule réponse, avec
master_product_id 14069.
- Un opérateur de dark store garde les lignes
in_stock vraies et lit eta et shipping_cost.
- Un suivi de prix stocke
product_id avec store_id, parce que la même brique est listée par beaucoup de magasins.
- 400 :
query vide, URL produit, ou hôte Rappi autre que rappi.com.mx.
- 404 : aucun produit, ou
page supérieur à 1.
- 401 : clé API absente.