Maison >développement back-end >tutoriel php >Présentation de l'API de trading eBay - Configuration
Dans cette série de didacticiels, je vous guiderai à travers l'API trading d'Ebay. L'API de trading vous permet de créer des applications qui peuvent être utilisées pour la vente dans eBay. Voici quelques exemples de choses que vous pouvez faire avec l'API:
Dans ce tutoriel, nous créerons une application qui permet aux utilisateurs de créer un produit sur eBay via l'utilisation de l'API.
La première chose que vous devrez faire est d'enregistrer un compte de développeur sur le site Web du développeur eBay.
Faites cela, et une fois que vous avez vérifié votre e-mail, vous serez accueilli avec un écran similaire à ce qui suit:
Sur cette page, cliquez sur le lien «Obtenez vos clés d'application», qui vous mènera à la page où vous pourrez générer des clés de bac à sable et de production. Ensuite, cliquez sur le bouton «Générer des clés de sable» pour générer les touches que vous pouvez utiliser pour tester l'application que nous allons construire. Cliquez également sur le bouton «Générer les touches de production» pour générer les touches que vous pouvez utiliser lorsque vous déployez l'application. Notez que ces clés peuvent être utilisées avec l'une des API fournies par Ebay, vous n'aurez donc à le faire qu'une seule fois.
Une fois les touches générées, cliquez sur le lien «Configurer les paramètres» sur l'une des touches (bac à sable ou production).
Dans la section «Personnaliser le formulaire de consentement de l’utilisateur eBay» Cliquez sur le lien «Personnaliser le formulaire de consentement de l’utilisateur eBay». Cela vous permettra de configurer l'URL utilisé par votre application. Il s'agit essentiellement de l'URL de la page d'accueil de l'application. Une fois, dans le cadre de la section «Gérer vos ramages», cliquez sur le lien «Générer un ruisseau pour votre application». Un ruissellement est un équivalent à une application. Si vous créez différentes applications qui interagiront avec différentes API eBay, vous pouvez créer un Runenom pour chaque application. Une fois le ruissellement généré, les informations suivantes vous seront demandées:
Le tableau de bord du développeur d'Ebay offre une variété d'outils pour que nous puissions jouer.
Permet de jeter un coup d'œil à l'outil d'enregistrement des utilisateurs de bac à sable. Après avoir enregistré un compte Sandbox, rendez-vous sur sandbox.ebay.com pour tester la connexion. Une fois que vous avez vérifié que cela fonctionne, revenez à votre page de compte développeur eBay.
outil de test API
Confirmez que Sandbox est sélectionné pour l'environnement, puis cliquez sur le bouton «Continuez à générer des jetons». Qui vous redirigera vers la page de connexion du site Web de sandbox eBay. Remplissez-le de vos informations d'identification de connexion à sable. Si la connexion réussit, elle vous redirigera vers la page d'autorisation:
Acceptez d'autoriser l'application. Notez qu'il s'agit d'une application générique utilisée par eBay principalement pour les tests. Ce n'est pas l'application que nous avons créée plus tôt. Après cela, vous serez redirigé vers la page suivante:
Tout ce que vous avez à faire sur cette page est de copier le jeton généré, puis de cliquer sur le bouton «Enregistrer le jeton». Une fois cela fait, vous pouvez revenir à la page de l'outil de test API et coller dans le jeton utilisateur que vous venez de copier dans le champ de jeton utilisateur.
Sélectionnez un appel API - la ressource réelle de l'API que vous souhaitez demander. Il y a un tas d'appels que vous pouvez passer. Vous pouvez sélectionner tout ce qui pique votre intérêt.
Sélectionnez un modèle - cela peut avoir une valeur de «complet, générique» ou «partiel, pré-rempli». La sélection de «Full, Generic» vous donnera des champs vierges dans votre boîte de demande XML lors de la sélection de «Partial, Pré-rempli» vous donnera des champs d'exemples de base qui ont déjà été remplis. Étant donné que nous ne faisons que commencer, utiliser «partiel, pré-rempli» est le meilleur choix, car cela nous fournirait déjà certains des champs requis par la ressource que nous avons sélectionnée. Par exemple, si nous sélectionnons `` GetItem '' pour le champ d'appel de l'API, cela fournirait déjà un exemple d'élément et d'avertissement pour nous, et tout ce que nous avons à faire est de cliquer sur le bouton `` Soumettre '' sous la demande de textare de demande XML afin de lancer la demande. Une fois que vous vous sentez à l'aise avec l'utilisation de l'API, vous pouvez simplement ajouter directement les valeurs à la demande XML TextArea pour modifier les données réelles qui sont soumises à l'API.
Sélectionnez une variation d'appel - chaque ressource de l'API peut avoir des variations différentes, mais la plupart du temps, vous voudriez faire un appel de base afin que vous n'ayez pas vraiment à modifier la valeur par défaut de ce champ .
Sélectionner la version de la demande d'appel - L'API eBay a subi de nombreux changements, ce qui signifie qu'il existe différentes versions de l'API flottant toujours pour prendre en charge les anciens systèmes. Puisque nous commençons à utiliser l'API, nous pouvons simplement choisir la dernière version, qui à ce moment-là est la version 885.
Sélectionnez l'ID de site - comme vous le savez peut-être déjà, il existe différents sites Web eBay. Ce champ représente le site Web eBay réel où vous souhaitez passer l'appel. Puisque nous testons simplement à l'aide de l'outil de test API, nous pouvons simplement fournir les États-Unis pour cela.
URI du service Web - L'URL à laquelle toutes les demandes sont faites. Vous n'avez pas à modifier ce champ.
En-têtes HTTP - Les informations fournies dans l'en-tête pour chaque demande que vous faites à l'API. Les en-têtes suivants sont utilisés par défaut:
X-EBAY-API-COMPATIBILITY-LEVEL:your-request-version X-EBAY-API-DEV-NAME:your-dev-id X-EBAY-API-APP-NAME:your-app-id X-EBAY-API-CERT-NAME:your-cert-id X-EBAY-API-SITEID:your-site-id X-EBAY-API-CALL-NAME:YourAPICallMethod
Expliquer les clairs:
<span><?xml version="1.0" encoding="utf-8"?> </span><span><span><span><GetItemRequest</span> xmlns<span>="urn:ebay:apis:eBLBaseComponents"</span>></span> </span><span><span><span><ItemID</span>></span>110072510158<span><span></ItemID</span>></span> </span><span><span><span><RequesterCredentials</span>></span> </span><span><span><span><eBayAuthToken</span>></span>your-user-token<span><span></eBayAuthToken</span>></span> </span><span><span><span></RequesterCredentials</span>></span> </span><span><span><span><WarningLevel</span>></span>High<span><span></WarningLevel</span>></span> </span><span><span><span></GetItemRequest</span>></span></span>
le décomposant, cela spécifie la version XML et le codage que nous utilisons:
X-EBAY-API-COMPATIBILITY-LEVEL:your-request-version X-EBAY-API-DEV-NAME:your-dev-id X-EBAY-API-APP-NAME:your-app-id X-EBAY-API-CERT-NAME:your-cert-id X-EBAY-API-SITEID:your-site-id X-EBAY-API-CALL-NAME:YourAPICallMethod
C'est l'emballage de notre demande. Il utilise la méthode de demande GetItem. Notez que GetItem est le nom de la méthode de l'API, mais nous devons y ajouter la demande. Le XMLNS est utilisé pour spécifier l'espace de noms auquel appartient l'appel. La plupart du temps, la valeur pour cela serait Urn: eBay: API: eblBasecomponents. Et quand je dis la plupart du temps, cela signifie que la plupart des méthodes de l'API de trading utilisent cet espace de noms spécifique.
<span><?xml version="1.0" encoding="utf-8"?> </span><span><span><span><GetItemRequest</span> xmlns<span>="urn:ebay:apis:eBLBaseComponents"</span>></span> </span><span><span><span><ItemID</span>></span>110072510158<span><span></ItemID</span>></span> </span><span><span><span><RequesterCredentials</span>></span> </span><span><span><span><eBayAuthToken</span>></span>your-user-token<span><span></eBayAuthToken</span>></span> </span><span><span><span></RequesterCredentials</span>></span> </span><span><span><span><WarningLevel</span>></span>High<span><span></WarningLevel</span>></span> </span><span><span><span></GetItemRequest</span>></span></span>
Ensuite est l'ID de l'élément dans eBay.
<span><?xml version="1.0" encoding="utf-8"?></span>
Pour trouver ces informations, recherchez un élément dans eBay, puis cliquez sur l'un des résultats renvoyés. L'URL ressemblera à ceci:
<span><span><span><GetItemRequest</span> xmlns<span>="urn:ebay:apis:eBLBaseComponents"</span>></span> </span><span><span><span></GetItemRequest</span>></span></span>
L'ID d'élément est l'ensemble des nombres qui viennent juste après le titre de l'article.
Vient ensuite l'emballage des informations d'identification du demandeur:
<span><span><span><ItemID</span>></span>110072510158<span><span></ItemID</span>></span></span>
L'écran d'identification des demandeurs doit contenir le jeton utilisateur. Nous avons déjà vu comment acquérir un jeton utilisateur plus tôt pour un compte sandbox. L'acquisition d'un jeton utilisateur pour l'application serait essentiellement la même, mais nous devions gérer la sauvegarde du jeton dans une base de données afin que nous puissions en faire usage plus tard.
http://www.ebay.co.uk/itm/Apple-MacBook-Pro-15-4-2-66Ghz-Dual-Core-8GB-RAM-250GB-Latest-OS-X-10-9-/301305989202?pt=UK_Computing_Apple_Laptops_ET&hash=item46273c8852
Ensuite est le niveau d'avertissement. Cela peut avoir une valeur de haut ou de faible. Cela devrait toujours être réglé sur le haut pour dire à eBay de retourner des avertissements pour des éléments non reconnus et dépréciés ou des valeurs non valides. Cela vous permettrait de vérifier la réponse en cas de problème avec la demande.
<span><span><span><RequesterCredentials</span>></span> </span><span><span><span></RequesterCredentials</span>></span></span>
Réponse d'appel - La réponse réelle renvoyée par l'API. Il n'est pas nécessaire de le modifier car il est simplement utilisé pour afficher la réponse.
Le dernier outil que nous allons parcourir est le rapport d'utilisation des appels API. Cela vous permet de générer des rapports sur votre utilisation de l'API pour une plage de temps spécifique. Il s'agit d'un bel outil à avoir si vous déployez une application plus tard, car cela vous permettrait de déterminer si vous dépassez les limites d'appel de l'API pour l'API spécifique que vous utilisez pour votre application. Dans ce cas, vous pouvez simplement soumettre une demande à eBay pour augmenter votre limite d'API.
Nous utiliserons MySQL pour cette application. Les tables suivantes seront utilisées:
Créez une nouvelle base de données en utilisant quelque chose comme PhpMyAdmin, puis exécutez les instructions SQL suivantes pour créer les tables individuelles:
Paramètres
<span><span><span><eBayAuthToken</span>></span>your-user-token<span><span></eBayAuthToken</span>></span></span>
store_settings
<span><span><span><WarningLevel</span>></span>High<span><span></WarningLevel</span>></span></span>
Produits
<span>CREATE TABLE IF NOT EXISTS <span>`settings`</span> ( </span> <span><span>`id`</span> int(11) NOT NULL AUTO_INCREMENT, </span> <span><span>`user_token`</span> text NOT NULL, </span> <span><span>`dev_id`</span> varchar(300) NOT NULL, </span> <span><span>`app_id`</span> varchar(300) NOT NULL, </span> <span><span>`cert_id`</span> varchar(300) NOT NULL, </span> <span><span>`run_name`</span> varchar(300) NOT NULL, </span> <span><span>`site_id`</span> varchar(60) NOT NULL, </span> <span>PRIMARY KEY (<span>`id`</span>) </span><span>)</span>
condition_types
<span>CREATE TABLE IF NOT EXISTS <span>`store_settings`</span> ( </span> <span><span>`id`</span> int(11) NOT NULL AUTO_INCREMENT, </span> <span><span>`store_name`</span> varchar(160) NOT NULL, </span> <span><span>`county`</span> varchar(160) NOT NULL, </span> <span><span>`street`</span> varchar(160) NOT NULL, </span> <span><span>`country_code_type`</span> varchar(60) NOT NULL, </span> <span><span>`ebay_website`</span> varchar(160) NOT NULL, </span> <span><span>`postal_code`</span> varchar(60) NOT NULL, </span> <span><span>`category_mapping`</span> tinyint(1) NOT NULL, </span> <span><span>`category_prefill`</span> tinyint(1) NOT NULL, </span> <span><span>`currency_code`</span> varchar(60) NOT NULL, </span> <span><span>`item_location`</span> varchar(300) NOT NULL, </span> <span><span>`dispatch_time`</span> int(11) NOT NULL, </span> <span><span>`listing_duration`</span> varchar(60) NOT NULL, </span> <span><span>`listing_type`</span> varchar(60) NOT NULL, </span> <span><span>`condition_type`</span> varchar(60) NOT NULL, </span> <span><span>`optimal_picturesize`</span> tinyint(1) NOT NULL, </span> <span><span>`out_of_stock_control`</span> tinyint(1) NOT NULL, </span> <span><span>`get_it_fast`</span> tinyint(1) NOT NULL, </span> <span><span>`include_prefilled`</span> tinyint(1) NOT NULL, </span> <span><span>`shipping_profile`</span> varchar(160) NOT NULL, </span> <span><span>`return_profile`</span> varchar(160) NOT NULL, </span> <span><span>`payment_profile`</span> varchar(160) NOT NULL, </span> <span><span>`shipping_service`</span> varchar(160) NOT NULL, </span> <span><span>`shippingservice_priority`</span> int(11) NOT NULL, </span> <span><span>`shippingservice_cost`</span> double NOT NULL, </span> <span><span>`shippingservice_additionalcost`</span> double NOT NULL, </span> <span>PRIMARY KEY (<span>`id`</span>) </span><span>)</span>
listing_types
X-EBAY-API-COMPATIBILITY-LEVEL:your-request-version X-EBAY-API-DEV-NAME:your-dev-id X-EBAY-API-APP-NAME:your-app-id X-EBAY-API-CERT-NAME:your-cert-id X-EBAY-API-SITEID:your-site-id X-EBAY-API-CALL-NAME:YourAPICallMethod
listing_durations
<span><?xml version="1.0" encoding="utf-8"?> </span><span><span><span><GetItemRequest</span> xmlns<span>="urn:ebay:apis:eBLBaseComponents"</span>></span> </span><span><span><span><ItemID</span>></span>110072510158<span><span></ItemID</span>></span> </span><span><span><span><RequesterCredentials</span>></span> </span><span><span><span><eBayAuthToken</span>></span>your-user-token<span><span></eBayAuthToken</span>></span> </span><span><span><span></RequesterCredentials</span>></span> </span><span><span><span><WarningLevel</span>></span>High<span><span></WarningLevel</span>></span> </span><span><span><span></GetItemRequest</span>></span></span>
Pour les types de conditions, les types de listing et les durées de liste, nous pouvons simplement insérer directement les données par défaut. Exécutez également les requêtes suivantes pour ce faire.
<span><?xml version="1.0" encoding="utf-8"?></span>
<span><span><span><GetItemRequest</span> xmlns<span>="urn:ebay:apis:eBLBaseComponents"</span>></span> </span><span><span><span></GetItemRequest</span>></span></span>
<span><span><span><ItemID</span>></span>110072510158<span><span></ItemID</span>></span></span>
Dans cette partie, nous avons préparé notre environnement et avons tout configuré pour un flux de travail de développement fluide dans les parties 2 et 3. Restez à l'écoute pour le suivi dans lequel nous commencerons à construire la logique de notre application!
L'API de trading d'Ebay est un outil puissant qui permet aux développeurs de créer des applications qui peuvent effectuer diverses opérations liées au trading eBay. Il fonctionne en fournissant un ensemble de protocoles de communication entre votre application et les serveurs d'eBay. Ces protocoles permettent à votre application d'effectuer des tâches telles que la liste des articles à vendre, la gestion des annonces actives, la récupération des informations utilisateur et la réalisation des transactions de vente. L'API de trading utilise des messages basés sur XML pour communiquer, et il nécessite un jeton d'authentification pour un accès sécurisé.
Pour commencer avec l'API trading d'Ebay , vous devez d'abord vous inscrire en tant que développeur sur le site Web du programme des développeurs d'eBay. Une fois inscrit, vous pouvez créer un ensemble de clés d'application qui comprend un AppID, Certid et Devid. Ces clés sont utilisées pour authentifier votre application lors de la réalisation d'appels d'API. Vous devez également générer un jeton utilisateur, qui représente l'utilisateur eBay que votre application agit au nom de.
L'API commerciale d'Ebay fournit un large gamme d'opérations que vous pouvez effectuer. Il s'agit notamment de la liste des articles à vendre, de la gestion des listes actives, de la récupération des informations utilisateur, de la réalisation des transactions de vente, etc. Chaque opération est représentée par un appel API spécifique, et les détails de chaque appel sont documentés dans la documentation de l'API d'Ebay.
pour faire un Appel de l'API avec l'API de trading d'Ebay, vous devez envoyer une demande de message HTTP au point de terminaison de l'API. Le corps de la demande doit contenir un message XML qui spécifie l'appel API que vous souhaitez faire et tous les paramètres requis. Les en-têtes de la demande doivent inclure votre appid, certide et dévide pour l'authentification.
La réponse d'un appel API est un message XML qui contient les résultats de l'appel. Vous pouvez analyser ce message XML pour extraire les informations dont vous avez besoin. La structure du message de réponse dépend de l'appel de l'API que vous avez fait.
Certaines erreurs courantes que vous pourriez rencontrer lors de l'utilisation de l'API de trading d'eBay incluent des erreurs d'authentification, des erreurs de demande non valides et des erreurs de serveur. Chaque erreur est représentée par un code d'erreur et un message spécifiques, qui sont inclus dans le message de réponse lorsqu'une erreur se produit.
Si vous rencontrez des problèmes Avec l'API trading d'Ebay, vous pouvez utiliser le code d'erreur et le message dans le message de réponse pour identifier le problème. Vous pouvez également vous référer aux forums de documentation et de développeur de l'API d'Ebay pour une aide supplémentaire.
Oui, vous pouvez utiliser l'API trading d'Ebay avec n'importe quel langage de programmation Cela prend en charge HTTP et XML. Cela inclut des langages comme Python, Java, C # et plus encore.
Pour vous assurer que votre application est sécurisée lors de l'utilisation de l'API trading d'Ebay , vous devez toujours utiliser HTTPS lors de la création d'appels API, et vous ne devez jamais partager votre jeton AppID, certide, dévide ou utilisateur.
Vous pouvez trouver plus d'informations sur l'API de trading d'Ebay dans la documentation de l'API d'Ebay, qui fournit des informations détaillées sur chaque appel d'API, y compris ses paramètres, sa structure de réponse et ses codes d'erreur. Vous pouvez également trouver des ressources utiles sur le site Web du programme de développeurs d'eBay et les forums des développeurs.
Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!