API javobi — bu mehmonga topshiriladigan uy. U bashorat qilinadigan bo'lishi kerak: mijoz kodi har safar bir xil tuzilmani kutadi.
{ "data": [ { "id": "1", "nom": "Kitob" } ], "meta": { "sahifa": 1, "jami": 128, "sahifa_hajmi": 20 }, "error": null }
{ "type": "https://api.example.com/errors/validation", "title": "Validatsiya xatosi", "status": 422, "detail": "yosh maydoni manfiy bo'lishi mumkin emas", "errors": [ { "field": "yosh", "code": "min", "message": "0 dan katta bo'lsin" } ] }
| Qoida | Nima uchun |
|---|---|
| snake_case yoki camelCase — bitta uslub | Aralashtirish mijoz kodini buzadi |
| Sana ISO-8601 UTC | "2026-08-04T16:10:00Z" — noaniqlik yo'q |
| null vs maydonni tashlab ketish | Kelishib ol: null = bo'sh, yo'q = o'zgarmagan |
| Massiv doim massiv | Bitta element bo'lsa ham obyektga aylantirma |
| ID string | Katta sonlar aniqligi buzilmasin |
| Yangi maydon qo'shish — buzmaydi | Maydon o'chirish/qayta nomlash — buzadi |
Content-Type
application/json; charset=utf-8. JSONL uchun application/x-ndjson. Xato javoblarda ham JSON qaytar — HTML sahifa emas.
🛠 Mashq: Sahifalangan javob yoz: data massivi + meta.
mashq.json
Uy mustahkam — JSON to'g'ri ✅