SelSup Developers

Интеграторлар үшін 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 браузерінде жібермеңіз.

01

Арнайы белгісін құру

SelSup интеграция параметрлерін ашу, белгіге нақты атау беру және оған қажетті рұқсаттарды беру.

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 тәуелсіз пакеті бар. Жолдар, параметрлер және схемалар түсіріледі, ал жұмыс барысы мен қолданба қателері генераторды өзгертпей түзетіледі.

{ }

Аналитика

Аналитиканың соңғы нүктелері, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

98 аяқтық нүктелер→ { }

Ауыру

Ақыры, есеп айырысудың соңғы нүктелері, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

1 аяқтық нүктелер→ { }

Бағалар

Бағалар бойынша соңғы нүктелер, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

17 аяқтық нүктелер→ { }

БАҚ

Медиа үшін соңғы нүктелер, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

1 аяқтық нүктелер→ { }

Брендтер

Брендтерді құру және табу, Озон мен 1С-ке карта жасау, логотиптерді басқару және дубликаттарды қауіпсіз біріктіру.

9 аяқтық нүктелер→ { }

Білім базасы

Білім базасының соңғы нүктелері, оның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

33 аяқтық нүктелер→ { }

Веб-хоктар

Веб-хауктар үшін соңғы нүктелер, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

3 аяқтық нүктелер→ { }

Гипотезалық сынақ

Гипотезалық сынақтардың соңғы нүктелері, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

5 аяқтық нүктелер→ { }

Есеп және интеграциялар

Есептік жазба және интеграциялардың түпкілікті нүктелері, оның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

66 аяқтық нүктелер→ { }

Есептеуші

Калькулятордың соңғы нүктелері, оның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

2 аяқтық нүктелер→ { }

Жабдықтау

Басып шығарудың соңғы нүктелері, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

14 аяқтық нүктелер→ { }

Жарнамалық кампаниялар

Жарнамалық кампаниялар үшін соңғы нүктелер, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

10 аяқтық нүктелер→ { }

Жарыстар

Кәсіпкерлер үшін нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары қоса алғанда, қорытынды нүктелер.

4 аяқтық нүктелер→ { }

Жеткізу

Жеткізудің соңғы нүктелері, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

18 аяқтық нүктелер→ { }

Жұмысқа

Жұмыс үшін соңғы нүктелер, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

3 аяқтық нүктелер→ { }

Импорт

Импорттың соңғы нүктелері, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

31 аяқтық нүктелер→ { }

Категориялар

Категориялар үшін соңғы нүктелер, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

20 аяқтық нүктелер→ { }

Квитанция

Қабылдаудың соңғы нүктелері, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

4 аяқтық нүктелер→ { }

Келуші

Келіспегіштер үшін соңғы нүктелер, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

19 аяқтық нүктелер→ { }

Клиенттер

Клиенттер үшін соңғы нүктелер, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

5 аяқтық нүктелер→ { }

Кілті сөздер

Кілті сөздер үшін соңғы нүктелер, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

12 аяқтық нүктелер→ { }

Қайта бағалаушы

Repricer-ке арналған соңғы нүктелер, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

15 аяқтық нүктелер→ { }

Қайта беру

Қайталамалар үшін соңғы нүктелер, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

3 аяқтық нүктелер→ { }

Қаржы

Қаржылық мақсаттар, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

25 аяқтық нүктелер→ { }

Қаржылық жоспарлау

Қаржылық жоспарлаудың соңғы нүктелері, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

5 аяқтық нүктелер→ { }

Құжаттар

Құжаттар үшін нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары қоса алғанда, соңғы нүктелер.

19 аяқтық нүктелер→ { }

МойСклард

MoySklad-тың соңғы нүктелері, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

9 аяқтық нүктелер→ { }

Орналасу

Позицияның соңғы нүктелері, оның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

3 аяқтық нүктелер→ { }

Өкімдер

Тапсырмалар үшін нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары қоса алғанда, соңғы нүктелер.

44 аяқтық нүктелер→ { }

Өндiрушiлер

Өндірушілер үшін соңғы нүктелер, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

5 аяқтық нүктелер→ { }

Өнерлеу

Акциялар үшін нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары қоса алғанда, соңғы нүктелер.

