Ilova sahifasi

Ommaviy integratsiyalar Integratsiyalar → Mening ilovalarim ichida boshqariladi. Sahifa Asosiy ma'lumot, Versiyalar, Statistika, Sharhlar va Kalitlar bo'limlariga bo'lingan; marketplace kartochkasi va bajariladigan vidjet relizlari alohida tekshiruvdan o'tadi.

Faol developer hisobi kerak va developer amallarini Bito hisob egasi bajarishi shart.

1. Ilova asosini yarating

Mening ilovalarimda Custom integratsiyani bosing va Integratsiya yaratish oynasida kerakli qatordagi + Yaratishni tanlang:

Tur	Qachon tanlanadi
Tashqi integratsiya	Servis Integration API'ni chaqiradi, lekin Bito ichida JavaScript bajarmaydi
O'z kodi bilan integratsiya	Ilova Bito ichida ulanadigan widget.zipni ham yetkazadi

Dastlabki shaklni to'ldirib Saqlashni bosing. Bito client_id, secret va api_keyni ko'rsatadi; secret faqat shu bir marta ko'rinadi. Oynani yopishdan oldin uchalasini ham nusxalang.

Ilova o'z akkauntingizda o'rnatilmagan holda yaratiladi. Uni sinash uchun Integratsiyalar sahifasidagi O'rnatilgan ro'yxatidan oching va O'rnatishni bosing — o'rnatilmaguncha API so'rovlari Integration is not installed qaytaradi va vidjet ulanmaydi.

2. Doimiy ilova kodini band qiling

Yangi ilovani ochib ilova kodini tanlang:

warehouse_helper

Kod 3–32 belgidan iborat, kichik lotin harfi bilan boshlanadi va faqat kichik lotin harflari, raqamlar hamda pastki chiziqni ishlatadi. Saqlashdan oldin Bandligini tekshirishni bosing.

Kod doimiy. Bito boshqa developer band qilgan yoki ichki integratsiyaga ajratilgan kodni rad etadi. U ilovaning ommaviy identifikatoriga aylanadi, shuning uchun keyin nomini almashtirish yo'q.

3. Asosiy ma'lumotni to'ldiring

Maydon	Nima uchun
Kategoriya	Marketplace kategoriyasi
Redirect URL	HTTPS o'rnatish/OAuth callback'i
Access revoke hook URL	HTTPS o'chirish callback'i
Webhook URL	Standart ma'lumot webhook manzili
Iframe URL	Ixtiyoriy hosted sozlamalar sahifasi; in-page maxsus vidjetdan alohida
Grant access	O'rnatishdan oldin mijozga ko'rsatiladigan Integration API ruxsatlari
Monetizatsiya	Bepul yoki ochiq narx sahifasi bilan To'lov o'z saytimda

Bo'sh ruxsatlar ro'yxati to'liq Integration API kirishini anglatadi. Faqat zarur kalitlarni e'lon qiling; mijoz aynan shu shartnomani ko'radi va qabul qiladi.

4. Marketplace kartochkasini tayyorlang

Chop etiladigan tillarni va standart tilni tanlang. Har tanlangan tilning o'z kartochkasi bor:

• integratsiya nomi va qisqa nomi;
• o'rnatishdan oldingi tavsif;
• o'rnatishdan keyingi sozlash yo'riqnomasi;
• 400×272 marketplace rasmi va 108×108 o'rnatilgan logo;
• 1188×616 galereya rasmlari;
• maxfiylik siyosati URL'i;
• yordam URL'i yoki emaili.

O'rnatishdan keyingi matnda #SUBDOMAIN#, #ACCOUNT_ID# va #USER_ID# ishlatiladi. Bito ularni o'rnatilgan kartochka o'qilganda almashtiradi.

Kartochkaning alohida holatlari bor:

Holat	Ma'nosi
draft	Hali yuborilmagan
pending	Kartochka tekshiruvda; kartochka qulflanadi, versiyalar bilan ishlash davom etadi
approved	Tekshirilgan kartochka ommaga chiqarilgan
changed	Ommaviy kartochka tahrirlangan; yangi o'zgarish tasdiqlanmaguncha eski tasdiqlangan nusxa ko'rinadi

5. Versiya yarating va sinang

Versiyalarda 1.0.0 kabi semantik versiya yarating, yangiliklar matnini yozing va widget.zip yuklang. Bito arxivni darhol tekshiradi va barcha xatolarni ko'rsatadi.

Ilova hali shaxsiy paytda versiya qatoridagi Saqlash tugmasi uni faqat developer tenantida yoqadi (lokal faollashtirish). Oldindan ko'rish va haqiqiy Bito interfeysida barcha e'lon qilingan nuqtalarni sinang. Bu lokal faollashtirish moderatsiya emas va ilovani ommaga chiqarish uchun yetarli emas.

Kartochka Asosiy ma'lumotda tahrirlanadi. Versiya yaratilganda joriy kartochka o'zgarmas reliz nusxasiga olinadi; keyingi tahrirlar moderator ko'rgan narsani o'zgartirmaydi.

6. Ikki tekshiruvni yuboring

Ommaviy vidjetda ikki topshirish bor:

1. Versiyalardagi reliz tekshiruvi aniq arxiv va versiyani tekshiradi.
2. Asosiy ma'lumotdagi kartochka tekshiruvi marketplace identifikatsiyasi, matn, URL, ruxsat va tijoriy ma'lumotlarni tekshiradi.

Ular bir-birini qulflamaydi. Birinchi chop etish uchun tavsiya etilgan tartib:

Kartochkani to'ldirish -> reliz yaratish -> yuklash -> tekshirish -> lokal sinash
-> relizni yuborish -> reliz tasdiqlanishi -> kartochkani yuborish -> kartochka tasdiqlanishi -> public

Kartochkani reliz tekshirilayotganda ham yuborish mumkin, lekin moderator joriy relizi inson tomonidan tasdiqlanmagan vidjet ilovasini chop eta olmaydi. Faqat API ilovasiga reliz kerak emas.

Ishlangan misol: ommaviy ombor vidjeti

Bu misol amoCRM ommaviy vidjet qo'llanmasidagi yo'lni takrorlaydi, ammo Bito maydonlari va paket shartnomasidan foydalanadi.

1. Developer ruxsatini oling va “Warehouse Helper” nomli Vidjet integratsiyasi yarating.
2. Kalitlarni saqlang va warehouse_helper kodini band qiling.
3. https://integration.example.com domenidagi install va revoke URL'larini kiriting, faqat mahsulot va ombor uchun zarur ruxsatlarni tanlang, yordam/maxfiylik havolalarini qo'shing.
4. O'zbek, rus va ingliz kartochkalarini to'ldiring.
5. 1.0.0 versiyasini yarating, to'g'ri widget.zip yuklang va lokal saqlang.
6. Barcha nuqtalar, o'chirish/qayta o'rnatish, callback va rozilikni sinang.
7. 1.0.0ni reliz tekshiruviga yuboring. Rad etilsa tuzating va qayta yuboring.
8. Reliz tasdiqlangach kartochkani yuboring. Kartochka tasdiqlangach mijozlar ilovani topib, o'rnatib, 1.0.0ga rozilik beradi.

Keyingi sahifalar: Relizni chop etish va Tekshiruvga yuborish.