Integratsiya yaratish
1. Integratsiyalar bo'limini oching
Bito admin panelining chap menyusida Integratsiyalar → Integratsiyalar bo'limiga o'ting va Custom integratsiya tugmasini bosing. Integratsiya yaratish oynasida turini tanlang:
- Tashqi integratsiya — faqat API: kodingiz o'z serverlaringizda ishlaydi. Shu qatordagi + Yaratishni bosing; bu sahifa aynan shu yo'lni tasvirlaydi.
- O'z kodi bilan integratsiya — xuddi shu forma, ustiga Bito ichida ishlaydigan
widget.zip. Qarang: o'z hisobingiz uchun vidjet.
2. Shaklni to'ldiring
Bu bosqichda faqat nom majburiy, lekin ommaviy kartochka uchun qolganining ko'pi kerak bo'ladi. Har qanday maydonni keyin ham o'zgartirsa bo'ladi — faqat kartochka tekshiruvda (pending) turganda o'zgartirishlar rad etiladi.
| Maydon | Majburiy | Tavsif |
|---|---|---|
name | Ha | Marketplace'da ko'rinadigan, tillar bo'yicha nom. Kamida bitta tilni to'ldiring — qolganlari birinchi to'ldirilganidan nusxalanadi. |
description | Yo'q | O'rnatishdan oldin ko'rinadigan, tillar bo'yicha tavsif. |
thumbnail | Yo'q | Logotip havolasi. Avval rasmni yuklang — shakl havolani o'zi beradi. |
role_id | Yo'q | Eskirgan maydon (formada Integratsiya roli). Integratsiya so'rovi akkaunt egasi nomidan bajariladi, shuning uchun bu rol ruxsatlarni cheklamaydi; maydon faqat uni hali ham yuboradigan eski klientlar uchun qoldirilgan. Kirishni required_permissions bilan cheklang. |
required_permissions | Yo'q | Integratsiya Integration API'da foydalanadigan ERP ruxsatlari ro'yxati (rollar bilan bir xil kalitlar). Mijoz o'rnatishdan oldin aynan shu ro'yxatni ko'radi, o'rnatish uni integratsiyaga biriktiradi va har bir chaqiruv shu ro'yxat bo'yicha tekshiriladi. Bo'sh yoki yuborilmagan ro'yxat — barcha ruxsatlar. Oddiy formada bu maydon yo'q; u Mening ilovalarim → ilova → Asosiy ma'lumotda yoki API orqali beriladi. |
redirect_uri | OAuth uchun | Sizning HTTPS manzilingiz. Mijoz integratsiyani o'rnatganda Bito shu yerga avtorizatsiya kodini yuboradi. Qarang: o'rnatish hooklari. |
revoke_access_hook_uri | Qat'iy tavsiya etiladi | O'chirish haqidagi xabarnomalar uchun HTTPS manzilingiz. Usiz mijoz sizni o'chirganini bilmay qolasiz. |
webhook_uri | Yo'q | Ma'lumot webhooklari uchun manzil. Har bir o'rnatishda Bito unga bir qator kolleksiyalarning create/update/delete hodisalarini avtomatik obuna qiladi. Manzillarni API orqali ham ro'yxatdan o'tkazish mumkin — qarang: ma'lumot webhooklari. |
iframe.url | Vidjet uchun | Bito integratsiyangizning sozlamalar bo'limiga joylashtiradigan sahifa, bir martalik token bilan. Maxsus vidjet bunday ishlamaydi. |
ip_whitelist | Yo'q | Ruxsat etilgan manzillar ro'yxati: yagona IPv4 yoki CIDR subnet, ko'pi bilan 50 ta. Ro'yxat bo'sh bo'lsa, kalitlar istalgan manzildan qabul qilinadi; to'ldirilgan bo'lsa, boshqa manzildan kelgan Integration API so'rovi 403 bilan rad etiladi. Formadagi IP whitelist maydonida tahrirlanadi; ishlab chiquvchi ilovasida — Mening ilovalarim → ilova → Kalitlar → Ruxsat etilgan IP-manzillarda. |
duplicate_control | Yo'q | Integratsiya yaratgan yozuvlarga dublikat nazorati qo'llanilsinmi. |
multiple_sources | Yo'q | Integratsiya o'sha ma'lumotning boshqa manbalari bilan birga ishlaydimi. |
WARNING
Barcha manzillar https:// bo'lishi va internetdan ochilishi shart. Bito loopback manzillarni, ichki tarmoq manzillarini, bulut metadata manzillarini va ichida login-parol bo'lgan havolalarni qabul qilmaydi.
3. Saqlang va kalitlarni ko'chiring
Saqlashni bosing. Integratsiya yaratildi oynasi client_id, secret va api_keyni ko'rsatadi — secretni boshqa hech qachon ko'rib bo'lmaydi. Qarang: Kalitlaringiz.
4. Integratsiyani o'rnating
Yaratilgan integratsiya o'rnatilmagan bo'ladi va uning kalitlari bilan qilingan har bir API so'rovi Integration is not installed xatosini qaytaradi. Integratsiyalar sahifasidagi O'rnatilgan ro'yxatidan integratsiyani oching va O'rnatishni bosing. O'rnatish o'rnatish hookini yuboradi va webhook_uri obunasini yaratadi.