11 аяқтық нүктелер→ { }

Өнім белгілері

Өнім тегтерінің соңғы нүктелері, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

9 аяқтық нүктелер→ { }

Өнім үлгілері

Өнім үлгілерінің соңғы нүктелері, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

14 аяқтық нүктелер→ { }

Өнімдер

Өнімдер үшін соңғы нүктелер, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

39 аяқтық нүктелер→ { }

Өнімдер тобы

Өнім топтары үшін соңғы нүктелер, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

6 аяқтық нүктелер→ { }

Өнімді таңбалау

Өнімді таңбалаудың соңғы нүктелері, оның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

28 аяқтық нүктелер→ { }

Параметрлер

Параметрлер үшін соңғы нүктелер, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

5 аяқтық нүктелер→ { }

Параметрлері

Орнатудың соңғы нүктелері, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

3 аяқтық нүктелер→ { }

Сапа куәліктері

Сапа сертификаттарының соңғы нүктелері, оның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

10 аяқтық нүктелер→ { }

Саптама

Инвентаризацияның соңғы нүктелері, оның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

46 аяқтық нүктелер→ { }

Сатып алу

Сатып алудың соңғы нүктелері, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

17 аяқтық нүктелер→ { }

Тапсырмалар

Тапсырмалар үшін нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары қоса алғанда, соңғы нүктелер.

3 аяқтық нүктелер→ { }

Тапсырыс берушілер

Тапсырыс берушілер үшін соңғы нүктелер, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

17 аяқтық нүктелер→ { }

Тауарлар

Тауарларды жеткізудің соңғы нүктелері, оның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

52 аяқтық нүктелер→ { }

Үй қоймалары

Үй қоймалары үшін соңғы нүктелер, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

35 аяқтық нүктелер→ { }

Фотосуреттер

Фотосессиялардың соңғы нүктелері, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

12 аяқтық нүктелер→ { }

Экспорт

Экспорттың соңғы нүктелері, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

38 аяқтық нүктелер→ { }

FBS тапсырыстары

FBS тапсырыстары үшін соңғы нүктелер, соның ішінде нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары.

69 аяқтық нүктелер→

Кірістер

Жалпы интеграциялық жұмыс барысы

Орындаушы-орындау нұсқаулықтар бірнеше аяқтық пункттерді біріктіріп, шақыру тәртібі, қауіпсіз синхрондалу және шегінен басқаруды түсіндіреді.

→

Басталу

Аутентификация, алғашқы сұрау, жергілікті қателер, бетін орналастыру және қауіпсіз өндіріс.

4 бөлімдері →

Өнімдер каталогы мен карточкалары

Өнімді іздеу, толық картаны алу, модель жасау, бренд және санатты сөздіктер және нарық параметрлері.

4 бөлімдері →

Тапсырмалар және кезең-кезеңмен қадамдастыру

Веб-дүкенде тапсырыстар жасау, дубликаттарды болдырмау, бетбелгіленген экспорттау және өзгертілген тапсырыстарды өңдеу.

4 бөлімдері →

Сатып алу және қоймалар

SKU үлгісі, қойма қорларын оқу, SelSup немесе сыртқы идентификаторлар арқылы жаңарту және қауіпсіз келісу.

5 бөлімдері →

Веб-хауктар және оқиғаға негізделген интеграция

Шығушы веб-қашықтықты орнату, қауіпсіз қабылдағыш, қос қорғау және API арқылы жоғалған оқиғаларды қалпына келтіру.

5 бөлімдері →

Қосымшалар және жекешелендіру

Сыртқы бэкэнд қызметі, кіріктірілген React UI және сервер жағындағы нарық немесе жеткізу модулі арасында таңдау.

5 бөлімдері

Manual first

Бұл неліктен басқа Сваггер терісі емес?

  • Жұмыс барысы мен мысалдар интегратордың көзқарасы бойынша жазылады.
  • Сұрау және жауап өрістері бөлек тізімделеді, ортақ Java модельдерінен сығу жоқ.
  • Қателер жалпы 400/500 орын иеленушілердің орнына бақылаушылар мен қызметтерден келеді.
  • Орыс және ағылшын тілдеріндегі мазмұн бірдей конструкция арқылы тексеріледі.