Tools Mercado Livre
Les 14 opérations Mercado Livre que votre produit exécute sur le compte de votre client via Connect. Elles utilisent toutes le même endpoint, POST /api/tools/{tool}/execute.
- Obtenir l'utilisateur actuelGETRenvoie le compte vendeur connecté : id, nickname, email, site_id et réputation du vendeur. L'id est le user_id, seller et seller_id des autres outils, et le site_id (MLB au Brésil) va dans Rechercher des catégories.
- Rechercher des annoncesGETListe les ids des annonces du vendeur, 50 par page par défaut. results ne contient que des ids d'annonces : Lister les annonces renvoie leurs détails. Paginez avec offset et limit ; au-delà de 1000 résultats, utilisez search_type scan et le scroll_id de chaque réponse.
- Lister les annoncesGETRenvoie jusqu'à 20 annonces par id en un appel : titre, prix, available_quantity, sold_quantity, status, permalink, images et attributs. Chaque élément contient status_code, id et l'annonce dans body.
- Rechercher des catégoriesGETPrédit la catégorie d'un produit à partir de son titre, avec le domaine et les attributs reconnus dans le texte. Le premier résultat est le plus probable. Son category_id va dans Créer une annonce et dans Lister les attributs de la catégorie.
- Lister les attributs de la catégorieGETListe les attributs d'une catégorie avec id, value_type, valeurs acceptées et tags. Les attributs avec la tag required doivent être envoyés dans Créer une annonce, et ceux en new_required quand l'article est neuf.
- Créer une annoncePOSTPublie une annonce et la renvoie avec son id. Dans le modèle User Products, actif pour tous les vendeurs, envoyez family_name et aucun title : Mercado Livre construit le titre. La description s'ajoute ensuite avec Créer la description de l'annonce.
- Mettre à jour une annoncePUTModifie une annonce et la renvoie. Seuls les champs envoyés changent. status paused la masque, active la réactive et closed la termine définitivement. title et family_name ne changent que tant que l'annonce n'a aucune vente.
- Obtenir la description de l'annonceGETRenvoie la description d'une annonce en plain_text, avec date_created et last_updated.
- Créer la description de l'annoncePOSTAjoute la description à une annonce qui n'en a pas, comme une annonce tout juste créée avec Créer une annonce. Échoue avec 400 quand une description existe déjà : utilisez Mettre à jour la description de l'annonce.
- Mettre à jour la description de l'annoncePUTRemplace la description d'une annonce qui en a déjà une.
- Rechercher des commandesGETListe les ventes du vendeur des 12 derniers mois, avec acheteur, articles, paiements et id d'expédition. sort date_desc place les plus récentes en premier. Paginez avec offset et limit ; paging.total contient le compte.
- Obtenir une commandeGETRenvoie une vente : status, articles, quantités, prix, paiements, acheteur, tags et l'id d'expédition.
- Rechercher des questionsGETListe les questions posées par les acheteurs sur les annonces du vendeur, ou sur une annonce, avec la réponse quand elle existe. Les questions sans réponse de plus de 7 mois sont supprimées. Paginez avec offset et limit.
- Répondre à une questionPOSTPublie la réponse du vendeur à une question d'acheteur et renvoie la question avec la réponse. La réponse est publique sur l'annonce.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
