SelSup Developers

Толук иш жүрүшү · Жол башчылары

Веб-хок жана иш-чараларга негизделген интеграция

Чыгуучу веб-чатак орнотуу, коопсуз кабыл алуучу, дубликат коргоо жана API аркылуу жоголгон окуяларды калыбына келтирүү.

5 бөлүктөрДевелоперлер үчүн колдонмо
→

Веб-хоктор өзгөрүүлөрдүн кечиктирүүсүн азайтат, бирок чындыктын булагын алмаштырышпайт.

Иш-чараларга негизделген интеграциялар жана арткы чегиндеги кызматтар

01

Окуяларды жана менчик укуктарын аныктоо

Жаңы же өзгөртүлгөн буйрук, запас өзгөрүшү же баа өзгөрүшү сыяктуу бир иш-чарадан баштоо. Ар бир иш чара үчүн маалыматтардын ээси жана алуучунун аракетин аныктоо.

Негизги веб-хок жүктөрүн нормалдаштырылган моделден бөлүп, чектелген убакытка сактаңыз.

Жаңы тандоо талаасы белгилүү окуялар структурасынын талдоону бузууга тийиш эмес.

API менен байланышкан чектөөлөр

POST/api/webhook/Веб-чатак түзүүGET/api/webhook/Веб- кутуча орнотууларын тизмелөө

02

HTTP кабыл алуучусун орнотуу

  1. 1

    Суроону чектөө

    Тек гана талап кылынган ыкмаларды жана мазмун түрлөрүн кабыл ал, дене өлчөмүнүн чегин күчөт жана кыска убакыттан кийин окууга убакыт бөл.

  2. 2

    Чыгарманы текшерүү

    Жашыруун URL же конфигурацияланган башкычта сыр колдонсоңуз жана API-gateway чыпкасын кошоңуз.

  3. 3

    Иш-чара улантылсын

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

  4. 4

    Процесс асинхрондук

    ЭРП, WMS жана башка системаларды HTTP өтүнүчүнүн ордуна кезектен чалуу.

!
Жообу кыска болсун

Тез жооп берүү убакыттын өтүшү жана эки жолу жеткирүү коркунучун жогорулатат.

Минималдык кабыл алуучу үлгүсү · 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

Дубликат, тартип жана дедубликат

Дубликат берүү нормалдуу түрдө колдонулат. Бар болгондо туруктуу окуяны идентификаторду колдонуңуз; болбосо ачкычты субъекттин түрүнөн, субъекттин идентификаторунан, өзгөртүү убактысынан жана маанилуу маалыматтардын хэшинен алыңыз.

Окуялар тартипте болбошу мүмкүн. API аркылуу учурдагы түзүлүштү жазуудан мурун өзгөртүлгөн датаны салыштыруу же кайра жүктөө.

Иш-чаранын ийгиликтүү абалын кайтаруу. Болбосо жөнөтүүчү аяктаган ишти кайра аракет кыла берет.

i
Баракчанын үлгүсү

Өзгөчө окуялар ачкычы, абалы жана аракет саноосу менен кирген окуялар таблицасы дедупликацияны, ойнотууну жана аудитти жөнөкөйлөтөт.

04

Калган окуяларды калыбына келтирүү

Убактылуу API шайкештигин иштеп чыгуу, ал тургай, веб-хоуктар ден-соолукка пайдалуу.

Алуучунун өчүрүлгөндөн кийин, кире турган кутучаны агызыңыз жана толук өчүрүү терезеси үчүн өзгөртүүлөрдү өтүнүңүз.

API менен байланышкан чектөөлөр

GET/api/order/findТоктомдун өзгөрүүлөрүн калыбына келтирүүGET/api/wms/stock/findАкциялык өзгөрүүлөрдү шайкештирүү

05

Веб- кучактагы жашоо циклин башкаруу

Активдүү URL, иш-чаранын түрү, акыркы ийгиликтүү кабыл алуу жана интеграцияңыздагы акыркы error көрсөтүңүз. Бул түздөн-түз серверге кирүүсүз диагноз коюуга мүмкүндүк берет.

URLди алмаштыруудан же жок кылуудан мурун жаңы кабыл алуучу окуяларды кабыл алганын текшериңиз.

API менен байланышкан чектөөлөр

GET/api/webhook/Конфигурацияланган веб- кутучаларды карап чыгууDELETE/api/webhook/{webhookId}Веб-чатактарды өчүрүү