Intégration API eBay : périmètre, limites et changements 2026

Ce que couvre réellement un service d’intégration API eBay

Un service d’intégration API eBay relie votre propre système — plateforme e-commerce, ERP, outil logistique ou back-office personnalisé — à eBay via les API officielles de la marketplace. Les annonces, les stocks, les commandes et les données d’expédition circulent ainsi sans ressaisie dans Seller Hub. Il s’agit à la fois d’un travail d’ingénierie et d’une maintenance continue, car eBay fait régulièrement évoluer ses API.

Toutes les informations relatives à eBay présentées sur cette page ont été vérifiées dans la documentation développeur d’eBay le 29 septembre 2026.

Un périmètre complet comprend six volets :

• Autorisation : consentement du vendeur, stockage et renouvellement des jetons OAuth pour chaque compte eBay connecté.
• Synchronisation des annonces : correspondance entre vos données produit et les catégories eBay, les caractéristiques des articles, les politiques commerciales et les images, puis création et modification des annonces.
• Synchronisation des stocks et des prix : transmission suffisamment rapide des changements de quantité et de prix pour éviter les ventes en rupture de stock.
• Synchronisation des commandes : importation des commandes payées et transmission du suivi ainsi que du statut d’exécution.
• Gestion après-vente : annulations, retours, remboursements et litiges.
• Exploitation : gestion des limites de débit, files de reprise, alertes et suivi des avis de dépréciation d’eBay.

Les deux derniers éléments sont les plus faciles à oublier dans un devis, alors que ce sont eux qui déterminent si l’intégration fonctionnera encore dans un an. Les sections suivantes expliquent où chacun devient déterminant.

Sur quelles API eBay baser une intégration en 2026 ?

eBay fait fonctionner côte à côte deux générations d’API de vente. Les API REST (Inventory, Fulfillment, Account, Metadata, Taxonomy, Media, Notification et Feed) utilisent JSON et OAuth 2.0. L’ancienne Trading API repose sur XML et prend encore en charge des appels comme AddFixedPriceItem et GetOrders. En pratique, la plupart des intégrations en production utilisent temporairement les deux, puisque la présentation officielle de l’Inventory API par eBay cite la Trading API, l’Account API et la Fulfillment API comme API complémentaires.

La règle pratique est simple : tout nouveau développement doit commencer avec les API REST. Une intégration existante basée sur la Trading API n’a pas besoin d’être réécrite ce trimestre, mais chaque appel dont elle dépend doit être vérifié régulièrement dans la liste des dépréciations, et pas seulement au lancement du projet.

Dépréciations des API eBay à anticiper en 2026

eBay retire progressivement les fonctionnalités de la Trading API, appel par appel et événement par événement, plutôt que de tout désactiver en une seule fois. Le tableau ci-dessous provient de la page d’état des dépréciations des API eBay et présente les éléments encore planifiés au moment de la vérification.

Déjà supprimés en 2026 : Trading API GetCategories (15 avril), GetCategoryFeatures (4 juin) et la notification ItemMarkedPaid (22 juin) ; la Compliance API (30 mars) ; l’ensemble de la Product API (15 août) ; ainsi que plusieurs méthodes de la Post-Order API entre janvier et mars.

Deux tendances comptent davantage qu’une date isolée. Premièrement, les délais de préavis varient fortement : environ un mois pour la VeRO API, contre près de onze mois pour UploadSiteHostedPictures. Deuxièmement, un remplacement est souvent réparti entre deux API : GetCategories est devenu Taxonomy plus Metadata. Une intégration qui associe rigidement une seule méthode à chaque besoin finit donc par se casser par morceaux, et la correction se résume rarement à remplacer une ligne.

OAuth sur eBay : jetons, consentement et points de rupture

eBay émet deux types de jetons OAuth, et cette distinction détermine votre architecture. Le guide d’autorisation d’eBay les définit ainsi : les jetons d’application proviennent du flux d’identifiants client et donnent accès aux données qui ne sont pas liées à un vendeur, comme les taxonomies et les métadonnées. Les jetons utilisateur proviennent du flux de code d’autorisation après le consentement d’un vendeur et couvrent toute opération concernant ses annonces ou ses commandes.

Les jetons d’accès sont valables deux heures (7 200 secondes dans les exemples de réponses d’eBay). Dans le même guide, l’exemple de jeton d’actualisation expire après 47 304 000 secondes, soit environ 18 mois. C’est donc le jeton d’actualisation que votre base de données stocke réellement : traitez-le comme un identifiant sensible.

Ce qui invalide un jeton d’actualisation

