API для інтэгратараў

Падключыце свой сэрвіс да SelSup

Дакументацыя, пабудаваная вакол задач распрацоўшчыка, з дакладнымі кантрактамі, рэальнымі памылкамі і інтэграцыйнымі працоўнымі патокамі.

Пачніце праз 5 хвілін Праверце брэндаў API →

GET /api/brand/find

curl 'https://api.selsup.ru/api/brand/find?query=Base' \
  --header 'Authorization: YOUR_API_TOKEN'

HTTP/1.1 200 OK
{
  "rows": [{ "brandId": 8124, "name": "Base" }],
  "hasNextPage": false
}

Новая дакументацыя

Усе раздзелы 48 і канчатковыя пункты 917 даступныя на ўсіх 12 мовах SelSup. Кожны раздзел мае свой кантракт на рэдагацыю; брэндаў застаецца рэдакцыйнай рэферэнсай якасці.

Хуткае пачатку

Ваша першае запыт у трох кроках

Токен можа атрымаць доступ да дадзеных у вашым рахунку. Захоўваць яго на баку сервера і ніколі не адпраўляць яго ў браўзэры JavaScript.

Стварэнне прысвечанага токану

Адкрыць налады інтэграцыі SelSup, даць токен яснае імя, і даць толькі дазволы, якія ён мае патрэбу.

Пашліце Authorization

Дадаць токен без прафікса Bearer да кожнага запыту.

Выкарыстоўвайце код error

Выкарыстоўвайце стабільнае поле error для лагікі прыкладання і паказаць localMessage карыстальніку.

Authorization

Ацэнка

У кожным канчатковым пункце выкарыстоўваецца https://api.selsup.ru і заголоўкі Authorization. Content-Type патрабуецца толькі для запытаў з арганізмам.

Shell

curl 'https://api.selsup.ru/api/brand/all' \
  --header 'Authorization: YOUR_API_TOKEN'

API Падпісанне

Накіраваны на задачы API

У кожным грамадскім кантролеры цяпер ёсць незалежны пакет YAML. Маршруты, параметры і схемы захоўваюцца, у той час як працоўныя патокі і памылкі прыкладання могуць быць удасканаленыя без змены генератара.

{ }

Аналітыка

Канчатковыя пункты для аналітыкі, уключаючы дакладныя маршруты, параметры, арганізм запыту і схемы адказу, якія могуць быць пашыраны.

98 канчатковыя пункты→ { }

Аховы

Канчатковыя пункты для складаў, уключаючы дакладныя маршруты, параметры, органы запыту і схемы пашырэння рэакцыі.

35 канчатковыя пункты→ { }

База ведаў

Канчатковыя пункты для базы ведаў, уключаючы дакладныя маршруты, параметры, органы запыту і схемы пашырэння рэакцыі.

33 канчатковыя пункты→ { }

Брэды

Стварэнне і пошук брэндаў, іх карта ў Ozon і 1C, кіраванне лагаты, і бяспечна злучэнне дублікатаў.

9 канчатковыя пункты→ { }

Выпрабаванне гіпотэзы

Канчатковыя пункты для тэставання гіпатэзы, уключаючы дакладныя маршруты, параметры, арганізм запыту і схемы пашырэння рэакцыі.

5 канчатковыя пункты→ { }

Вытворцы

Канчатковыя пункты для вытворцаў, уключаючы дакладныя маршруты, параметры, органы запыту і схемы рэакцыі, якія могуць быць пашыраны.

5 канчатковыя пункты→ { }

Вяртанне

Завяршальныя пункты для вяртання, уключаючы дакладныя маршруты, параметры, органы запыту і схемы адказу, якія могуць быць пашыраны.

3 канчатковыя пункты→ { }

Групы прадуктаў

Канчатковыя пункты для групы прадуктаў, уключаючы дакладныя маршруты, параметры, органы запыту і схемы пашырэння рэакцыі.

6 канчатковыя пункты→ { }

Дакументы

Канчатковыя пункты для дакументаў, уключаючы дакладныя маршруты, параметры, органы запыту і схемы адказу, якія могуць быць пашыраны.

19 канчатковыя пункты→ { }

Дамоўныя асобы

Канчатковыя пункты для Адраджэнні, уключаючы дакладныя маршруты, параметры, органы запыту і схемы рэакцыі, якія могуць быць пашыраны.

17 канчатковыя пункты→ { }

Дастаўка

Канчатковыя пункты для дастаўкі, уключаючы дакладныя маршруты, параметры, органы запыту і схемы рэакцыі, якія могуць быць пашыраны.

18 канчатковыя пункты→ { }

Задачы

Канчатковыя пункты для задач, уключаючы дакладныя маршруты, параметры, органы запыту і схемы рэакцыі, якія могуць быць пашыраны.

3 канчатковыя пункты→ { }

Заказчыкі

