Перейти к основному содержанию
Кіріс хук — сыртқы жүйе оқиға жіберетін мекенжай: төлем түсті, тапсырыс рәсімделді, мәміле жабылды. Әр жаңа оқиға осы хукқа байланған сценарийлерді іске қосады. ЖИ-бухгалтер оқиғаны тапсырмамен бірге алып, оны талдайды. Вебхукпен шатастырмаңыз. Кіріс хук оқиғаларды сізден қабылдайды. Вебхук, керісінше, Tungo оқиғаларын сіздің серверіңізге жібереді, мысалы іске қосудың аяқталғаны туралы. Олардың мекенжайлары да, құпиялары да, қолдары да бөлек. Вебхуктар туралы: Оқиғаларды алу (вебхуктар).

​
Хук пен сценарий құру

1

Компанияның хуктарын ашыңыз

Платформада Автоматтандыру → Хуктар мен ережелер бөлімін ашып, оң жақ жоғарыда компанияны таңдаңыз және «Кіріс хуктар» қойындысында қалыңыз.
2

Хук құрыңыз

Жаңа хук түймесін басыңыз. «Атауы» өрісіне оқиғалардың қайдан келетінін жазыңыз. «Оқиғадағы нөмірі қайда» және «Қол құпиясы» өрістері төменде сипатталған: оларсыз сценарий құжаттарды тек дайындай алады. Сақтау түймесін басыңыз.
3

Мекенжайды көшіріп алыңыз

Хук мекенжайы бар терезе ашылады. Оны бірден көшіріп алыңыз: ол енді еш жерде көрсетілмейді.
4

Мекенжайды жіберушіде көрсетіңіз

Мекенжайды оқиға жіберетін жүйенің баптауларына қойыңыз. Оқиғалар POST сұрауымен, әдетте JSON форматында жіберіледі.
5

Сценарийді байлаңыз

Автоматтандыру бөлімінде Жаңа сценарий түймесін басып, «Қашан іске қосу» өрісінде «Хук оқиғасы бойынша» нұсқасын, ал «Хук» өрісінде хукты таңдаңыз. Тапсырмада оқиғамен не істеу керегін сипаттаңыз.
Хукты компанияда «Компания автоматтандыруларын құру және өзгерту» құқығы мен ЖИ-бухгалтерге қолжетімділігі бар адам құра алады: хук оқиғалары ЖИ-дің ақылы жұмысын іске қосады. Хук бойынша сценарий қолмен іске қосылмайды: онда «Қазір іске қосу» түймесі жоқ, оған оқиға керек. Хукты сынақ оқиғамен тексеруге және сценарийді өткен оқиғада 1С-ке жазбай жүргізіп көруге API арқылы болады, API анықтамасын қараңыз.

​
Хук мекенжайы құпиясөз қызметін атқарады

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

​
Қол

Қол оқиғаны мекенжайды біліп алған бөгде адам емес, өз жіберушіңіз жібергенін дәлелдейді. «Қол құпиясы» өрісінде кемінде 16 таңбадан тұратын құпия қойып, сол құпияны жіберушіде де көрсетіңіз. Сақталғаннан кейін құпия көрсетілмейді. Жіберуші сұрау денесінен осы құпиямен HMAC-SHA256 есептеп, нәтижесін он алтылық жол түрінде x-signature тақырыбында жібереді. sha256= қосымшасына рұқсат етіледі. Жүйеңіз қолды басқа тақырыпқа салатын болса, оның атын «Қол тақырыбы» өрісінде көрсетіңіз. Құпия қойылып тұрғанда, қолы жоқ немесе қолы қате оқиға қабылданбайды. Хуктар тізімінде мұндай хукта «Тексеріледі», ал құпиясы жоқ хукта «Қолсыз» деп тұрады. Тексеруге арналған сұрау мысалы:

​
Оқиға нөмірі

Жүйелер жауап күтіп жете алмаса, бір оқиғаны жиі қайта жібереді. Қайталанған оқиға сценарийді екінші рет іске қоспауы үшін Tungo оқиға нөмірін есте сақтайды. «Оқиғадағы нөмірі қайда» өрісінде оқиға денесіндегі төлем немесе чек нөміріне апаратын жолды көрсетіңіз. Кірістірілген өрістер нүкте арқылы жазылады: мысалдағы оқиға үшін бұл id, ал payment блогының ішіндегі нөмір үшін — payment.id. Нөмірі бұрын келген оқиға қабылданады, бірақ сценарийлерді іске қоспайды. Нөмірлер мерзімсіз сақталады, сондықтан жіберуші бір нөмірді әртүрлі операцияларға қолданбауы керек: екіншісі қайталау деп есептеледі. Жол көрсетілмесе, нөмір Idempotency-Key немесе X-Event-Id тақырыбынан алынады. Олар да жоқ болса, біріншісінен кейін көп ұзамай келген, денесі дәл сондай оқиға қайталау деп есептеледі. Сценарий құжаттарды 1С-ке өзі жазуы керек болса, қол мен оқиға денесінен алынған нөмір міндетті. Олардың кез келгені болмаса, құжаттар адамды күтеді: Сценарийге 1С-ке жазуға рұқсат беру.

​
Жіберуші қандай жауап алады

  • 202: жаңа оқиға қабылданды, сценарийлер іске қосылып жатыр.
  • duplicate белгісі бар 200: бұл қайталау, сценарийлер іске қосылған жоқ.
  • 401: қол сәйкес келмейді.
  • 404: мұндай хук жоқ. Өшірілген және жойылған хук та осылай жауап береді.
  • 413: оқиға тым үлкен.
  • 429: оқиғалар тым көп немесе компанияның іске қосулар кезегі толған. Жіберуші кейінірек қайталауы керек.
Компанияның автоматтандырулары кідірісте тұрса, оқиғалар қабылданып, кідіріс алынғанша кезекте күтеді.

​
Әрі қарай