Savol-javob va nosozliklar

Kalitlar

Mijoz sirini yo'qotdim. Uni qayta ko'rish mumkinmi?

Yo'q. U faqat bir marta, yaratish paytida ko'rsatiladi. Yangisini olish uchun sirni yangilang — lekin yangilash integratsiyangizga ulangan barcha mijozlarni, barcha akkauntlarda, uzib qo'yishini unutmang.

Integratsiya tasdiqlanganda kalitlar o'zgaradimi?

Yo'q. Tasdiqlash kalitlarga tegmaydi. Ko'rinishni ham faqat kartochka tasdig'i o'zgartiradi: PRIVATE → PUBLIC. Relizni tasdiqlash kodni ishga tayyor qiladi, lekin ilovani ommaviy qilmaydi.

client_id hech qachon o'zgarmaydi. secret va api_key esa faqat siz ularni o'zingiz yangilaganingizda o'zgaradi: panelda Kalitlarni qayta chiqarish bitta so'rovda ikkala kalitni almashtiradi; faqat API kalitini almashtirish uchun panelda tugma yo'q — u API orqali regenerate_api_key: true bilan qilinadi. Qarang: Kalitlarni yangilash.

Ilova yoki integratsiya kodi nima?

API'da system_id sifatida saqlanadigan doimiy ommaviy slug. Mening ilovalarimda uni o'zingiz tanlaysiz, mavjudligini tekshirasiz va chop etishdan oldin band qilasiz. Bu amoCRM vidjet kodining Bito'dagi analogi; saqlangach nomini o'zgartirib bo'lmaydi. U chap menyu URL'laridagi {widget_code} va bito.widget.code qiymati hamdir.

Bitta API kalit bilan bir nechta mijozga xizmat qilsa bo'ladimi?

Yo'q. api_key bitta akkauntga tegishli. Ko'p mijoz uchun OAuth kerak — u yerda har bir o'rnatmaning o'z token juftligi bor.

Avtorizatsiya

Har bir so'rovga Integration is not installed keladi

Integratsiya yaratilganda o'rnatilmagan bo'ladi. Integratsiyalar sahifasidagi O'rnatilgan ro'yxatidan uni oching va O'rnatishni bosing — qarang: Integratsiya yaratish. Mijoz integratsiyani o'chirgandan keyin ham shu xato qaytadi.

403 va You don't have permission to access from this IP

Integratsiyada ip_whitelist to'ldirilgan va so'rov ro'yxatda yo'q manzildan keldi. Server manzilingizni (IPv4 yoki CIDR) ro'yxatga qo'shing yoki ro'yxatni bo'shating — qarang: Integratsiya yaratish.

Har bir so'rovga 401 Unauthorized keladi

Tartib bilan tekshiring: sarlavha nomi (api-key kalit uchun, Authorization: Bearer … OAuth uchun), kalitda username: prefiksi borligi va access token 24 soatdan oshmaganligi.

Access token 24 soat o'tmasdan ishlamay qoldi

Token ortidagi sessiya tugatilgan. Odatiy sabab — sirni yangilash, ikkinchisi — mijoz integratsiyani o'chirgani. Qayta avtorizatsiya qiling.

Kodni almashtirishda Invalid credentials

Yo kod allaqachon ishlatilgan, yoki 20 daqiqadan oshgan, yoki client_secret mos emas. Kod bir martalik — oqimni qaytadan boshlang.

Yangilash Invalid credentials bilan tugaydi

Refresh token har ishlatishda almashadi. Muvaffaqiyatli yangilashdan keyin eskisini saqlagan bo'lsangiz, u allaqachon o'lik. Yangi juftlikni eskisini ishlatgan tranzaksiyada saqlang.

Webhooklar

Obuna bo'ldim, lekin hech narsa kelmayapti

Manzil https:// ekanini, internetdan ochilishini va ichki tarmoqda emasligini tekshiring — Bito loopback, RFC1918, link-local va bulut metama'lumot manzillarini rad etadi. So'ng tekshirilayotgan o'zgarish ommaviy amaliyot bo'lmaganiga ishonch hosil qiling: ommaviy import va guruhli yangilashlar umuman webhook yubormaydi.

Imzo hech qachon mos kelmayapti

