Bepul soxta REST API

Boshlash

Brauzerda manzilni ochsangiz ham javobni koʻrasiz. Asosiy manzil: https://apicloud.uz/v1.

curl "https://apicloud.uz/v1/posts/1"

const r = await fetch("https://apicloud.uz/v1/posts?_limit=5");
const posts = await r.json();
console.log(r.headers.get("X-Total-Count"), posts[0].title);

import requests

r = requests.post("https://apicloud.uz/v1/posts",
                  json={"title": "Salom", "body": "Matn", "userId": 1})
print(r.status_code, r.json()["id"])  # 201 101

Javob Access-Control-Allow-Origin: * bilan qaytadi, shuning uchun brauzerdagi JavaScript'dan ham toʻgʻridan-toʻgʻri chaqirsa boʻladi. Soʻrovni bosh sahifadagi jonli sinovda ham yuborib koʻring.

Hisob ochish ixtiyoriy: u faqat panelga kirish uchun, API uchun emas.

Resurslar

Maʼlumot har doim bir xil, tasodifiy emas. Roʻyxat oddiy JSON massiv, jami soni X-Total-Count sarlavhasida.

Bogʻlanishlar: posts.userId → users, todos.userId → users, comments.postId → posts. Ichma-ich manzillar:

GET /v1/users/1/posts
GET /v1/users/1/todos
GET /v1/posts/1/comments

Namuna (GET /v1/users/1):

{
  "id": 1,
  "name": "Sevara Aliyeva",
  "username": "sevara.aliyeva",
  "email": "sevara.aliyeva@example.com",
  "phone": "+998 95 698 40 64",
  "city": "Navoiy",
  "age": 30
}

Barcha endpointlar

Toʻliq roʻyxat: 16 ta manzil. Manzilni bossangiz, GET namunasi brauzerda ochiladi. Boshqa usullarni jonli sinovda yuboring.

Parametrlar

Hamma roʻyxat manzillarida ishlaydi. Notoʻgʻri qiymat jimgina tuzatilmaydi, 400 qaytadi.

curl "https://apicloud.uz/v1/products?category=elektronika&price_lte=500000&_sort=price&_order=desc&_limit=5"

Yozish soʻrovlari

Soʻrov tekshiriladi va haqiqiydek javob qaytadi, lekin hech narsa saqlanmaydi: keyingi GET oʻzgarishni koʻrmaydi. Tana JSON obyekt boʻlishi va 16 KB dan oshmasligi kerak.

Maydon turi, majburiy maydonlar va bogʻlanish (masalan mavjud userId) tekshiriladi. Notoʻgʻri boʻlsa 422 va maydonma-maydon xabar keladi. Nomaʼlum maydonlar javobda aynan qaytariladi.

curl -X POST https://apicloud.uz/v1/users -H "Content-Type: application/json" -d '{"name":"Test"}'

422
{ "xato": "Maʼlumotlar notoʻgʻri.", "maydonlar": { "email": "Majburiy maydon." } }

Sinash vositalari

Limitlar

Kalit yoʻq, shuning uchun chegara soʻrov manbasi (IP) boʻyicha hisoblanadi.

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.

Xatoliklar

Xatolik yuz berganda javob har doim bir xil koʻrinishda boʻladi:

{ "xato": "Bunday resurs yoʻq." }

Provayder endpointi

Soxta REST dan tashqari hozircha bitta haqiqiy provayder ulangan. Bu kelajakdagi provayder API'lar qanday koʻrinishda boʻlishini koʻrsatadi.

curl "https://apicloud.uz/v1/currency/rates?valyuta=USD"

{
  "manba": "cbu.uz",
  "sana": "22.09.2026",
  "eskirgan": false,
  "valyuta": {
    "kod": "USD",
    "nom": "AQSH dollari",
    "birlik": 1,
    "kurs": 11809.82,
    "farq": -29.77
  }
}

Keyingi versiyalar

Bu sahifa bepul API haqida: u doim kalitsiz qoladi. Pullik API'lar /v1/pro/{xizmat}/... manzilida, panelda olingan bitta API kaliti bilan ishlaydi; birinchisi Ryusei AI modeli ishga tushganda shu yerda hujjatlanadi. Mavjud manzillar oʻzgarmaydi.

Kerakli API'ni hello@apicloud.uz manziliga yoki Telegram orqali taklif qilishingiz mumkin.