Narxlar

Qoida

Faqat muvaffaqiyatli javoblar (HTTP 2xx) uchun to’lanadi. Muvaffaqiyatsiz so’rovlar (4xx, 5xx) yechib olinmaydi. Balans yetarli bo’lmasa, API 400 va {"detail": "Not enough balance..."} qaytaradi va hech narsa yechib olinmaydi. Bu holatda billing sarlavhalari nol yechim va joriy balansni ko’rsatadi.

Metodlar narxi

Endpoint	Narx
GET /v1/me/	Bepul
POST /v1/me/reset-token	Bepul
GET /v1/search/	1₽
GET /v1/groups/{identifier}	2₽
GET /v1/users/{identifier}	groups va cl_groups bo’sh bo’lsa 1₽; aks holda 4₽
GET /v1/users/{identifier}/similar	6₽
GET /v1/groups/{identifier}/similar	1₽
GET /v1/groups/{identifier}/members	1₽ / 5₽ / 15₽1

Barcha narxlar rubllarda.

¹ Eksportga kirish narxi uning hajmiga bog’liq: 1–10 a’zo — 1₽, 11–49 ta — 5₽, 50 ta va undan ko’p — 15₽. Batafsil hisob-kitob va takroriy so’rov qoidalari endpoint hujjatida berilgan.

Billing sarlavhalari

Har bir muvaffaqiyatli pullik endpoint javobida:

Sarlavha	Ma’nosi
Telesint-Billing-Charged	Shu so’rov uchun yechilgan rubl miqdori.
Telesint-Billing-Balance	So’rov bajarilgandan keyingi joriy balans.
Cache-Control	Javob hisobga xos billing ma’lumotini saqlagani uchun private, no-store.

Billing JSON tanasiga qo’shilmaydi; resurs modeli o’zgarmaydi.

Balansni tekshirish

curl -H "Api-Key: $API_KEY" https://api.telesint.dev/v1/me/

{
  "id_": 436307416,
  "balance": 109992,
  "multiplier": 1,
  "roles": [],
  "notification_threshold": 20
}

• balance — joriy qolgan mablag’, rubllarda.
• multiplier — balansni to’ldirish ko’paytirgichi.
• notification_threshold — past balans haqida ogohlantirish keladigan chegara. Bot ichida sozlanadi.

Hisob-kitob misollari

Stsenariy	Arifmetika	Jami
Guruh ma’lumotlari bor 100 foydalanuvchi profilini ID bo’yicha olish	100 × 4₽	400₽
Guruh ma’lumotlari bor 50 ta to’liq profilni topish va olish	50 × 1₽ + 50 × 4₽	250₽
20 ta guruhga va ularning o’xshashlariga kirish	20 × 2₽ + 20 × 1₽	60₽
Haftada har daqiqa /v1/me/ so’rovi	10 080 × 0₽	0₽

Xarajatlarni nazorat qilish

1. Past balans haqida oldindan bilish uchun botda notification_threshold ni belgilang.
2. Vaqti-vaqti bilan /v1/me/ ni so’rab, balance ni kuzatib boring — bu chaqiruv bepul.