Сервис автоматической загрузки прайса/контента через API-методы
Для Клиентов компании Цифротех работает сервис автоматического получения прайса/контента через API-методы.
Теперь данные могут быть загружены c b2b-портала Цифротех с последующей обработкой с учетом ваших потребностей.
Что такое REST API?
REST API определяет набор функций, с помощью которых разработчики могут выполнять запросы и получать ответы.
Взаимодействие выполняется по протоколу HTTP. Преимуществом такого подхода является широкое использование HTTP.
Вот почему REST API можно использовать практически для любого языка программирования.
Общие характеристики ресурсов Magento API REST следующие:
- Вы получаете доступ к ресурсу, отправляя HTTP-запрос на сервер Magento API. Сервер отвечает ответом,
который содержит либо запрошенные вами данные, либо индикатор состояния, либо и то и другое. - Все ресурсы расположены на https://b2b.cifrotech.ua/api/rest/.
- Все ресурсы могут возвращать разные коды состояния HTTP (например, код состояния HTTP 200 – «ОК»
или код состояния HTTP 400 для ошибочного запроса). - Вы запрашиваете определенный ресурс, добавляя конкретный путь к базовому URL, который указывает ресурс.
- Вы можете получить содержимое данных с помощью HTTP GET запроса.
- Вы можете получить содержимое данных на русском и украинском языках.
Информация, доступная для получения через API-методы:
- Код товара Цифротех
- Наименование товара
- Наименование категории товара
- Наименование Бренда товара
- Цена товара
- РРЦ товара
- Код производителя
- Код УКТ ВЭД
- EAN13
- Ссылка на страницу товара в b2b
- Наличие
- Описание товара
- Характеристики товара
- Фото товара
Аутентификация
Magento REST API использует 3-этапный протокол OAuth 1.0a для аутентификации вашего приложения.
Форма ответа:
REST API поддерживает ответ в формате JSON..
Структура запроса контента:
https://b2b.cifrotech.ua/api/rest/store/ru/products?sku=[some_unique_sku]Запрос данных на русском языке
https://b2b.cifrotech.ua/api/rest/store/ua/products?sku=[some_unique_sku]Запрос данных на украинском языке
Пример ответа сервера:
Структура запроса прайса:
https://b2b.cifrotech.ua/api/rest/store/ru/getstock?limit=100&page=[page_number] Запрос данных на русском языке.
https://b2b.cifrotech.ua/api/rest/store/ua/getstock?limit=100&page=[page_number] Запрос данных на украинском языке.
Пример ответа сервера с прайсом товаров:
Получить товары по конкретной категории можно следующим образом:
C помощью запроса ниже можно получить все активные категории, на украинском и русском языках соответственно
https://b2b.cifrotech.ua/api/rest/store/ua/categories/list
https://b2b.cifrotech.ua/api/rest/store/ru/categories/list
Пример ответа сервера с перечнем активных категорий:
Вы получаете перечень категорий, их "Id", "Название", и "Путь к категории". Далее используя Id нужной Вам категории и запроса ниже, Вы можете получить все активные товары запрашиваемой категории.
https://b2b.cifrotech.ua/api/rest/store/ua/category/[Id категории]/products
https://b2b.cifrotech.ua/api/rest/store/ru/category/[Id категории]/products
Пример ответа сервера
Получить все фото товара
Запрос: https://b2b.cifrotech.ua/api/rest/products/[product_id]/images
, где product_id – id товара в БД Magento, который содержится в URL продукта.
Пример ответа сервера:
Что нужно для получения доступа к API?
Запросить ключи доступа к API отправив письмо с темой «Ключи API» указав материнский код партнера
зарегистрированного на b2b-портале по адресу b2b.cifrotech@gmail.com
С инструкцией по авторизации Вашего приложения можно ознакомится тут.
Пример работы с API можно посмотреть по адресу https://bitbucket.org/mitya_dev/cifrotechmagentoconnector