• Le vendeur modifie son nom d’utilisateur ou son mot de passe eBay, ce qui révoque automatiquement les jetons d’actualisation actifs.
• Le vendeur révoque l’accès depuis les pages de son propre compte eBay.
• eBay le révoque pour ses propres raisons.
• Votre application ajoute une portée. Tous les vendeurs doivent alors donner leur consentement à nouveau ; eBay recommande donc de demander ensemble les portées nécessaires aux fonctionnalités actuelles et prévues.

Conséquences pour la conception

Considérez l’état « le vendeur doit reconnecter son compte » comme une situation normale, et non comme une erreur. L’intégration doit suspendre la synchronisation de ce vendeur, le signaler dans votre interface ou par e-mail, puis la reprendre après le nouveau consentement, au lieu de réessayer les appels en échec jusqu’à atteindre une limite.

Actualisez les jetons à la demande. eBay recommande de renouveler un jeton après une erreur indiquant qu’il est invalide plutôt que de suivre chaque date d’expiration. Les chiffres le confirment : actualiser le jeton de chaque vendeur toutes les deux heures représente 12 renouvellements par vendeur et par jour. La limite de 50 000 renouvellements quotidiens est donc atteinte avec environ 4 000 vendeurs connectés. Ajoutez un verrou par vendeur afin que plusieurs workers ne renouvellent pas simultanément le même jeton.

Si vous appelez encore des endpoints de la Trading API avec des jetons Auth'n'Auth historiques, notez que ceux-ci sont valables 18 mois, déclenchent un avertissement d’expiration sept jours à l’avance et échouent avec l’erreur 932 une fois définitivement expirés. eBay recommande OAuth, y compris pour les API traditionnelles.

Synchroniser les annonces et les stocks avec l’Inventory API

L’Inventory API modélise une annonce par couches. Un vendeur doit disposer d’au moins un emplacement de stock, puis d’un article d’inventaire (SKU unique pour ce vendeur), et enfin d’une offre qui référence une marketplace, un emplacement, une catégorie et trois politiques commerciales. La publication de l’offre transforme celle-ci en annonce active. Les déclinaisons nécessitent en plus un groupe d’articles d’inventaire. L’ordre des appels est createInventoryLocation, createOrReplaceInventoryItem, createOffer, publishOffer.

Voici les pièges qui ressortent lors du cadrage :

• Il s’agit d’un choix irréversible. La présentation de l’Inventory API par eBay précise que les annonces créées avec cette API ne peuvent être modifiées ni dans Seller Hub ni sur une autre plateforme de gestion des annonces. Déterminez quel système sera propriétaire des données d’annonce avant la mise en production et informez les équipes des vendeurs.
• Les politiques commerciales sont obligatoires. Le vendeur doit avoir activé cette fonctionnalité et chaque offre doit comporter une politique de paiement, d’expédition et de retour. Les comptes qui ne l’ont jamais activée échouent à la création de la première offre, et non au moment de la connexion.
• Les SKU servent d’identifiant. Le SKU doit être unique dans l’inventaire de ce vendeur. Votre correspondance de SKU doit rester stable ; sinon, une réimportation créera des doublons au lieu de mettre à jour les articles.
• Certains champs deviennent obligatoires lors de la publication. Des champs peuvent être facultatifs pendant la construction d’une offre, mais obligatoires au moment de la publier. Effectuez donc les contrôles avant la publication, et non après l’échec.
• Les annonces existantes peuvent être migrées sous certaines conditions. bulkMigrateListings convertit les annonces actives en objets de l’Inventory API, mais uniquement celles qui respectent des exigences supplémentaires. Prévoyez un traitement spécifique pour les autres.
• Un stock nul ne doit pas nécessairement mettre fin à l’annonce. Lorsque l’option Out-of-Stock Control est activée, une annonce dont la quantité est nulle reste active jusqu’à 90 jours, tout en étant masquée dans les résultats de recherche.

Les règles de catégorie évoluent elles aussi. Le portail développeur d’eBay a annoncé que les annonces de vêtements et de chaussures présentant des tailles non standard, manquantes ou incomplètes peuvent être bloquées ou masquées à partir d’août 2026, et que des informations de condition standardisées sont devenues obligatoires dans certaines catégories de pièces à partir de mai. Conservez les règles propres à chaque catégorie dans une configuration plutôt que de les coder en dur : une évolution devient ainsi une modification de données et non un nouveau déploiement. La nouvelle Inventory Mapping API d’eBay, qui transforme des données produit existantes en aperçus d’annonces, mérite également d’être évaluée pour cette étape de correspondance.

Synchroniser les commandes et les expéditions avec la Fulfillment API

Dans le modèle eBay, une commande provient du processus de paiement, ses lignes sont regroupées en colis et le traitement de chaque colis constitue une expédition. Votre intégration lit les commandes avec getOrders, puis transmet le suivi avec createShippingFulfillment. La rapidité d’exécution n’est pas un détail : la documentation d’eBay précise que le statut d’un vendeur dépend notamment de l’historique de ses expéditions effectuées dans les délais.