Deyarli aniq siz qayta serializatsiya qilingan tanadan HMAC hisoblayapsiz. Imzoni so'rovning xom baytlari bo'yicha, har qanday JSON.parse dan oldin hisoblang. Kalit — mijoz siringiz (client_secret); siringizni yangilagan bo'lsangiz, yangisini ishlating. Qarang: imzoni tekshirish.

Hodisa ikki marta / tartibsiz / umuman kelmadi

Uchala holat ham loyihaviy jihatdan mumkin. Yetkazib berish bitta urinish, qayta yuborishsiz va tartib kafolatisiz. Webhookni yozuvni qayta o'qish uchun ishora deb biling va vaqti-vaqti bilan to'liq o'qish orqali solishtiring.

Integratsiyam o'chirildi va webhooklar to'xtadi

O'chirish integratsiyaga tegishli barcha webhooklarni o'chiradi. Qayta o'rnatishda webhook_uri obunasi avtomatik qayta yaratiladi, webhook/subscribe orqali qo'shilgan manzillarni esa qaytadan obuna qilish kerak. Imzo siri o'zgarmaydi: bu mijoz siringiz (client_secret) va u faqat sirni yangilaganingizda almashadi.

Chop etish

Tekshiruv qancha davom etadi va nima tekshiriladi?

Bito marketplace kartochkasi va vidjet relizini alohida tekshiradi: matn, ruxsatlar, ochiq HTTPS lifecycle URL'lari, arxiv va manifest, e'lon qilingan nuqtalar, install/uninstall hamda haqiqiy Bito ichidagi test yo'li. Reliz uch bosqichdan tartib bilan o'tadi — kod, kartochka va foydalanish sinovi. Tekshiruvga yuborish va Tekshiruv va chop etishga qarang.

Arizam rad etildi

Avval qaysi oqim rad etilganini tekshiring. Kartochka sababi Asosiy ma'lumotda, reliz sababi esa Versiyalardagi o'sha versiyada chiqadi. Faqat o'sha oqimni tuzatib qayta yuboring; kartochka va reliz bitta umumiy holatga ega emas.

Reliz tasdiqlandi. Nega ilova marketplaceda yo'q?

Reliz tasdig'i kodni ishlashga tayyor qiladi, marketplace kartochkasini tasdiqlamaydi. Kartochkani Asosiy ma'lumotdan yuboring. Vidjet ilovasini chop etish paytida joriy reliz faqat lokal yoqilmagan, moderator tomonidan tasdiqlangan bo'lishi ham tekshiriladi.

Tasdiqlangach integratsiya hammaga o'rnatiladimi?

Yo'q. Tasdiqlash uni faqat marketplace'ga qo'shadi. Har bir mijoz uni o'zi o'rnatadi va har bir o'rnatish sizning o'rnatish hookingizni ishga tushiradi.

API xatti-harakati

Nega ro'yxatlar GET emas, POST orqali ishlaydi?

Chunki filtrlar so'rov satrida emas, JSON tanasida yuboriladi: sahifalash, sana oraliqlari va ichma-ich filtrlar URL'ga sig'maydi. Bitta yozuvni o'qish — GET, yangilash — PUT, o'chirish — DELETE. To'liq manzara — metodlar jadvalida.

E'tibor bering: Bito'ning admin API'si (veb-panel ishlatadigani) faqat POST qabul qiladi. Bu qoida bu yerda amal qilmaydi.

Yozuvni o'chirdim, lekin u qaytayapti

Bito yumshoq o'chirishdan foydalanadi. Yozuv belgilanadi, lekin yo'qolmaydi, va ko'p resurslarda get-deleted endpointi bor. Faqat tirik yozuvlar kerak bo'lsa, o'z tomoningizda filtrlang.

Faqat o'zgarganini qanday sinxronlayman?

Ko'pchilik get-paging endpointlari updated_at filtrini qabul qiladi. Oxirgi sinxronizatsiya vaqtini saqlang va uni yuboring — bu butun kolleksiyani har safar aylanib chiqishdan ancha arzon.

Yozuv so'rovlari idempotentmi?

Yo'q. Takroriy create ikkinchi yozuv yaratadi. Qayta yuborishdan oldin o'z tomoningizda dublikatni tekshiring.

Yordam kerakmi? Qo'llab-quvvatlashga yozing.