O'rnatish va o'chirish hooklari

O'rnatish

Mijoz integratsiyangizni o'rnatganda Bito redirect_uri'ingizga avtorizatsiya kodini POST qiladi. Foydalanuvchi qayta yo'naltirilmaydi — bu server-server murojaati.

Bito nima yuboradi

POST https://your-app.example.com/bito/installed
Content-Type: application/json
X-Bito-Signature: t=1736937000,v1=6b1f0a...c94e

{
    "code": "abc123def456",
    "client_id": "69c50a2d50f7b939923a469b",
    "account_id": "507f1f77bcf86cd799439011"
}

So'rov Bito'dan kelganini tekshiring

O'rnatish va o'chirish POST'larining ikkalasi ham X-Bito-Signature: t=<unix soniya>,v1=<hex> header'ini olib yuradi, bunda v1 = HMAC_SHA256(client_secret, "{t}.{raw_body}") tana baytlari bo'yicha hisoblanadi. Qayta hisoblang, doimiy-vaqt solishtiring va eskirgan (t ~5 daqiqadan ko'proq eski) so'rovlarni rad eting. To'liq izoh va kod uchun O'rnatish oqimi → So'rov haqiqatan Bito'dan kelganini tekshiring bo'limiga qarang.

Shu code'ni 20 daqiqa ichida tokenlarga almashtiring — qarang: API'ga murojaat. Olingan tokenlarni account_id bilan birga saqlang.

O'chirish

Mijoz integratsiyani o'chirganda Bito revoke_access_hook_uri'ingizga POST yuboradi.

Bito nima yuboradi

POST https://your-app.example.com/bito/revoked
Content-Type: application/json
X-Bito-Signature: t=1736937000,v1=6b1f0a...c94e

{ "account_id": "507f1f77bcf86cd799439011" }

Bu POST ham o'rnatishdagidek imzolanadi — ishonishdan oldin X-Bito-Signature header'ini tekshiring.

O'sha akkaunt bo'yicha saqlayotgan hamma narsani o'chiring yoki faolsizlantiring. Bito tomonida uning tokenlari allaqachon bekor qilingan.

WARNING

O'chirish o'sha akkauntdagi integratsiyangizning barcha webhooklarini o'chiradi. Mijoz keyinroq qayta o'rnatsa, webhook_uri obunasi avtomatik qayta yaratiladi, lekin webhook/subscribe orqali qo'shgan manzillaringizni qaytadan obuna qilishingiz kerak.

Qayta o'rnatish yangi imzo siri bermaydi: webhooklar mijoz siringiz (client_secret) bilan imzolanadi va u faqat siringizni yangilaganingizda o'zgaradi.