Une limite documentée est souvent à l’origine de faux rapports de bug. La Fulfillment API inclut uniquement les transactions dont le paiement a été finalisé, et getOrders ne renvoie pas les achats en attente de paiement qui exigent un paiement initial. Si le nombre de commandes importées diffère de celui affiché dans Seller Hub, vérifiez d’abord la présence de commandes impayées avant de diagnostiquer la synchronisation.

Pour gagner en rapidité, la Notification API vous permet d’enregistrer un endpoint de destination et de vous abonner à des sujets afin qu’eBay vous transmette les événements au lieu de vous obliger à interroger régulièrement l’API. Ne vous reposez toutefois pas uniquement sur les notifications push : exécutez une synchronisation périodique avec une fenêtre de reprise comme filet de sécurité et prévoyez la disparition progressive des anciens événements de notification de la Trading API (ItemMarkedPaid a déjà été supprimé).

Les remboursements méritent un plan de test dédié. issueRefund se trouve dans la Fulfillment API et, pour les vendeurs de l’UE et du Royaume-Uni, cette méthode exige une signature numérique (voir la section suivante).

Limites d’appels, contrôles de montée en charge et conformité

Trois exigences d’eBay influencent le calendrier et le budget d’une intégration, sans qu’aucune ne soit visible dans une démonstration en sandbox.

Les limites d’appels varient selon l’API : consultez donc le tableau publié par eBay pour les API que vous utilisez. Suivez la consommation avec getRateLimits dans la Developer Analytics API et déposez votre dossier d’Application Growth Check avant d’approcher le plafond ; eBay ne facture pas cette procédure.

L’exigence de signature est la plus lourde sur le plan technique. Elle s’appuie sur les normes IETF RFC 9421 et RFC 9530 et ajoute quatre en-têtes (x-ebay-signature-key, Content-Digest lorsqu’une charge utile est présente, Signature et Signature-Input). Les clés proviennent de la Key Management API d’eBay, et eBay ne conserve pas la clé privée : sa perte nécessite donc de générer une nouvelle paire. Pour tester dans la sandbox, le domicile de l’utilisateur de test doit être défini dans un pays de l’UE ou au Royaume-Uni ; dans le cas contraire, les signatures ne sont ni exigées ni vérifiées.

Développer en interne, utiliser un connecteur ou faire appel à un spécialiste

Il n’existe pas de réponse universelle, et un connecteur constitue souvent le meilleur premier choix pour un catalogue standard. L’essentiel est de savoir à partir de quel moment vos besoins dépassent ses possibilités.

Si votre catalogue ou votre processus a dépassé les capacités d’un connecteur, le service d’intégration marketplace de Netalith couvre précisément ce type de développement : annonces eBay, stocks, commandes et suivi, ainsi qu’Amazon SP-API, Walmart, Etsy et d’autres canaux.

Questions à poser à un prestataire d’intégration eBay avant de signer

1. Quelles API eBay seront utilisées ? Toute dépendance à un appel de la Trading API présent dans la liste des dépréciations implique du travail futur.
2. Avec quelles clés développeur l’intégration fonctionnera-t-elle ? Le jeu de clés détermine vos limites d’appels et le statut de votre Application Growth Check.
3. Comment les jetons d’actualisation révoqués sont-ils traités ? La réponse doit parler de réautorisation, et non de nouvelles tentatives.
4. Quel système est propriétaire des données d’annonce ? Les annonces de l’Inventory API ne peuvent plus être modifiées dans Seller Hub.
5. Les commandes en attente de paiement sont-elles importantes pour vous ? La Fulfillment API ne les renvoie pas avec getOrders.
6. Vendez-vous à des acheteurs de l’UE ou du Royaume-Uni par l’intermédiaire de vendeurs établis dans ces zones ? Si ces vendeurs sont concernés, les remboursements et les données financières nécessitent des signatures numériques.
7. Que se passe-t-il en cas de limitation du débit ou de panne d’eBay ? Recherchez des files d’attente, une stratégie de reprise progressive et des alertes.
8. Qui surveille les avis de dépréciation d’eBay, et cette veille est-elle comprise dans le prix ?
9. Que recevez-vous lors de la remise du projet ? Le code source, la documentation, les tests et la propriété des clés.

Cadrer votre intégration eBay avec Netalith

Envoyez-nous votre plateforme, les flux eBay nécessaires (annonces, stocks, commandes, suivi, remboursements) et les marchés sur lesquels vous vendez : Netalith cadrera le projet. Le prix dépend du périmètre, et non d’une formule fixe. Demandez un devis gratuit pour commencer.