Overview

BILLZ 2.0 Public API 2026.08

BILLZ 2.0 ning integratsiyalar (eCommerce, marketpleyslar, BI, botlar) uchun ochiq REST API si. ## Autentifikatsiya

UI da integratsiya kalitini yarating: Sozlamalar → Kompaniya sozlamalari → Integratsiya kalitlari.
POST /v1/auth/login {"secret_token": "<kalit>"} tanasi bilan → access_token + refresh_token.
Qolgan barcha so’rovlar: Authorization: Bearer <access_token> sarlavhasi.
Kirish tokeni muddati tugagach — refresh_token bilan POST /v2/auth/refresh. Faqat shu metodga 7d4a4c38-dd84-4902-b744-0488b80a4c01 qiymatli platform-id sarlavhasi kerak; qolgan metodlarga u kerak emas. Allaqachon ishlatilgan yangilash tokenini qayta ishlatish butun sessiyalar oilasini bekor qiladi. ## Sinxron va asinxron metodlar Metodlarning bir qismi (sotuv yaratish, mijoz balansini o’zgartirish, ombor operatsiyalari) asinxron bajariladi: 200 {"message": "<correlation_id>"} javobi so’rov qabul qilinganini bildiradi, operatsiya tugaganini emas. Natijani o’sha HTTP javobida kutish uchun Billz-Response-Channel: HTTP ni uzating — sarlavha yoki query-parametr ?Billz-Response-Channel=HTTP sifatida. Maksimal kutish — 600 soniya, so’ngra 408 error.code = TIMEOUT bilan; Excel’ga hisobot eksportida kutish qisqaroq — 100 soniya. Qaysi metodlar asinxron ekani — har bir metodda belgilangan. ## Ruxsatlar Integratsiya kaliti asosiy metodlarni ochadi. Sezgir metodlar berilgan ruxsatlarni talab qiladi (kalit roli + bo’limlardagi ruxsatlar), aks holda — 403. ## Cheklovlar

Perimetrdagi rate limit: bitta IP dan soniyasiga taxminan 2 so’rov, oshib ketganda — 429.
Mahsulot fotolarini BILLZ CDN dan to’g’ridan-to’g’ri tashqi saytlarga uzatish taqiqlanadi — mediani o’zingizda keshlang.
IP/geo-cheklovlar yo’q, biroq evristik trafik analizatori DDoS yoki bot trafigi belgilari bo’lsa IP ni bloklashi mumkin.

BILLZ API changes

Information

POST /v1/auth/login orqali olingan JWT access token. Amal qilish muddati — 15 kun.

Security scheme type: http

Bearer format: JWT