Ommaviy REST API

Orax'da ochiq REST API bor: kabinetda qiladigan hamma narsani dastur orqali qilish mumkin.

Ikki yarim

Ochiq qismi — umuman tokensiz. Mehmon o‘qiydigan sahifalarning o‘zi JSON sifatida: bilimlar bazasi, blog, sharhlar, lug‘at, shablonlar, holat, valyuta kurslari, domen zonalari ro‘yxati va domen tekshiruvi. ?lang=uz|ru|en parametri tarjimalarni bitta satr bilan qaytaradi.

Yopiq qismi — OAuth2 tokeni bilan: profil, xizmatlar va ularni boshqarish, buyurtmalar, hamyon, domenlar, monitorlar, xavfsizlik skanlari, xizmat aptaymi, serverlar, AI.

Kirish huquqlari

Token aynan kerakli huquqlar bilan beriladi: profile, services:read/write, orders:read/write, wallet:read/write, ai:read/write, domains:read/write, monitors:read/write.

Domenlar va monitorlar ataylab alohida chiqarilgan: shunday qilib faqat o‘qish uchun aptaym paneli berish mumkin, u bilan birga pul sarflash huquqini bermasdan.

Qanday boshlash

1. OAuth2 orqali avtorizatsiya qiling va kerakli huquqlar bilan token oling.
2. /api/v1 ga avtorizatsiya sarlavhasi bilan murojaat qiling.
3. Chastota cheklovini hisobga oling — daqiqasiga 90 so‘rov.

Hujjatlar

• /developers — umumiy ko‘rinish: API nima qila oladi, tokensiz ishlaydigan birinchi so‘rov.
• /api/docs — to‘liq ma’lumotnoma (OpenAPI/Redoc). U kodning o‘zidan generatsiya qilinadi: tavsiflangan huquqlar marshrutlardan o‘qiladi, shuning uchun hujjat server ruxsat bermagan narsani va’da qila olmaydi.

Nimani hisobga olish

• Pul doim dollarda, minor birliklarda (tiyinlarda).
• Ro‘yxatlar {data, meta} bilan sahifalab javob beradi; rad etish barqaror xato kalitini va tushunarli xabarni qaytaradi.
• Hech bir javobda parol yo‘q: server, FTP va baza parollari API'da umuman yo‘q — o‘qish tokeni root kirishga aylanmasligi kerak.
• Sozlamalarda o‘chirilgan bo‘lim API orqali ham 404 qaytaradi — bu shunday mo‘ljallangan.

Ai-agentlar uchun

MCP serveri bor (/api/v1/mcp) — standart Model Context Protocol orqali o‘sha hisob. Birinchi versiya faqat o‘qiydi: pul yo‘q va qaytarib bo‘lmaydigan narsa yo‘q.

Mobil ilova ham shu API'da ishlaydi. Hamkorlar uchun kalit bilan ishlaydigan alohida reseller API mavjud.