Представляем eBay’s Trading API — Настройка

В этой серии руководств я расскажу вам о торговом API Ebay. Торговый API позволяет создавать приложения, которые можно использовать для продажи на Ebay. Вот несколько примеров того, что вы можете сделать с помощью API:

• получить информацию о магазине
• обновить настройки магазина
• добавить товары в определенный магазин eBay
• списки конечных продуктов
• обновить цену продукта
• получить информацию о продукте

В этом руководстве мы создадим приложение, которое позволит пользователям создавать продукт на eBay с помощью API.

Зарегистрировать приложение

Первое, что вам нужно сделать, это зарегистрировать учетную запись разработчика на веб-сайте разработчиков eBay .

Сделайте это, и как только вы подтвердите свою электронную почту, вы увидите экран, подобный следующему:

На этой странице нажмите на ссылку «Получить ключи приложения», которая приведет вас на страницу, где вы можете создать песочницу и рабочие ключи. Затем нажмите кнопку «Создать ключи песочницы», чтобы сгенерировать ключи, которые вы можете использовать для тестирования приложения, которое мы будем создавать. Также нажмите кнопку «Создать производственные ключи», чтобы сгенерировать ключи, которые можно использовать при развертывании приложения. Обратите внимание, что эти ключи можно использовать с любым API-интерфейсом, который предоставляет eBay, поэтому вам придется сделать это только один раз.

После того, как ключи сгенерированы, нажмите на ссылку «Настройка параметров» на любом из ключей (песочница или производство).

В разделе «Настройка формы согласия пользователя eBay» нажмите ссылку «Настройка формы согласия пользователя eBay». Это позволит вам настроить URL, используемый вашим приложением. Это в основном URL-адрес домашней страницы приложения. Оказавшись там, в разделе «Управление своими RuNames» нажмите на ссылку «Создать RuName для своего приложения». RuName является эквивалентом приложения. Если вы создаете разные приложения, которые будут взаимодействовать с разными API eBay, вы можете создать одно RuName для каждого приложения. Как только RuName будет сгенерирован, у вас будет запрошена следующая информация:

• отображать заголовок — заголовок приложения, которое вы хотите отобразить, когда пользователь позднее предоставит права доступа к вашему приложению. (например, создатель продукта)
• описание дисплея : описание дисплея — это текст, который описывает, что делает ваше приложение. (например, это приложение позволяет пользователям легко добавлять товары в свой магазин eBay)
• метод возврата токена — метод возврата токена — это метод, который будет использоваться приложением после того, как пользователь предоставит права доступа вашему приложению. Для этого необходимо указать значение «FetchToken».
• тип авторизации — тип действия, которое ваше приложение выполняет после того, как пользователь наделит ваше приложение полномочиями. Это может быть либо авторизация, либо ID.verification. Укажите значение «авторизация» для этого поля, поскольку нам нужно, чтобы пользователь дал полномочия нашему приложению выполнять для них различные действия.
• Тип приложения — тип приложения. Это должно быть «на веб-основе».
• принять перенаправить URL — URL-адрес, на который перенаправляется пользователь, когда он дает полномочия приложению. Обратите внимание, что eBay разрешает только https URL. Если вы хотите подписаться позже, я рекомендую зарегистрировать учетную запись на openshift.com . Приложения, которые вы там размещаете, будут иметь https по умолчанию, и это бесплатно.
• Отклонить перенаправить URL -адрес URL -адрес, на который перенаправляется пользователь при отклонении приложения.
• URL политики конфиденциальности — URL политики конфиденциальности. Этот URL-адрес будет включен в описание приложения, когда пользователь находится на странице для предоставления полномочий приложению.

инструменты

Панель инструментов разработчика EBay предлагает для нас множество инструментов.

Аккаунт в песочнице

Давайте посмотрим на инструмент регистрации пользователей Sandbox. После регистрации учетной записи в песочнице перейдите на sandbox.ebay.com, чтобы проверить вход в систему. После того, как вы убедились, что это работает, вернитесь на страницу учетной записи разработчика eBay.

API Test Tool

Далее идет инструмент тестирования API. Оказавшись на этой странице, вы можете увидеть, что есть несколько вариантов, но они уже предварительно заполнены по умолчанию, так что вы будете иметь представление о том, что делает каждое поле. Прежде чем приступить к игре с этим инструментом, вот краткое описание для каждого поля:

• Выберите среду — это позволяет переключаться между песочницей и производственной средой. Часто, когда вы просто тестируете с помощью API Test Tool, вы можете использовать для этого «песочницу». Основное различие между ними заключается в том, что песочница может использоваться только с песочницей / тестированием учетных записей eBay, а производство может использоваться только с реальными учетными записями eBay.
• Выберите набор ключей — это позволяет изменить ключи, которые будут использоваться для выполнения вызовов API. Большую часть времени вам действительно не придется это трогать, потому что при выборе типа среды ключи уже меняются.
• Выберите API — это позволяет вам выбрать API, которому вы хотите позвонить. Как вы, возможно, уже знаете, eBay имеет различные наборы API: торговля, поиск, покупки, обратная связь и открытые API. В основном мы будем использовать торговый API для этого урока, так что выбирайте его. Обратите внимание, что после выбора торгового API появляется другой набор полей. Он предлагает вам либо сгенерировать токен пользователя, либо вручную ввести существующий. Поскольку мы уже создали учетную запись в песочнице ранее, мы можем просто нажать кнопку «Создать токен пользователя». Это перенаправит вас на страницу, которая выглядит следующим образом:

Убедитесь, что песочница выбрана для среды, затем нажмите кнопку «продолжить генерирование токена». Это перенаправит вас на страницу входа в eBay. Заполните его своими учетными данными для входа в песочницу. Если вход успешный, он перенаправит вас на страницу авторизации:

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 

 <?xml version="1.0" encoding="utf-8"?> <GetItemRequest xmlns="urn:ebay:apis:eBLBaseComponents"> <ItemID>110072510158</ItemID> <RequesterCredentials> <eBayAuthToken>your-user-token</eBayAuthToken> </RequesterCredentials> <WarningLevel>High</WarningLevel> </GetItemRequest> 

 <?xml version="1.0" encoding="utf-8"?> 

 <GetItemRequest xmlns="urn:ebay:apis:eBLBaseComponents"> </GetItemRequest> 

 <ItemID>110072510158</ItemID> 

 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 

 <RequesterCredentials> </RequesterCredentials> 

 <eBayAuthToken>your-user-token</eBayAuthToken> 

 <WarningLevel>High</WarningLevel> 

 CREATE TABLE IF NOT EXISTS `settings` ( `id` int(11) NOT NULL AUTO_INCREMENT, `user_token` text NOT NULL, `dev_id` varchar(300) NOT NULL, `app_id` varchar(300) NOT NULL, `cert_id` varchar(300) NOT NULL, `run_name` varchar(300) NOT NULL, `site_id` varchar(60) NOT NULL, PRIMARY KEY (`id`) ) 

 CREATE TABLE IF NOT EXISTS `store_settings` ( `id` int(11) NOT NULL AUTO_INCREMENT, `store_name` varchar(160) NOT NULL, `county` varchar(160) NOT NULL, `street` varchar(160) NOT NULL, `country_code_type` varchar(60) NOT NULL, `ebay_website` varchar(160) NOT NULL, `postal_code` varchar(60) NOT NULL, `category_mapping` tinyint(1) NOT NULL, `category_prefill` tinyint(1) NOT NULL, `currency_code` varchar(60) NOT NULL, `item_location` varchar(300) NOT NULL, `dispatch_time` int(11) NOT NULL, `listing_duration` varchar(60) NOT NULL, `listing_type` varchar(60) NOT NULL, `condition_type` varchar(60) NOT NULL, `optimal_picturesize` tinyint(1) NOT NULL, `out_of_stock_control` tinyint(1) NOT NULL, `get_it_fast` tinyint(1) NOT NULL, `include_prefilled` tinyint(1) NOT NULL, `shipping_profile` varchar(160) NOT NULL, `return_profile` varchar(160) NOT NULL, `payment_profile` varchar(160) NOT NULL, `shipping_service` varchar(160) NOT NULL, `shippingservice_priority` int(11) NOT NULL, `shippingservice_cost` double NOT NULL, `shippingservice_additionalcost` double NOT NULL, PRIMARY KEY (`id`) ) 

 CREATE TABLE IF NOT EXISTS `products` ( `id` int(11) NOT NULL AUTO_INCREMENT, `title` varchar(80) NOT NULL, `category_id` varchar(90) NOT NULL, `price` double NOT NULL, `qty` int(11) NOT NULL, `brand` varchar(160) NOT NULL, `description` text NOT NULL, PRIMARY KEY (`id`) ) 

 CREATE TABLE IF NOT EXISTS `condition_types` ( `id` int(11) NOT NULL, `name` varchar(160) NOT NULL, PRIMARY KEY (`id`) ) 

 CREATE TABLE IF NOT EXISTS `listing_types` ( `name` varchar(160) NOT NULL ) 

 CREATE TABLE IF NOT EXISTS `listing_durations` ( `name` varchar(60) NOT NULL ) 

 INSERT INTO `listing_durations` (`name`) VALUES ('Days_1'), ('Days_10'), ('Days_120'), ('Days_14'), ('Days_21'), ('Days_3'), ('Days_30'), ('Days_5'), ('Days_60'), ('Days_7'), ('Days_90'), ('GTC'); 

 INSERT INTO `listing_types` (`name`) VALUES ('AdType'), ('Auction'), ('Chinese'), ('FixedPriceItem'), ('Half'), ('LeadGeneration'), ('PersonalOffer'), ('Shopping'), ('Unknown'); 

 INSERT INTO `condition_types` (`id`, `name`) VALUES (1000, 'New'), (1500, 'New Other'), (1750, 'New with defects'), (2000, 'Manufacturer refurbished'), (2500, 'Seller refurbished'), (3000, 'Used'), (4000, 'Very Good'), (5000, 'Good'), (6000, 'Acceptable'), (7000, 'For parts or not working');