SelSup Developers

Аяқтан аяғына дейін жұмыс барысы · Кірістер

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

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

5 бөлімдеріДамушы нұсқаулығы
→

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

Іс-шараларға негізделген интеграциялар және артта тұрған қызметтер

01

Іс-шараларды және меншік иелігін анықтау

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

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

Жаңа таңдаулы өрісте белгілі оқиға құрылымының талдауын бұрмау керек.

Қатысушы API соңғы нүктелері

POST/api/webhook/Веб-хаук құруGET/api/webhook/Веб- түйіннің параметрлерін тізімі

02

HTTP қауіпсіз қабылдағышы орнатылсын

  1. 1

    Сұранысты шектеу

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

  2. 2

    Қайталануын тексеру

    Тізімделмеген URL немесе конфигурацияланатын бағандағы құпияны пайдаланып, API-гейтвей сүзгісін қосыңыз.

  3. 3

    Оқиға жалғасын тап

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

  4. 4

    Процесс асинхронды

    HTTP сұрау салғаннан гөрі ERP, WMS және басқа жүйелерді кезектен шақырыңыз.

!
Жауап жолы қысқа болсын

Сүлгілі жауап уақыт үзілуін және екі рет жеткізу тәуекелін арттырады.

Қабылдаушының ең төменгі үлгісі · JavaScript
app.post('/selsup/events/secret-path', async (request, response) => {
  const eventKey = createStableEventKey(request.body);
  const inserted = await inbox.insertOnce(eventKey, request.body);
  response.sendStatus(inserted ? 202 : 200);
});

03

Дубликаттар, тапсырыс беру және дедубликация

Дубликат беруді қалыпты түрде қараңыз. Қолданылған кезде тұрақты оқиға идентификаторын пайдаланыңыз; әйтпесе субъектінің түрі, субъектінің идентификаторы, өзгерту уақыты және мағыналы деректер хэшінен кілтті алыңыз.

Өткiрулер ретiнен тыс болуы мүмкiн. API арқылы ағымдағы субъектiн жазудан бұрын өзгертілген күнді салыстыру немесе қайта жүктеу.

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

i
Жіберілетін жол үлгісі

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

04

Ұсталған оқиғаларды қалпына келтіру

Веб-хауктер дұрыс болған кезде де API-ті кезең-кезеңмен үйлестіруді орындаңыз. Тапсырмалар үшін ауыстырылғанДатты және қойманы немесе инвентар үшін өзгертілген SKU-ны тексеріңіз.

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

Қатысушы API соңғы нүктелері

GET/api/order/findӨзімдікті өзгертулерді қалпына келтіруGET/api/wms/stock/findАкциялар өзгеруін салыстыру

05

Веб- түйіннің өмірлік циклін басқару

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

URL-ді ауыстыру немесе өшіру алдында жаңа қабылдаушы оқиғаларды қабылдағанын тексеріңіз. Көшірілгеннен кейін ескі құпияны қайтарып алыңыз.

Қатысушы API соңғы нүктелері

GET/api/webhook/Конфигурацияланған веб- кустарды қарауDELETE/api/webhook/{webhookId}Веб- түймесін өшіру