Канчатковыя пункты для кліентаў, уключаючы дакладныя маршруты, параметры, органы запыту і схемы адказу, якія могуць быць пашыраны.

5 канчатковыя пункты→ { }

Заказы

Канчатковыя пункты для замоў, уключаючы дакладныя маршруты, параметры, органы запыту і схемы рэакцыі, якія могуць быць пашыраны.

44 канчатковыя пункты→ { }

Заказы FBS

Канчатковыя пункты для замоў FBS, уключаючы дакладныя маршруты, параметры, органы запыту і схемы пашырэння рэакцыі.

69 канчатковыя пункты→ { }

Заліковае

Канчатковыя пункты для адліку, уключаючы дакладныя маршруты, параметры, органы запыту і схемы адказу, якія могуць быць пашыраны.

1 канчатковыя пункты→ { }

Імпарт

Канчатковыя пункты для імпарту, уключаючы дакладныя маршруты, параметры, органы запыту і схемы рэакцыі, якія могуць быць пашыраны.

31 канчатковыя пункты→ { }

Інвентар

Канчатковыя пункты для інвентар, уключаючы дакладныя маршруты, параметры, органы запыту і схемы рэакцыі, якія могуць быць пашыраны.

46 канчатковыя пункты→ { }

Інтэрнэт-букі

Канчатковыя пункты для Webhooks, уключаючы дакладныя маршруты, параметры, арганізм запыту і расшыральныя схемы адказу.

3 канчатковыя пункты→ { }

Калькулятар

Канчатковыя пункты для калькулятара, уключаючы дакладныя маршруты, параметры, органы запыту і схемы пашырэння адказу.

2 канчатковыя пункты→ { }

Канкурэнты

Канчатковыя пункты для канкурэнтаў, уключаючы дакладныя маршруты, параметры, органы запыту і схемы рэакцыі, якія могуць быць пашыраны.

4 канчатковыя пункты→ { }

Катэгорыі

Канчатковыя пункты для катэгорый, уключаючы дакладныя маршруты, параметры, органы запыту і схемы пашырэння рэакцыі.

20 канчатковыя пункты→ { }

Квітанцыя

Канчатковыя пункты для атрымання, уключаючы дакладныя маршруты, параметры, органы запыту і схемы рэакцыі, якія могуць быць пашыраны.

4 канчатковыя пункты→ { }

Ключавыя словы

Канчатковыя пункты для ключавых слоў, уключаючы дакладныя маршруты, параметры, арганізм запыту і схемы адказу, якія могуць быць пашыраны.

12 канчатковыя пункты→ { }

Купля

Канчатковыя пункты для пакупкі, уключаючы дакладныя маршруты, параметры, органы запыту і схемы рэакцыі, якія могуць быць пашыраны.

17 канчатковыя пункты→ { }

Мадэлі прадукту

Канчатковыя пункты для мадэляў прадукту, уключаючы дакладныя маршруты, параметры, арганізм запыту і схемы пашырэння рэакцыі.

14 канчатковыя пункты→ { }

Маркаванне прадукту

Канчатковыя пункты маркіроўкі прадукту, уключаючы дакладныя маршруты, параметры, органы запыту і схемы пашырэння рэакцыі.

28 канчатковыя пункты→ { }

Маркіроўкі прадукту

Канчатковыя пункты для тэгаў прадукту, уключаючы дакладныя маршруты, параметры, арганізм запыту і схемы адказу, якія могуць быць пашыраны.

9 канчатковыя пункты→ { }

МаяСклард

Канчатковыя пункты для MoySklad, уключаючы дакладныя маршруты, параметры, органы запыту і схемы адказу, якія могуць быць пашыраны.

9 канчатковыя пункты→ { }

Налады

Канчатковыя пункты для налад, уключаючы дакладныя маршруты, параметры, органы запыту і схемы адказу, якія могуць быць пашыраны.

3 канчатковыя пункты→ { }

Павышэнне

Канчатковыя пункты для прамоў, уключаючы дакладныя маршруты, параметры, органы запыту і схемы рэакцыі, якія могуць быць пашыраны.

11 канчатковыя пункты→ { }

Пазіцыя

Канчатковыя пункты для пазіцыі, уключаючы дакладныя маршруты, параметры, органы запыту і схемы пашырэння рэакцыі.

3 канчатковыя пункты→ { }

Пакаёўка

Канчатковыя пункты для ўпакоўкі, уключаючы дакладныя маршруты, параметры, органы запыту і схемы пашырэння рэакцыі.

14 канчатковыя пункты→ { }

Параметры

Канчатковыя пункты для параметраў, уключаючы дакладныя маршруты, параметры, органы запыту і схемы пашырэння адказу.

5 канчатковыя пункты→ { }

Пастаўкі

Канчатковыя пункты для пастаўкі, уключаючы дакладныя маршруты, параметры, органы запыту і схемы рэакцыі, якія могуць быць пашыраны.

