Тышкы REST-интеграция (API-ключ)
Тышкы REST-интеграция — бул башкарылуучу «эшик», ал аркылуу башка система (ERP, сайттын бэкенди, 1C же интеграциялык катмар, өзүнчө тиркеме) LadVen OSте тапшырмаларды жана келишимдерди стандарттык API менен кирүү ачкычы аркылуу түзө жана жаңырта алат. Мында эч ким логин менен паролду өткөрбөйт жана администратор атынан иштебейт.
Ар бир чакыруу өзүнчө кызматтык аккаунттан (боттон) минималдуу зарыл укуктар менен аткарылат: сиз уруксат берген аракеттер гана жана сиз белгилеген бөлүмдөрдө, долбоорлордо, воронкаларда жана этаптарда гана. Бардык суроо-талаптар порталдын адаттагы эрежелеринен өтөт — кирүү, текшерүүлөр, автоматташтыруу, эскертүүлөр — жана ар бир интеграция боюнча карап чыга турган журналга жазылат.
Туташуу Интеграциялар хабына бир жолу кошулат (CRM → Интеграциялар бөлүмү, /crm/integrations маршруту).
Качан колдонуу керек
REST-интеграция «башка системада бир нерсе болуп жатканда — LadVen OSте автоматтык түрдө тапшырма же келишим пайда болушу керек» болгондо керек. Типтүү сценарийлер:
- ERP же сайт заказ, өтүнмө же тикет келгенде тапшырма же кайрылуу түзөт;
- өзүнчө тиркеме тапшырмаларды жана келишимдерди тышкы база менен синхрондоштурууда кармайт;
- тышкы система иштин жүрүшүнө жараша файлдарды тиркейт, пикирлерди калтырат, убакытты каттайт же келишимди этаптар боюнча жылдырат.
Бул формалардан жана веб-хуктардан эмнеси менен айырмаланат: сайттын формасы жана веб-хук — бул CRMге өтүнмөлөрдү бир тараптуу кабыл алуу. REST-интеграция — бул программалык эки тараптуу байланыш: тышкы система окуйт да (тапшырмаларды, келишимдерди, тарыхты алат), жазат да (түзөт жана жаңыртат). Порталдын өзү бул туташуу аркылуу чыгуучу веб-хуктарды жөнөтпөйт — тышкы тарап порталга өзү кайрылат.
Кантип жөнгө салуу керек
Туташуу кадам-кадам устат аркылуу түзүлөт (CRM → Интеграциялар → «Тышкы REST-интеграция» кошуу). Кадамдар боюнча, иштиктүү терминдерде:
- Аталышы жана активдүүлүгү. Интеграцияга түшүнүктүү ат бериңиз жана аны дароо иштетүүнү чечиңиз. Туташууну текшерүүнү дароо иштетсе да болот.
- Кызматтык аккаунт. Бар болгон ботту тандаңыз же түз эле устатта жаңысын түзүңүз (аты жана логину). Бул кызматкер да, администратор да эмес: интеграция анын атынан иштейт. Эгер администратор укуктары бар аккаунтту тандасаңыз, устат эскертет — бул атайылап ушундай, интеграциялар минималдуу укук берет.
- Сценарий жана укук деңгээли. Тапшырмага ылайык операциялардын топтомун тандаңыз: «Тапшырмалар жана CRM», «Тапшырмалар гана» же «CRM гана». Андан кийин укук деңгээлин: окуу гана, түзүү жана түзөтүү же башкаруу. Укуктар ачкыч берилгенге чейин кызматтык аккаунтка колдонулат.
- Уруксат берилген аракеттер. Интеграцияга аткарууга болгон конкреттүү операцияларды белгилеңиз. Принцип — минималдуу зарылдык: чындап керек болгондорду гана иштетиңиз. Белгиленбегендин баары аткарылганга чейин четке кагылат.
- Чөйрө. Интеграцияны керектүү бөлүмдөр, долбоорлор, воронкалар жана этаптар менен чектеңиз. Бул — аккаунттун укуктарынын үстүнөн коюлган чек: уруксат берилген аракет да белгиленген чөйрөнүн ичинде гана иштейт.
- Талаалар жана лимиттер. Интеграция тапшырмалардын жана келишимдердин кайсы талааларын өзгөртө аларын, мүнөтүнө суроо-талап лимитин жана уруксат берилген чочуманы (всплеск), ошондой эле чакыруу уруксат берилген IP-даректердин ак тизмесин белгилеңиз.
- Ачкыч түзүү жана текшерүү. Сактаңыз — портал бир жолу кирүү ачкычын натыйжа экранында көчүрүү баскычы менен көрсөтөт. Ушул эле жерден туташууну текшерүүнү иштетсе болот.
Түзүлгөндөн кийин туташуунун суроо-талаптар журналы болот: кайсы операциялар чакырылган, кандай натыйжа менен жана ар бир чакыруу боюнча чоо-жайы менен (жазуулардагы купуя маалыматтар жашырылган).
Коопсуздук жана кирүү ачкычы
REST-интеграция эң аз укук принцибине курулган — бул бизнес ээси үчүн маанилүү:
- Ачкыч бир жолу көрсөтүлөт. Аны көчүрүп, дароо сырлар менеджерине сактап коюңуз. Портал бул ачкычты экинчи көрсөтпөйт жана аны ачык түрдө сактабайт. Эгер ачкычты алмаштыруу керек болсо — ушул туташуунун устатынан кайра өтүп, аны кайра чыгарыңыз.
- Өзүнчө кызматтык аккаунт. Интеграция адамдын же администратордун атынан иштебейт; анын өзүнүн жоопкерчилик чөйрөсү жана өзүнүн укуктары бар.
- Кирүү чектери. Уруксат берилген аракеттер, чөйрө (бөлүмдөр, долбоорлор, воронкалар, этаптар), талаалардын ак тизмеси, суроо-талап лимити жана IP ак тизмеси интеграция эмнени жана кайдан жасай аларын чектейт.
- Журнал. Ар бир чакыруу жазылган — интеграция аркылуу ким жана эмнени өзгөрткөнүн талдоого болот.
Скриншоттордо чыныгы ачкычты, авторизация аталышын, ак тизмедеги IP-даректерди же кызматтык аккаунттун логинин эч качан көрсөтпөңүз жана жарыялабаңыз. Иллюстрациялар үчүн ачыктан-ачык жасалма маанилерди колдонуңуз.
Көп кетирилүүчү каталар
- Интеграцияга кызматтык боттун ордуна администратор аккаунтун берүү.
- Минималдуу зарыл топтомдун ордуна керектүүдөн көп аракеттерди иштетүү.
- Түзүүдө бир жолку ачкычты көчүрүп калбоо.
- IP ак тизмесин жана суроо-талап лимитин белгилебөө.
- Өтө кенен чөйрөнү белгилөө — бир керектүү воронканын ордуна бүт портал.
- Портал өзү чыгуучу веб-хуктарды жөнөтөт деп күтүү: интеграция кирүүчү чакыруулар менен иштейт, тышкы система порталга кайрылат.
Иштеп жатканын кантип текшерүү керек
- Устаттын аягында туташууну текшерүүнү иштетиңиз (же текшерүүнү дароо иштетүүнү коюңуз).
- Туташуунун карточкасы активдүү жана түзүк абалды көрсөткөнүнө ынаныңыз.
- Суроо-талаптар журналын кароңуз — анда ийгиликтүү чакыруулар болушу керек.
- Сыноо тапшырмасы же келишими туура жооптуу, воронка жана этап менен пайда болгонун, ал эми автоматташтыруу жана эскертүүлөр адаттагыдай иштегенин текшериңиз.