Hujjatlar
Bepul, kalitsiz API
Hozircha bitta endpoint bor va u autentifikatsiya talab qilmaydi. Oddiy HTTPS GET yuborasiz, JSON qaytadi.
Boshlash
Roʻyxatdan oʻtish, kalit olish yoki sarlavha qoʻshish shart emas. Brauzerda manzilni ochsangiz ham javobni koʻrasiz.
curl "https://apicloud.uz/v1/currency/rates"
Asosiy manzil: https://apicloud.uz. Javob Access-Control-Allow-Origin: * bilan qaytadi, shuning uchun brauzerdagi JavaScript'dan ham toʻgʻridan-toʻgʻri chaqirsa boʻladi.
Hisob ochish ixtiyoriy: u panelga kirish va platforma statistikasini koʻrish uchun kerak, API'dan foydalanish uchun emas.
Limitlar
Kalit yoʻq, shuning uchun chegara soʻrov manbasi (IP) boʻyicha hisoblanadi.
| Daqiqasiga | 60 ta soʻrov |
| Sutkasiga | 5 000 ta soʻrov |
| Jurnal saqlanish muddati | 90 kun |
Har bir javobda qolgan soʻrovlar soni sarlavhada keladi:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
X-RateLimit-Reset: 60
Chegara oshsa soʻrov 429 kodi va Retry-After sarlavhasi bilan rad etiladi.
Endpointlar
GET
/v1/currency/rates
Oʻzbekiston Markaziy bankining rasmiy kunlik valyuta kurslari
| Parametr | | Izoh |
|---|
valyuta | ixtiyoriy | Uch harfli kod, masalan USD, EUR, RUB. Yuborilmasa barcha valyutalar qaytadi |
Soʻrov
curl "https://apicloud.uz/v1/currency/rates?valyuta=USD"
Javob
{
"manba": "cbu.uz",
"sana": "22.09.2026",
"eskirgan": false,
"valyuta": {
"kod": "USD",
"raqam": "840",
"nom": "AQSH dollari",
"nom_en": "US Dollar",
"birlik": 1,
"kurs": 11809.82,
"farq": -29.77,
"sana": "22.09.2026"
}
}
Barcha valyutalar
curl "https://apicloud.uz/v1/currency/rates"
Javob
{
"manba": "cbu.uz",
"sana": "22.09.2026",
"eskirgan": false,
"soni": 74,
"valyutalar": [ ... ]
}
| Maydon | Izoh |
|---|
birlik | Kurs necha birlik valyuta uchun berilgani. Masalan yapon iyenasida 100 |
kurs | Soʻmdagi qiymat |
farq | Oldingi kunga nisbatan oʻzgarish, soʻmda |
eskirgan | true boʻlsa, cbu.uz javob bermagani uchun oxirgi saqlangan nusxa qaytarildi |
Xatoliklar
Xatolik yuz berganda javob har doim bir xil koʻrinishda boʻladi:
{ "xato": "'XYZ' valyutasi topilmadi." }
| Kod | Maʼnosi |
|---|
404 | Bunday valyuta kodi yoki bunday endpoint yoʻq |
429 | Chastota chegarasi oshdi: daqiqasiga 60 yoki sutkasiga 5 000 |
502 | cbu.uz javob bermadi va ishlatishga yaroqli saqlangan nusxa ham yoʻq |
Keyingi yangilanish
API kalitlari va kalit bilan ishlaydigan xizmatlar keyingi yangilanishda qoʻshiladi. Shu paytgacha katalogda faqat yuqoridagi ochiq endpoint bor - hujjatlarda hali ishlamaydigan xizmat koʻrsatilmaydi.
Kerakli API'ni hello@apicloud.uz manziliga yoki Telegram orqali taklif qilishingiz mumkin.