52 канчатковыя пункты→ { }

Прадукты

Канчатковыя пункты для прадуктаў, уключаючы дакладныя маршруты, параметры, органы запыту і схемы пашырэння рэакцыі.

39 канчатковыя пункты→ { }

Праца

Канчатковыя пункты для працы, уключаючы дакладныя маршруты, параметры, органы запыту і пашыральныя схемы адказу.

3 канчатковыя пункты→ { }

Рахунак і інтэграцыі

Канчатковыя пункты для рахунку і інтэграцыі, уключаючы дакладныя маршруты, параметры, органы запыту і схемы рэакцыі, якія могуць быць пашыраны.

66 канчатковыя пункты→ { }

Рэкламныя кампаніі

Канчатковыя пункты для рэкламных кампаній, уключаючы дакладныя маршруты, параметры, органы запыту і схемы адказу, якія могуць быць пашыраны.

10 канчатковыя пункты→ { }

Рэпрэсіер

Канчатковыя пункты для Repricer, уключаючы дакладныя маршруты, параметры, органы запыту і схемы пашырэння адказу.

15 канчатковыя пункты→ { }

Сертыфікаты якасці

Канчатковыя пункты для сертыфікатаў якасці, уключаючы дакладныя маршруты, параметры, органы запыту і схемы пашырэння рэакцыі.

10 канчатковыя пункты→ { }

СМІ

Канчатковыя пункты для СМІ, уключаючы дакладныя маршруты, параметры, органы запыту і схемы адказу, якія могуць быць пашыраны.

1 канчатковыя пункты→ { }

Уязныя

Канчатковыя пункты для ўваходных, уключаючы дакладныя маршруты, параметры, органы запыту і схемы пашырэння рэакцыі.

19 канчатковыя пункты→ { }

Фінансавае планаванне

Канчатковыя пункты для фінансавага планавання, уключаючы дакладныя маршруты, параметры, органы запыту і схемы рэакцыі, якія могуць быць пашыраны.

5 канчатковыя пункты→ { }

Фінансы

Канчатковыя пункты для фінансавання, уключаючы дакладныя маршруты, параметры, органы запыту і схемы рэакцыі, якія могуць быць пашыраны.

25 канчатковыя пункты→ { }

Фотасесіі

Канчатковыя пункты для сесій з фота, уключаючы дакладныя маршруты, параметры, арганізм запыту і схемы адказу, якія могуць быць пашыраны.

12 канчатковыя пункты→ { }

Цэнні

Канчатковыя пункты для цэнаў, уключаючы дакладныя маршруты, параметры, органы запыту і схемы адказу, якія могуць быць пашыраны.

17 канчатковыя пункты→ { }

Экспорт

Канчатковыя пункты для экспарту, уключаючы дакладныя маршруты, параметры, органы запыту і схемы рэакцыі, якія могуць быць пашыраны.

38 канчатковыя пункты→

Кіраўнікі

Агульныя працоўныя патокі інтэграцыі

Асноўныя кіраўнікі аб'ядноўваюць некалькі канчатковых пунктаў і тлумачаць парадку выкліку, бяспечную сінхранізацыю і кіраванне краю-пастаянні.

→

Пачынаючы

Аўтэнтыка, першае запыт, лакалізаваныя памылкі, старонкаванне, і бяспечнае размяшчэнне вытворчасці.

4 раздзелы →

Каталог прадукту і карты

Пошук прадукту, поўнае здабыццё карт, стварэнне мадэляў, слоўнікі брэндаў і катэгорый, і параметры рынку.

4 раздзелы →

Заказы і паступная сінхранізацыя

Стварэнне замоў у вэб-краме, прадухіленне дублікавання, старонкавыя экспарты і апрацоўка змененых замоў.

4 раздзелы →

Інвентар і склады

Мадэль SKU, чытанне запасаў на складзе, абнаўленні SelSup або знешніх ідэнтыфікатараў, і бяспечная сумяшчальнасць.

5 раздзелы →

Вэб-хакі і інтэграцыя на падставе падзей

Выхадная ўстаноўка webhook, бяспечны прыёмнік, абарона дублікатаў, і аднаўленне прапушчаных падзей праз API.

5 раздзелы →

Пашырэнні і інтэграцыі на заказ

Выбар паміж знешнім паслугай задніх бакоў, убудаваным React UI, і сервер-сход рынку або модуль дастаўкі.

5 раздзелы

Manual first

Чаму гэта не яшчэ адна скура Swagger

Працоўныя плыні і прыклады пішуцца з пункту гледжання інтэгратара.
Пола просьбы і адказу пералічаныя асобна, без вытокаў з агульных Java мадэляў.
Памылкі прыходзяць ад кантролераў і паслуг замест агульных 400/500 месцахоўцаў.
Расейскі і англійскі кантэнт праверкаюцца па той жа будынку.