Предыдущая версия справа и слева
Предыдущая версия
Следующая версия
|
Предыдущая версия
|
ru:api_start [2022/05/05 19:59] support |
ru:api_start [2023/03/28 21:49] support |
| |
>Для работы API необходимо установить API token для пользователя. | >Для работы API необходимо установить API token для пользователя. |
>>Bearer authentication это схема аутентификации HTTP, в которой используются маркеры безопасности, называемые bearer tokens. bearer token - это шифрованная строка, обычно генерируемая сервером в ответ на запрос на вход в систему. Клиент должен отправить этот токен в заголовке Authorization при формировании запроса: Authorization: Bearer <token> | >>Bearer authentication это схема аутентификации HTTP, в которой используются маркеры безопасности, называемые bearer tokens. bearer token - это шифрованная строка. Клиент должен отправить этот токен в заголовке Authorization при формировании запроса: Authorization: Bearer <token> |
| |
---- | ---- |
| |
>Перейдите в раздел управления пользователями (Settings -> Users) | >Перейдите в раздел меню **Settings** - **Ysell API** |
>Добавьте нового пользователя (необходимо заполнить поле API token случайным значением) | >Создайте новый Access Token нажатием на Create New Token |
>>{{:ru:api.png?700|}} {{:ru:api_1.png?500|}} | >>{{:ru:apiysell2_1.png?300|}} {{:ru:apiysell_22.png?600|}} |
| |
| ---- |
| |
| >Перейдите в раздел Settings - ysell API |
| >>{{:ru:apwi.png?600|}} |
| |
---- | ---- |
| |
>Авторизуйтесь с помощью API token нажатием на Authorize | >Авторизуйтесь с помощью API token нажатием на Authorize. Введите в строке аутентификации **Bearer** //сгенерированный API key// |
>>{{:ru:api_23.png?600|}} | >>{{:ru:api_23.png?600|}} {{:ru:apibearer_2.png?600|}} |
| |
====== Product ====== | ====== Product ====== |
//Получение списка товара с клиента// | //Получение списка товара с клиента// |
</WRAP> | </WRAP> |
| |
| ---- |
| |
>**Get products list** - Получение списка товара с клиента | >**Get products list** - Получение списка товара с клиента |
> Параметр **page** - укажите страницу, с которой происходит загрузка | > Параметр **page** - укажите страницу, с которой происходит загрузка |
> **Per-page** - Кол-во товара на страницу | > **Per-page** - Кол-во товара на страницу |
>{{:ru:api_2.png?900|}} | >{{:ru:api_2.png?790|}} |
> | > |
> | > |
>**productWeightUnits** - единицы измерения веса единицы товара | >**productWeightUnits** - единицы измерения веса единицы товара |
>**productWeight** - вес единицы товара. | >**productWeight** - вес единицы товара. |
>>{{:ru:api_3.png?780|}} | >>{{:ru:api_3.png?600|}} |
| |
---- | ---- |
> | > |
>**productId** - укажите ID товара. | >**productId** - укажите ID товара. |
>{{:ru:api_4.png?850|}} | >{{:ru:api_4.png?650|}} |
> | > |
> | > |
| |
---- | ---- |
| |
<WRAP right box> | <WRAP right box> |
**Curl** | **Curl** |
//Обновление Supplier товара// | //Обновление Supplier товара// |
</WRAP> | </WRAP> |
| |
| ---- |
| |
>**Update product Suplier** - используется для обновления информации о поставщике товара | >**Update product Suplier** - используется для обновления информации о поставщике товара |
====== Supplier ====== | ====== Supplier ====== |
| |
<WRAP right box 35%> | <WRAP right box> |
**Curl** | **Curl** |
<code> | <code> |
---- | ---- |
| |
<WRAP right box 35%> | <WRAP right box> |
**Curl** | **Curl** |
<code> | <code> |
> | > |
>Укажите название поставщика. ID поставщика будет присвоено автоматически. | >Укажите название поставщика. ID поставщика будет присвоено автоматически. |
>{{:ru:api_13.png?800|}} | >{{:ru:api_13.png?600|}} |
| |
---- | ---- |
| |
<WRAP right box 35%> | <WRAP right box> |
**Curl** | **Curl** |
<code> | <code> |
>GET /supplier/{supplierNum}/product Find product by supplier num - используйте для возврата информации ID товара по номеру поставщика. | >GET /supplier/{supplierNum}/product Find product by supplier num - используйте для возврата информации ID товара по номеру поставщика. |
> | > |
>{{:ru:api_14.png?750|}} | >{{:ru:api_14.png?500|}} |
> | > |
> | > |
---- | ---- |
| |
<WRAP right box 35%> | <WRAP right box> |
**Curl** | **Curl** |
<code> | <code> |
| |
---- | ---- |
| |
<WRAP right box> | <WRAP right box> |
**Curl** | **Curl** |
| |
---- | ---- |
>GET /order-item/ Return Order item by ID | |
> | |
> | |
====== Price ====== | |
>Price schema operations | |
| |
====== Prep ====== | |
| |
====== PrepShipments ====== | |
| |
| |
| ====== Shipments ====== |
| |
<WRAP center round important 80%> | >//Операции с отправками// |
По умолчанию все API методы возвращают **20 записей**. | <WRAP right box> |
| **Curl** |
Обратите внимание на заголовки ответа | <code> |
| curl -X 'GET' \ |
**x-pagination-current-page**: 1 - текущая страница | 'https://719.eu6.ysell.pro/api/v1/prep-shipment?page=1&per-page=10&sort=1' \ |
| -H 'accept: */*' \ |
**x-pagination-page-count**: 1 - всего страниц | -H 'Authorization: Bearer 123321' |
| </code> |
** x-pagination-per-page**: 20 - записей на страницу | **Response body** |
| <code> |
**x-pagination-total-count**: 9 - всего записей | { |
| "id": 1, |
Для указания номера страницы укажите параметр **page=НомерСтраницы** | "company_id": 719, |
| "shipment_num": "719-1", |
| "shipment_type": "warehouse", |
| "shipment_type_description": "Send to the warehouse", |
| "status": 0, |
| "status_description": "New", |
| "total_cost": 0, |
| "declared_qty": 211, |
| "declared_box_qty": 0, |
| "processed_qty": 0, |
| "messages": [] |
| }, |
| </code> |
| //Получение информации о отправке 719-1 // |
</WRAP> | </WRAP> |
| >**GET /prep-shipment Get prep shipment list** - используется получения информации о отправке с Преп-центра. |
| > |
| >**company_id** - ID компании. |
| > |
| >**shipment_num** - номер отправки |
| > |
| >**shipment_type** - тип отправки |
| > |
| >**shipment_type_description** - описание для типа отправки. |
| > |
| >**status** - статус отправки. |
| > |
| >**status_description** - описание статуса отправки |
| > |
| >**total_cost** - цена за обработку отправки. |
| > |
| >**declared_qty** - количество единиц товара, указанного клиентом. |
| > |
| >**declared_box_qty** - количество коробок с товаром, указанного клиентом. |
| > |
| >**processed_qty** - обработанное Преп центром количество товара. |
| > |
| >**messages** - текст примечания к отправке. |