API autentifikatsiyasi

Chato REST API ish maydoni API-kaliti orqali autentifikatsiya qilinadi — bu brauzerdagi shaxsiy sessiyangizdan alohida. Kalit ish maydoni egasi nomidan ishlaydi va REST API'ga to'liq kirish huquqini beradi.

Kalitni olish

Kalit shaxsiy kabinetda yaratiladi: Sozlamalar → API-kalit → "Yaratish". Chato xom kalitni faqat bir marta, yaratilgandan darhol keyin ko'rsatadi — uni darhol saqlang, qayta ko'rish imkonsiz. Kalitni qayta yaratish avvalgisini darhol bekor qiladi: eski kalitdan foydalanayotgan har qanday integratsiya ishlamay qoladi.

Asosiy manzil

https://chato.kz/api/v1

Qanday ishlatish kerak

Kalitni har bir so'rovda Authorization sarlavhasida yuboring:

GET /workspaces
Authorization: Bearer chato_sk_...

Bu so'rov ish maydonlaringizni ularning idsi bilan birga qaytaradi — u deyarli barcha boshqa so'rovlarda :workspaceId sifatida kerak bo'ladi.

Asosiy endpointlar

Kanallar ro'yxati:

GET /workspaces/:workspaceId/channels

Suhbatlar ro'yxati (filtrlar: status, assigned=me|none, cursor/limit orqali sahifalash):

GET /workspaces/:workspaceId/conversations?status=OPEN&limit=30

Muayyan kanalda yangi raqam bilan suhbat boshlash:

POST /workspaces/:workspaceId/conversations/start
Content-Type: application/json

{ "channelId": "clx...", "phone": "77011234567" }

Suhbat xabarlari:

GET /workspaces/:workspaceId/conversations/:conversationId/messages

Xabar yuborish:

POST /workspaces/:workspaceId/conversations/:conversationId/messages
Content-Type: application/json

{ "content": "Assalomu alaykum!" }

Cheklovlar

Kalit kabinetda qo'lda bekor qilinmaguncha amal qiladi. Uning brauzer JWT-sessiyasidan farqli o'laroq, o'z muddati yo'q — uni faqat kabinetda bekor qilish yoki qayta yaratish orqaligina o'chirish mumkin.