SelSup Developers

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

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

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

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
}

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

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

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

02

Пашліце Authorization

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

03

Выкарыстоўвайце код 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. Маршруты, параметры і схемы захоўваюцца, у той час як працоўныя патокі і памылкі прыкладання могуць быць удасканаленыя без змены генератара.

{ }

Аналітыка

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

Канчатковыя пункты: 108→
{ }

Аховы

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

Канчатковыя пункты: 41→
{ }

База ведаў

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

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

Брэды

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

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

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

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

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

Вытворцы

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

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

Вяртанне

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

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

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

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

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

Дакументы

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

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

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

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

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

Дастаўка

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

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

Задачы

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

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

Заказчыкі

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

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

Заказы

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

Канчатковыя пункты: 51→
{ }

Заказы FBS

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

Канчатковыя пункты: 94→
{ }

Заліковае

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

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

Імпарт

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

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

Інвентар

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

Канчатковыя пункты: 53→
{ }

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

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

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

Калькулятар

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

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

Канкурэнты

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

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

Катэгорыі

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

Канчатковыя пункты: 23→
{ }

Квітанцыя

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

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

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

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

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

Купля

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

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

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

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

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

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

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

Канчатковыя пункты: 53→
{ }

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

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

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

МаяСклард

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

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

Налады

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

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

Павышэнне

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

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

Пазіцыя

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

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

Пакаёўка

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

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

Параметры

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

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

Пастаўкі

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

Канчатковыя пункты: 67→
{ }

Прадукты

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

Канчатковыя пункты: 53→
{ }

Праца

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

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

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

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

Канчатковыя пункты: 74→
{ }

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

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

Канчатковыя пункты: 16→
{ }

Рэпрэсіер

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

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

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

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

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

СМІ

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

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

Уязныя

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

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

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

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

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

Фінансы

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

Канчатковыя пункты: 26→
{ }

Фотасесіі

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

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

Цэнні

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

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

Экспорт

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

Канчатковыя пункты: 40→

Кіраўнікі

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

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

→

Пачынаючы

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

Раздзелы: 4
→

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

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

Раздзелы: 4
→

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

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

Раздзелы: 4
→

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

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

Раздзелы: 5
→

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

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

Раздзелы: 5
→

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

Стварыце звычайную старонку HTML/JavaScript з дапамогай любой сістэмы. SelSup ўбудоўвае яе ў iframe; яна не выконвае ваш код React ўнутры шафы.

Раздзелы: 11

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

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