{"openapi":"3.0.0","info":{"title":"Shared Service API","description":"Geografik ma'lumotlar servisi.\n\n**Base URL (Gateway orqali):** `https:\/\/api.agroinspeksiya.uz\/api\/v1\/`\n\n## Asosiy endpointlar:\n- `GET \/countries` - Mamlakatlar ro'yxati\n- `GET \/countries\/{id}` - Mamlakat ma'lumotlari\n- `GET \/regions` - Viloyatlar ro'yxati\n- `GET \/regions\/{id}` - Viloyat ma'lumotlari\n- `GET \/districts` - Tumanlar ro'yxati\n- `GET \/districts\/{id}` - Tuman ma'lumotlari","contact":{"name":"API Support","email":"support@agroinspeksiya.uz"},"version":"1.0.0"},"servers":[{"url":"https:\/\/backend.uzagroin.uz","description":"Current Server"}],"paths":{"\/api\/v1\/shared\/integrations\/agrosert\/seeds\/regions":{"get":{"tags":["Integratsiya: Agrosert"],"summary":"Urug' arizalari \u2014 viloyatlar kesimida (tonna)","operationId":"6598920a308a77d73bdbec18bd97f07e","parameters":[{"name":"year","in":"query","schema":{"type":"integer","example":2025}},{"name":"region_id","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"Viloyatlar bo'yicha urug' statistikasi"},"401":{"description":"Avtorizatsiyasiz"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/agrosert\/seeds\/enterprises":{"get":{"tags":["Integratsiya: Agrosert"],"summary":"Urug' arizalari \u2014 korxonalar kesimida (tonna)","operationId":"c299951a4963de7d88a3378296880ca5","parameters":[{"name":"year","in":"query","schema":{"type":"integer","example":2025}},{"name":"page","in":"query","schema":{"type":"integer","example":1}},{"name":"per_page","in":"query","schema":{"type":"integer","example":20}},{"name":"stir","in":"query","schema":{"type":"string"}},{"name":"crop_type","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Korxonalar bo'yicha urug'"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/agrosert\/seedlings\/regions":{"get":{"tags":["Integratsiya: Agrosert"],"summary":"Ko'chat arizalari \u2014 viloyatlar kesimida (dona)","operationId":"2c539db16ec39f3898e8dcf4bfc6b1bd","parameters":[{"name":"year","in":"query","schema":{"type":"integer","example":2025}},{"name":"region_id","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"Viloyatlar bo'yicha ko'chat statistikasi"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/agrosert\/seedlings\/enterprises":{"get":{"tags":["Integratsiya: Agrosert"],"summary":"Ko'chat arizalari \u2014 korxonalar kesimida (dona)","operationId":"2197ab4732fc3dc87e8f699cf5ba8ab0","parameters":[{"name":"year","in":"query","schema":{"type":"integer","example":2025}},{"name":"page","in":"query","schema":{"type":"integer","example":1}},{"name":"per_page","in":"query","schema":{"type":"integer","example":20}},{"name":"stir","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Korxonalar bo'yicha ko'chat"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/agrosert\/cotton\/summary-by-region":{"get":{"tags":["Integratsiya: Agrosert"],"summary":"Paxta (chigit) \u2014 viloyatlar kesimida sertifikat","operationId":"3785a3dc62bb536eb827103b2cdd9a68","parameters":[{"name":"year","in":"query","schema":{"type":"integer","example":2025}}],"responses":{"200":{"description":"enterprise_count, certificate_count, total_quantity"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/agrosert\/cotton\/summary-by-enterprise":{"get":{"tags":["Integratsiya: Agrosert"],"summary":"Paxta (chigit) \u2014 korxonalar kesimida","operationId":"08bb51942864117a5830093f556756ca","parameters":[{"name":"year","in":"query","schema":{"type":"integer","example":2025}}],"responses":{"200":{"description":"enterprise, stir, activity_type, certificate_count, total_quantity"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/agrosert\/cotton\/certificates":{"get":{"tags":["Integratsiya: Agrosert"],"summary":"Paxta (chigit) \u2014 sertifikatlar ro'yxati","operationId":"a508b01486e36db55b0ca10530926f12","parameters":[{"name":"year","in":"query","schema":{"type":"integer","example":2025}},{"name":"page","in":"query","schema":{"type":"integer","example":1}},{"name":"per_page","in":"query","schema":{"type":"integer","example":50}}],"responses":{"200":{"description":"Sertifikatlar (sifat, korxona, mahsulot, test_report)"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/agrosert\/grain\/summary-by-region":{"get":{"tags":["Integratsiya: Agrosert"],"summary":"Don (g'alla) \u2014 viloyatlar kesimida sertifikat","operationId":"43de31f4082712c484312af3839f3973","parameters":[{"name":"year","in":"query","schema":{"type":"integer","example":2025}}],"responses":{"200":{"description":"enterprise_count, certificate_count, total_quantity"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/agrosert\/grain\/summary-by-enterprise":{"get":{"tags":["Integratsiya: Agrosert"],"summary":"Don (g'alla) \u2014 korxonalar kesimida","operationId":"b5c8ebc47428adde356b718f2ea2ae69","parameters":[{"name":"year","in":"query","schema":{"type":"integer","example":2025}}],"responses":{"200":{"description":"enterprise, stir, activity_type (don saqlash), certificate_count, total_quantity"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/agrosert\/grain\/certificates":{"get":{"tags":["Integratsiya: Agrosert"],"summary":"Don (g'alla) \u2014 sertifikatlar ro'yxati","operationId":"48da47130a177b77691306c7ac3a1477","parameters":[{"name":"year","in":"query","schema":{"type":"integer","example":2025}},{"name":"page","in":"query","schema":{"type":"integer","example":1}},{"name":"per_page","in":"query","schema":{"type":"integer","example":50}}],"responses":{"200":{"description":"Sertifikatlar (sifat, korxona, mahsulot, test_report)"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/egov\/car-info":{"post":{"tags":["Integratsiya: Raqamli hukumat"],"summary":"Transport vositalari (IIV) \u2014 INN\/PINFL\/davlat raqami\/texpasport bo'yicha","operationId":"af0288c2a10b119640ad5404f41dab82","requestBody":{"content":{"application\/json":{"schema":{"properties":{"pTin":{"type":"string","example":"308450922"},"pPinpp":{"type":"string"},"pPlateNumber":{"type":"string"}},"type":"object"}}}},"responses":{"200":{"description":"Texnika ro'yxati"},"401":{"description":"Avtorizatsiyasiz"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/egov\/gtk-hscode":{"get":{"tags":["Integratsiya: Raqamli hukumat"],"summary":"GTK \u2014 HS-code bo'yicha eksport\/import (sekin ~50s)","operationId":"bb67f070fa28deb7cff9421ff729f5ca","parameters":[{"name":"transaction_id","in":"query","schema":{"type":"string"}},{"name":"sender_pin","in":"query","schema":{"type":"string"}},{"name":"reqDate","in":"query","schema":{"type":"string","example":"2025-01-16"}}],"responses":{"200":{"description":"HS-code ro'yxati"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/egov\/qxv\/agroplatforma":{"get":{"tags":["Integratsiya: Raqamli hukumat"],"summary":"QXV \u2014 Agroplatforma ekin maydonlari va kredit (viloyat)","operationId":"299a81ee101520379543dfb181df3668","parameters":[{"name":"year","in":"query","required":true,"schema":{"type":"integer","example":2025}},{"name":"soato","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Statistika"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/egov\/qxv\/crop-argo":{"post":{"tags":["Integratsiya: Raqamli hukumat"],"summary":"QXV \u2014 CropAgro (tuman bo'yicha ekin holati)","operationId":"48871de81677fa5f99f7e75edb94cb9d","requestBody":{"content":{"application\/json":{"schema":{"properties":{"type":{"type":"string","example":"data"},"subtype":{"type":"string","example":"cotton"},"regions":{"type":"integer","example":1703},"districts":{"type":"integer","example":1703203},"year":{"type":"integer","example":2025}},"type":"object"}}}},"responses":{"200":{"description":"CropAgro natijasi"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/egov\/qxv\/farmer-projects":{"get":{"tags":["Integratsiya: Raqamli hukumat"],"summary":"QXV \u2014 Ekinlarni joylashtirish (fermer + kontur + maydon feed)","operationId":"cccf267fb6db398c7f9787463dea0b30","parameters":[{"name":"update_id","in":"query","schema":{"type":"integer","example":0}}],"responses":{"200":{"description":"Ekin yozuvlari (500 ta\/sahifa)"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/egov\/qxv\/land-geometry\/{landId}":{"get":{"tags":["Integratsiya: Raqamli hukumat"],"summary":"QXV \u2014 Kontur geometriyasi (Polygon) land_id bo'yicha","operationId":"73e376d4184408d34ae3dfa9918eb444","parameters":[{"name":"landId","in":"path","required":true,"schema":{"type":"integer","example":2858055}}],"responses":{"200":{"description":"GeoJSON Polygon"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/egov\/qxv\/hosil-paxta":{"get":{"tags":["Integratsiya: Raqamli hukumat"],"summary":"QXV \u2014 Paxta hosil qabuli (feed)","operationId":"5e8ff791c57bdf7343383880c0ae419f","parameters":[{"name":"update_id","in":"query","schema":{"type":"integer","example":1}}],"responses":{"200":{"description":"Hosil qabuli yozuvlari"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/egov\/qxv\/hosil-reestr":{"get":{"tags":["Integratsiya: Raqamli hukumat"],"summary":"QXV \u2014 Hosil reestri (viloyat\/tuman jami)","operationId":"28bb5d4c613f8b9d5061bd0903309d7b","parameters":[{"name":"soato","in":"query","schema":{"type":"string","example":"1703"}},{"name":"year","in":"query","schema":{"type":"integer","example":2025}}],"responses":{"200":{"description":"Hosil reestri"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/egov\/uzstandart\/entity-certs":{"get":{"tags":["Integratsiya: Raqamli hukumat"],"summary":"O'zstandart \u2014 Tashkilot sertifikatlari ro'yxati","operationId":"bd755375e103499bef49aff4db90de4b","responses":{"200":{"description":"Sertifikatlar"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/egov\/uzstandart\/cert-info":{"get":{"tags":["Integratsiya: Raqamli hukumat"],"summary":"O'zstandart \u2014 Muvofiqlik sertifikati ma'lumoti (applier_stir)","operationId":"71513c66afe571503483bd7080d4de11","parameters":[{"name":"applier_stir","in":"query","schema":{"type":"string"}},{"name":"transaction_id","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Sertifikat ma'lumoti"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/egov\/uzstandart\/sertificate":{"post":{"tags":["Integratsiya: Raqamli hukumat"],"summary":"O'zstandart \u2014 Muvofiqlik sertifikatlari (tin bo'yicha)","operationId":"36aa1d29869d5c2eb0b1f380d3a8bb3e","requestBody":{"content":{"application\/json":{"schema":{"properties":{"tin":{"type":"string","example":"308450922"},"page":{"type":"integer","example":1},"per_page":{"type":"integer","example":10}},"type":"object"}}}},"responses":{"200":{"description":"Sertifikatlar"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/egov\/uzstandart\/meter-info":{"get":{"tags":["Integratsiya: Raqamli hukumat"],"summary":"O'zstandart \u2014 O'lchov asboblari (legal_consumer_stir_or_pinfl)","operationId":"f6d8a1c1328a9d2e595bb2e7dd22cee8","parameters":[{"name":"legal_consumer_stir_or_pinfl","in":"query","schema":{"type":"string"}},{"name":"transaction_id","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"O'lchov asboblari"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/egov\/sudlanganlik":{"post":{"tags":["Integratsiya: Raqamli hukumat"],"summary":"Sudlanganlik tekshiruvi (IIV) \u2014 request_id qaytaradi","operationId":"c32a904e9113ba97bf81f2ca5029c933","requestBody":{"content":{"application\/json":{"schema":{"properties":{"firstname":{"type":"string"},"lastname":{"type":"string"},"birth_year":{"type":"integer","example":1992},"pinfl":{"type":"string"},"organization_id":{"description":"IIV \u0441\u043f\u0440\u0430\u0432\u043e\u0447\u043d\u0438\u043a kodi","type":"string"},"region_id":{"type":"string","example":"1726"},"consent":{"type":"boolean","example":true}},"type":"object"}}}},"responses":{"200":{"description":"request_id"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/egov\/stat\/yirik-korxona":{"get":{"tags":["Integratsiya: Raqamli hukumat"],"summary":"Statistika \u2014 Yirik korxonalar","operationId":"d20f048e99863f97c35780b99370cf04","parameters":[{"name":"year","in":"query","schema":{"type":"integer","example":2025}}],"responses":{"200":{"description":"Korxonalar"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/egov\/stat\/eximp":{"get":{"tags":["Integratsiya: Raqamli hukumat"],"summary":"Statistika \u2014 Eksport\/Import mahsulot ma'lumoti","operationId":"56227acca487b5c9fbe940c3aac55435","responses":{"200":{"description":"Eksport\/Import"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/egov\/ktyadr":{"post":{"tags":["Integratsiya: Raqamli hukumat"],"summary":"Statistika \u2014 Yagona registr (INN bo'yicha korxona)","operationId":"6059f92745345194fdf2242c1891fe5a","requestBody":{"content":{"application\/json":{"schema":{"properties":{"inn":{"type":"string","example":"308450922"},"transaction_id":{"type":"string"},"sender_pinfl":{"type":"string"}},"type":"object"}}}},"responses":{"200":{"description":"Registr yozuvi"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/shared\/integrations\/egov\/ttz-agro":{"get":{"tags":["Integratsiya: Raqamli hukumat"],"summary":"TTZ \u2014 Agro texnika (sana bo'yicha)","operationId":"059fdc88ca2024236482b00b70c303a4","parameters":[{"name":"date","in":"query","schema":{"type":"string","example":"2025.06.30"}}],"responses":{"200":{"description":"Agro texnika"}},"security":[{"bearerAuth":[]}]}},"\/api\/v1\/countries":{"get":{"tags":["Countries"],"summary":"Get all countries","description":"Get list of all active countries","operationId":"44042ed84da01c70ce052bb1b814734e","parameters":[{"name":"locale","in":"query","description":"Language locale","schema":{"type":"string","default":"uz","enum":["uz","ru","en"]}}],"responses":{"200":{"description":"Success","content":{"application\/json":{"schema":{"properties":{"success":{"type":"boolean","example":true},"data":{"type":"array","items":{"$ref":"#\/components\/schemas\/Country"}}},"type":"object"}}}}}}},"\/api\/v1\/countries\/{id}":{"get":{"tags":["Countries"],"summary":"Get country by ID","description":"Get single country with regions and districts","operationId":"4c482b67c13252558fcae0882fe68579","parameters":[{"name":"id","in":"path","description":"Country ID","required":true,"schema":{"type":"integer"}},{"name":"locale","in":"query","description":"Language locale","schema":{"type":"string","default":"uz","enum":["uz","ru","en"]}}],"responses":{"200":{"description":"Success","content":{"application\/json":{"schema":{"properties":{"success":{"type":"boolean","example":true},"data":{"properties":{"id":{"type":"integer"},"name":{"type":"string"},"short_name":{"type":"string"},"currency_code":{"type":"string"},"code":{"type":"string"},"regions":{"type":"array","items":{"properties":{"id":{"type":"integer"},"name":{"type":"string"},"code":{"type":"string"}},"type":"object"}}},"type":"object"}},"type":"object"}}}},"404":{"description":"Country not found","content":{"application\/json":{"schema":{"properties":{"success":{"type":"boolean","example":false},"message":{"type":"string","example":"Davlat topilmadi"}},"type":"object"}}}}}}},"\/api\/v1\/countries\/{id}\/regions":{"get":{"tags":["Countries"],"summary":"Get country regions","description":"Get regions of a country","operationId":"215393e69baf974826b6d6f57009108e","parameters":[{"name":"id","in":"path","description":"Country ID","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Success","content":{"application\/json":{"schema":{"properties":{"success":{"type":"boolean","example":true},"data":{"type":"array","items":{"$ref":"#\/components\/schemas\/Region"}}},"type":"object"}}}}}}},"\/api\/v1\/districts":{"get":{"tags":["Districts"],"summary":"Tumanlar ro'yxati","description":"Barcha faol tumanlar ro'yxati. Viloyat ID, SOATO yoki viloyat SOATO bo'yicha filter qilish mumkin","operationId":"ae40eed2ce7f8bf3d1431e19d816f0be","parameters":[{"name":"search","in":"query","description":"Nomi yoki SOATO bo'yicha qidirish","schema":{"type":"string"}},{"name":"soato","in":"query","description":"Tuman SOATO kodi bo'yicha aniq filtrlash (masalan: 1703203)","schema":{"type":"integer","example":1703203}},{"name":"region_soato","in":"query","description":"Viloyat SOATO kodi bo'yicha tumanlarni olish (masalan: 1703 \u2014 Andijon viloyatining barcha tumanlari)","schema":{"type":"integer","example":1703}},{"name":"state_id","in":"query","description":"Viloyat (state) ID bo'yicha filtrlash","schema":{"type":"integer"}},{"name":"region_id","in":"query","description":"Viloyat ID bo'yicha filtrlash (state_id alias)","schema":{"type":"integer"}},{"name":"is_active","in":"query","description":"Faol holatda filtrlash","schema":{"type":"boolean"}},{"name":"locale","in":"query","description":"Til (uz, ru, en)","schema":{"type":"string","default":"uz","enum":["uz","ru","en"]}},{"name":"page","in":"query","description":"Sahifa raqami","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","description":"Sahifadagi yozuvlar soni (-1 = hammasi)","schema":{"type":"integer","default":15}},{"name":"sort_by","in":"query","description":"Saralash maydoni","schema":{"type":"string","default":"id","enum":["id","name","name_uz","name_ru","state_id","soato","sort_order","is_active","created_at"]}},{"name":"sort_order","in":"query","description":"Saralash tartibi","schema":{"type":"string","default":"desc","enum":["asc","desc"]}}],"responses":{"200":{"description":"Muvaffaqiyatli"}}},"post":{"tags":["Districts"],"summary":"Yangi tuman qo'shish","operationId":"416681f6e85ab2a76c1eae1eb9cdd1bf","requestBody":{"required":true,"content":{"application\/json":{"schema":{"required":["name","state_id"],"properties":{"name":{"type":"string","example":"Chilonzor tumani"},"name_uz":{"type":"string","example":"Chilonzor tumani"},"name_ru":{"type":"string","example":"\u0427\u0438\u043b\u0430\u043d\u0437\u0430\u0440\u0441\u043a\u0438\u0439 \u0440\u0430\u0439\u043e\u043d"},"name_en":{"type":"string","example":"Chilanzar district"},"state_id":{"description":"Viloyat ID","type":"integer","example":1},"code":{"description":"Tuman kodi","type":"string"},"soato":{"description":"SOATO kodi","type":"integer","example":172604},"is_active":{"description":"Faol holati","type":"boolean","example":true},"sort_order":{"description":"Tartib raqami","type":"integer","example":1}},"type":"object"}}}},"responses":{"201":{"description":"Yaratildi"},"422":{"description":"Validatsiya xatosi"}}}},"\/api\/v1\/cities\/list":{"get":{"tags":["Cities"],"summary":"Tumanlar ro'yxati (Legacy)","description":"uzagroteh-main: \/cities\/list bilan moslik uchun","operationId":"8da131b6c19ebff17366347c58ff01a2","parameters":[{"name":"search","in":"query","description":"Nomi bo'yicha qidirish","schema":{"type":"string"}},{"name":"state_id","in":"query","description":"Viloyat ID bo'yicha filtrlash","schema":{"type":"integer"}},{"name":"region_id","in":"query","description":"Viloyat ID bo'yicha filtrlash (alias)","schema":{"type":"integer"}},{"name":"is_active","in":"query","description":"Faol holatda filtrlash","schema":{"type":"boolean"}},{"name":"locale","in":"query","description":"Til (uz, ru, en)","schema":{"type":"string","default":"uz","enum":["uz","ru","en"]}},{"name":"page","in":"query","description":"Sahifa raqami","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","description":"Sahifadagi yozuvlar soni (-1 = hammasi)","schema":{"type":"integer","default":15}}],"responses":{"200":{"description":"Muvaffaqiyatli"}}}},"\/api\/v1\/cities\/add":{"get":{"tags":["Cities"],"summary":"Tuman qo'shish formasi","description":"uzagroteh-main: \/cities\/add bilan moslik uchun","operationId":"4e8b6e8c9d381bb6edd6e12676ccd624","responses":{"200":{"description":"Muvaffaqiyatli"}}}},"\/api\/v1\/cities\/store":{"post":{"tags":["Cities"],"summary":"Yangi tuman qo'shish","description":"uzagroteh-main: \/cities\/store bilan moslik uchun","operationId":"d9213537268763ed5e9c866d03874e6c","requestBody":{"required":true,"content":{"application\/json":{"schema":{"required":["name","state_id"],"properties":{"name":{"description":"Tuman nomi","type":"string","example":"Chilonzor"},"state_id":{"description":"Viloyat ID","type":"integer","example":1},"soato":{"description":"SOATO kodi","type":"integer","example":172604}},"type":"object"}}}},"responses":{"201":{"description":"Yaratildi"},"422":{"description":"Validatsiya xatosi"}}}},"\/api\/v1\/districts\/{id}":{"get":{"tags":["Districts"],"summary":"Tuman ma'lumotlari","description":"Tuman haqida to'liq ma'lumot, viloyat bilan","operationId":"fa182a476cdc0c8ba43ea64cefb89678","parameters":[{"name":"id","in":"path","description":"Tuman ID","required":true,"schema":{"type":"integer"}},{"name":"locale","in":"query","description":"Til (uz, ru, en)","schema":{"type":"string","default":"uz","enum":["uz","ru","en"]}}],"responses":{"200":{"description":"Muvaffaqiyatli"},"404":{"description":"Tuman topilmadi"}}},"put":{"tags":["Districts"],"summary":"Tumanni yangilash","operationId":"8ed26ac264ded4c34d2ceb1a7dad5166","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application\/json":{"schema":{"properties":{"name":{"type":"string"},"name_uz":{"type":"string"},"name_ru":{"type":"string"},"name_en":{"type":"string"},"state_id":{"description":"Viloyat ID","type":"integer"},"code":{"description":"Tuman kodi","type":"string"},"soato":{"description":"SOATO kodi","type":"integer"},"is_active":{"description":"Faol holati","type":"boolean"},"sort_order":{"description":"Tartib raqami","type":"integer"}},"type":"object"}}}},"responses":{"200":{"description":"Muvaffaqiyatli"},"404":{"description":"Tuman topilmadi"},"422":{"description":"Validatsiya xatosi"}}},"delete":{"tags":["Districts"],"summary":"Tumanni o'chirish","operationId":"ab73fcda99855cb4a4ff4d301b651305","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Muvaffaqiyatli"},"404":{"description":"Tuman topilmadi"}}}},"\/api\/v1\/cities\/list\/edit\/{id}":{"get":{"tags":["Cities"],"summary":"Tuman tahrirlash formasi","description":"uzagroteh-main: \/cities\/list\/edit\/{id} bilan moslik uchun","operationId":"287b8abb3a872b668ddf2d958e9c3de9","parameters":[{"name":"id","in":"path","description":"Tuman ID","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Muvaffaqiyatli"},"404":{"description":"Tuman topilmadi"}}}},"\/api\/v1\/cities\/list\/edit\/update\/{id}":{"post":{"tags":["Cities"],"summary":"Tumanni yangilash","description":"uzagroteh-main: \/cities\/list\/edit\/update\/{id} bilan moslik uchun","operationId":"09dfba9a137c83d505f301a8742104ab","parameters":[{"name":"id","in":"path","description":"Tuman ID","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application\/json":{"schema":{"properties":{"name":{"description":"Tuman nomi","type":"string"},"state_id":{"description":"Viloyat ID","type":"integer"},"soato":{"description":"SOATO kodi","type":"integer"}},"type":"object"}}}},"responses":{"200":{"description":"Muvaffaqiyatli"},"404":{"description":"Tuman topilmadi"}}}},"\/api\/v1\/cities\/list\/delete\/{id}":{"get":{"tags":["Cities"],"summary":"Tumanni o'chirish","description":"uzagroteh-main: \/cities\/list\/delete\/{id} bilan moslik uchun","operationId":"2f24b1f6b2f2f8e97b99b322acfb790a","parameters":[{"name":"id","in":"path","description":"Tuman ID","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Muvaffaqiyatli"},"404":{"description":"Tuman topilmadi"}}}},"\/api\/v1\/regions":{"get":{"tags":["Regions"],"summary":"Viloyatlar ro'yxati","description":"Barcha faol viloyatlar ro'yxati, davlat va SOATO bo'yicha filter qilish mumkin","operationId":"0ff24e8002e28714d7e21b70725e8ae9","parameters":[{"name":"search","in":"query","description":"Nomi yoki SOATO bo'yicha qidirish","schema":{"type":"string"}},{"name":"soato","in":"query","description":"SOATO kodi bo'yicha aniq filtrlash (masalan: 1703)","schema":{"type":"integer","example":1703}},{"name":"country_id","in":"query","description":"Davlat bo'yicha filtrlash","schema":{"type":"integer"}},{"name":"is_active","in":"query","description":"Faol holatda filtrlash","schema":{"type":"boolean"}},{"name":"locale","in":"query","description":"Til (uz, ru, en)","schema":{"type":"string","default":"uz","enum":["uz","ru","en"]}},{"name":"page","in":"query","description":"Sahifa raqami","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","description":"Sahifadagi yozuvlar soni (-1 = hammasi)","schema":{"type":"integer","default":15}},{"name":"sort_by","in":"query","description":"Saralash maydoni","schema":{"type":"string","default":"id","enum":["id","name","name_uz","name_ru","code","soato","sort_order","is_active","created_at"]}},{"name":"sort_order","in":"query","description":"Saralash tartibi","schema":{"type":"string","default":"desc","enum":["asc","desc"]}}],"responses":{"200":{"description":"Muvaffaqiyatli"}}},"post":{"tags":["Regions"],"summary":"Yangi viloyat qo'shish","operationId":"df9ba1f467923894f255a7292023eecb","requestBody":{"required":true,"content":{"application\/json":{"schema":{"required":["name"],"properties":{"name":{"type":"string","example":"Toshkent viloyati"},"name_uz":{"type":"string","example":"Toshkent viloyati"},"name_ru":{"type":"string","example":"\u0422\u0430\u0448\u043a\u0435\u043d\u0442\u0441\u043a\u0430\u044f \u043e\u0431\u043b\u0430\u0441\u0442\u044c"},"name_en":{"type":"string","example":"Tashkent region"},"country_id":{"description":"Davlat ID","type":"integer","example":1},"code":{"description":"Viloyat kodi","type":"string"},"series":{"description":"Seriya prefiksi (Tr.-mashinist guvohnomasi uchun)","type":"string","example":"UZ-AB","nullable":true},"soato":{"description":"SOATO kodi","type":"integer","example":1727},"is_active":{"description":"Faol holati","type":"boolean","example":true},"sort_order":{"description":"Tartib raqami","type":"integer","example":1}},"type":"object"}}}},"responses":{"201":{"description":"Yaratildi"},"422":{"description":"Validatsiya xatosi"}}}},"\/api\/v1\/states\/list":{"get":{"tags":["States"],"summary":"Viloyatlar ro'yxati (Legacy)","description":"uzagroteh-main: \/states\/list bilan moslik uchun","operationId":"bbb7aa4465a3d267723e7e3d6e890a4d","parameters":[{"name":"search","in":"query","description":"Nomi yoki SOATO bo'yicha qidirish","schema":{"type":"string"}},{"name":"country_id","in":"query","description":"Davlat bo'yicha filtrlash","schema":{"type":"integer"}},{"name":"is_active","in":"query","description":"Faol holatda filtrlash","schema":{"type":"boolean"}},{"name":"locale","in":"query","description":"Til (uz, ru, en)","schema":{"type":"string","default":"uz","enum":["uz","ru","en"]}},{"name":"page","in":"query","description":"Sahifa raqami","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","description":"Sahifadagi yozuvlar soni (-1 = hammasi)","schema":{"type":"integer","default":15}}],"responses":{"200":{"description":"Muvaffaqiyatli"}}}},"\/api\/v1\/states\/add":{"get":{"tags":["States"],"summary":"Viloyat qo'shish formasi","description":"uzagroteh-main: \/states\/add bilan moslik uchun","operationId":"f38285e4ed3ebf6667e0de0485df5e0d","responses":{"200":{"description":"Muvaffaqiyatli"}}}},"\/api\/v1\/states\/store":{"post":{"tags":["States"],"summary":"Yangi viloyat qo'shish","description":"uzagroteh-main: \/states\/store bilan moslik uchun","operationId":"ba8c01c7f73d93a5439f763ebdc6ffea","requestBody":{"required":true,"content":{"application\/json":{"schema":{"required":["name"],"properties":{"name":{"description":"Viloyat nomi","type":"string","example":"Toshkent viloyati"},"code":{"description":"Viloyat kodi","type":"string","example":"TAS"},"series":{"description":"Seriya prefiksi","type":"string","example":"UZ-AB","nullable":true},"soato":{"description":"SOATO kodi","type":"integer","example":1727}},"type":"object"}}}},"responses":{"201":{"description":"Yaratildi"},"422":{"description":"Validatsiya xatosi"}}}},"\/api\/v1\/regions\/{id}":{"get":{"tags":["Regions"],"summary":"Viloyat ma'lumotlari","description":"Viloyat haqida to'liq ma'lumot, davlat va tumanlar bilan","operationId":"a45edfa21bce0ca88d4d64a740340707","parameters":[{"name":"id","in":"path","description":"Viloyat ID","required":true,"schema":{"type":"integer"}},{"name":"locale","in":"query","description":"Til (uz, ru, en)","schema":{"type":"string","default":"uz","enum":["uz","ru","en"]}}],"responses":{"200":{"description":"Muvaffaqiyatli"},"404":{"description":"Viloyat topilmadi"}}},"put":{"tags":["Regions"],"summary":"Viloyatni yangilash","operationId":"84ee7ae55abdf1dfd77c870517c5ce24","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application\/json":{"schema":{"properties":{"name":{"type":"string"},"name_uz":{"type":"string"},"name_ru":{"type":"string"},"name_en":{"type":"string"},"country_id":{"description":"Davlat ID","type":"integer"},"code":{"description":"Viloyat kodi","type":"string"},"series":{"description":"Seriya prefiksi (Tr.-mashinist guvohnomasi uchun)","type":"string","nullable":true},"soato":{"description":"SOATO kodi","type":"integer"},"is_active":{"description":"Faol holati","type":"boolean"},"sort_order":{"description":"Tartib raqami","type":"integer"}},"type":"object"}}}},"responses":{"200":{"description":"Muvaffaqiyatli"},"404":{"description":"Viloyat topilmadi"},"422":{"description":"Validatsiya xatosi"}}},"delete":{"tags":["Regions"],"summary":"Viloyatni o'chirish","operationId":"31d8795cc04ee42d5d2a679ef8d88c53","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Muvaffaqiyatli"},"404":{"description":"Viloyat topilmadi"}}}},"\/api\/v1\/states\/list\/edit\/{id}":{"get":{"tags":["States"],"summary":"Viloyat tahrirlash formasi","description":"uzagroteh-main: \/states\/list\/edit\/{id} bilan moslik uchun","operationId":"d061b55499ac23e826a2af5d500982cc","parameters":[{"name":"id","in":"path","description":"Viloyat ID","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Muvaffaqiyatli"},"404":{"description":"Viloyat topilmadi"}}}},"\/api\/v1\/states\/list\/edit\/update\/{id}":{"post":{"tags":["States"],"summary":"Viloyatni yangilash","description":"uzagroteh-main: \/states\/list\/edit\/update\/{id} bilan moslik uchun","operationId":"faf5dc25dc621fe0c83daf77b541ecc2","parameters":[{"name":"id","in":"path","description":"Viloyat ID","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application\/json":{"schema":{"properties":{"name":{"description":"Viloyat nomi","type":"string"},"code":{"description":"Viloyat kodi","type":"string"},"series":{"description":"Seriya prefiksi","type":"string"},"soato":{"description":"SOATO kodi","type":"integer"}},"type":"object"}}}},"responses":{"200":{"description":"Muvaffaqiyatli"},"404":{"description":"Viloyat topilmadi"}}}},"\/api\/v1\/states\/list\/delete\/{id}":{"get":{"tags":["States"],"summary":"Viloyatni o'chirish","description":"uzagroteh-main: \/states\/list\/delete\/{id} bilan moslik uchun","operationId":"3ec8f55a52eab66f15c60ca93a86c335","parameters":[{"name":"id","in":"path","description":"Viloyat ID","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Muvaffaqiyatli"},"404":{"description":"Viloyat topilmadi"}}}},"\/api\/v1\/regions\/{id}\/districts":{"get":{"tags":["Regions"],"summary":"Viloyat tumanlari","description":"Viloyatning barcha tumanlari ro'yxati","operationId":"ab76d18ceaa6fb0df458f70144a81993","parameters":[{"name":"id","in":"path","description":"Viloyat ID","required":true,"schema":{"type":"integer"}},{"name":"locale","in":"query","description":"Til (uz, ru, en)","schema":{"type":"string","default":"uz","enum":["uz","ru","en"]}}],"responses":{"200":{"description":"Muvaffaqiyatli"},"404":{"description":"Viloyat topilmadi"}}}}},"components":{"schemas":{"Country":{"title":"Country","description":"Mamlakat modeli","properties":{"id":{"description":"Shared Service Base Controller\n\nGeografik ma'lumotlar servisi - Mamlakatlar, Viloyatlar, Tumanlar","type":"integer","example":1},"name":{"type":"string","example":"O'zbekiston"},"name_uz":{"type":"string","example":"O'zbekiston"},"name_ru":{"type":"string","example":"\u0423\u0437\u0431\u0435\u043a\u0438\u0441\u0442\u0430\u043d"},"short_name":{"type":"string","example":"UZ"},"code":{"type":"string","example":"+998"},"currency_code":{"type":"string","example":"UZS"},"is_active":{"type":"boolean","example":true}},"type":"object"},"Region":{"title":"Region","description":"Viloyat modeli","properties":{"id":{"type":"integer","example":1},"name":{"type":"string","example":"Toshkent shahri"},"name_uz":{"type":"string","example":"Toshkent shahri"},"name_ru":{"type":"string","example":"\u0413\u043e\u0440\u043e\u0434 \u0422\u0430\u0448\u043a\u0435\u043d\u0442"},"code":{"type":"string","example":"26"},"soato":{"type":"integer","example":1726},"country_id":{"type":"integer","example":1},"is_active":{"type":"boolean","example":true}},"type":"object"},"District":{"title":"District","description":"Tuman modeli","properties":{"id":{"type":"integer","example":1},"name":{"type":"string","example":"Chilonzor tumani"},"name_uz":{"type":"string","example":"Chilonzor tumani"},"name_ru":{"type":"string","example":"\u0427\u0438\u043b\u0430\u043d\u0437\u0430\u0440\u0441\u043a\u0438\u0439 \u0440\u0430\u0439\u043e\u043d"},"code":{"type":"string","example":"2601"},"soato":{"type":"integer","example":1726101},"state_id":{"type":"integer","example":1},"is_active":{"type":"boolean","example":true}},"type":"object"},"DistrictResource":{"properties":{"id":{"description":"DistrictResource - Tuman resursi\nMUHIM: Column nomlari eski MySQL bilan bir xil!\n- state_id (region_id EMAS!)","type":"integer","example":1},"name":{"type":"string","example":"Chilonzor tumani"},"name_uz":{"type":"string","example":"Chilonzor tumani"},"name_ru":{"type":"string","example":"\u0427\u0438\u043b\u0430\u043d\u0437\u0430\u0440\u0441\u043a\u0438\u0439 \u0440\u0430\u0439\u043e\u043d"},"name_en":{"type":"string","example":"Chilanzar district"},"code":{"type":"string","nullable":true},"soato":{"type":"integer","example":172604},"is_active":{"type":"boolean","example":true},"state_id":{"type":"integer","example":1},"region":{"type":"object","nullable":true}},"type":"object"},"RegionResource":{"properties":{"id":{"description":"RegionResource - Viloyat resursi\nMUHIM: Table va column nomlari eski MySQL bilan bir xil!\n- Table: tbl_states (regions EMAS!)","type":"integer","example":1},"name":{"type":"string","example":"Toshkent viloyati"},"name_uz":{"type":"string","example":"Toshkent viloyati"},"name_ru":{"type":"string","example":"\u0422\u0430\u0448\u043a\u0435\u043d\u0442\u0441\u043a\u0430\u044f \u043e\u0431\u043b\u0430\u0441\u0442\u044c"},"name_en":{"type":"string","example":"Tashkent region"},"code":{"type":"string","nullable":true},"series":{"description":"Traktor-mashinist guvohnomasi seriya prefiksi","type":"string","example":"UZ-AB","nullable":true},"soato":{"type":"integer","example":1727},"is_active":{"type":"boolean","example":true},"country_id":{"type":"integer","example":1},"country":{"type":"object","nullable":true}},"type":"object"}},"securitySchemes":{"bearerAuth":{"type":"http","description":"JWT autentifikatsiya tokeni","scheme":"bearer","bearerFormat":"JWT"}}},"tags":[{"name":"Countries","description":"Mamlakatlar"},{"name":"Regions","description":"Viloyatlar boshqaruvi"},{"name":"Districts","description":"Tumanlar boshqaruvi"},{"name":"Integratsiya: Agrosert","description":"Agrosert.uz \u2014 urug'\/ko'chat arizalari"},{"name":"Integratsiya: Raqamli hukumat","description":"egov MIP2 \u2014 17 ta davlat servisi"},{"name":"Cities","description":"Tumanlar boshqaruvi (Legacy - uzagroteh-main moslik)"},{"name":"States","description":"Viloyatlar boshqaruvi (Legacy - uzagroteh-main moslik)"}],"security":[{"bearerAuth":[]}]}