Интеграторлар үшін 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
}

Тез бастау

Үш қадамдағы алғашқы өтінішіңіз

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

{ }

Аналитика

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

Аяқ нүктелері: 108→ { }

Ауыру

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

Аяқ нүктелері: 1→ { }

Бағалар

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

Аяқ нүктелері: 18→ { }

БАҚ

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

Аяқ нүктелері: 1→ { }

Брендтер

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

Аяқ нүктелері: 9→ { }

Білім базасы

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

Аяқ нүктелері: 33→ { }

Веб-хоктар

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

Аяқ нүктелері: 3→ { }

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

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

Аяқ нүктелері: 5→ { }

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

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

Аяқ нүктелері: 74→ { }

Есептеуші

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

Аяқ нүктелері: 2→ { }

Жабдықтау

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

Аяқ нүктелері: 14→ { }

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

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

Аяқ нүктелері: 16→ { }

Жарыстар

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

Аяқ нүктелері: 12→ { }

Жеткізу

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

Аяқ нүктелері: 18→ { }

Жұмысқа

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

Аяқ нүктелері: 10→ { }

Импорт

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

Аяқ нүктелері: 31→ { }

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

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

Аяқ нүктелері: 23→ { }

Квитанция

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

Аяқ нүктелері: 4→ { }

Келуші

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

Аяқ нүктелері: 19→ { }

Клиенттер

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

Аяқ нүктелері: 5→ { }

Кілті сөздер

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

Аяқ нүктелері: 12→ { }

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

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

Аяқ нүктелері: 15→ { }

Қайта беру

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

Аяқ нүктелері: 3→ { }

Қаржы

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

Аяқ нүктелері: 26→ { }

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

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

Аяқ нүктелері: 5→ { }

Құжаттар

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

Аяқ нүктелері: 20→ { }

МойСклард

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

Аяқ нүктелері: 12→ { }

Орналасу

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

Аяқ нүктелері: 3→ { }

Өкімдер

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

Аяқ нүктелері: 51→ { }

Өндiрушiлер

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

Аяқ нүктелері: 5→ { }

Өнерлеу

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

Аяқ нүктелері: 11→ { }

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

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

Аяқ нүктелері: 9→ { }

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

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

Аяқ нүктелері: 14→ { }

Өнімдер

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

Аяқ нүктелері: 53→ { }

Өнімдер тобы

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

Аяқ нүктелері: 6→ { }

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

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

Аяқ нүктелері: 53→ { }

Параметрлер

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

Аяқ нүктелері: 5→ { }

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

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

Аяқ нүктелері: 3→ { }

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

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

Аяқ нүктелері: 11→ { }

Саптама

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

Аяқ нүктелері: 53→ { }

Сатып алу

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

Аяқ нүктелері: 17→ { }

Тапсырмалар

Аяқ нүктелері: 4→ { }

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

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

Аяқ нүктелері: 17→ { }

Тауарлар

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

Аяқ нүктелері: 67→ { }

Үй қоймалары

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

Аяқ нүктелері: 41→ { }

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

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

Аяқ нүктелері: 12→ { }

Экспорт

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

Аяқ нүктелері: 40→ { }

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

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

Аяқ нүктелері: 94→

Кірістер

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

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

→

Басталу

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

Бөлімдер: 4 →

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

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

Бөлімдер: 4 →

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

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

Бөлімдер: 4 →

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

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

Бөлімдер: 5 →

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

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

Бөлімдер: 5 →

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

Кез келген кадрды пайдалана отырып, әдеттегі HTML/JavaScript беттерін құру. SelSup оны iframe-ге енгізеді; ол сіздің React кодын шкафтың ішінде орындамайды.

Бөлімдер: 11

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

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