{"openapi":"3.1.0","info":{"title":"Fragment API","version":"0.1.0"},"paths":{"/api/v1/getInfo":{"post":{"tags":["Ma'lumot"],"summary":"Telegram foydalanuvchi ma'lumotlarini olish","operationId":"get_info_api_v1_getInfo_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Loyihaga tegishli API key","title":"X-Api-Key"},"description":"Loyihaga tegishli API key"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetInfoRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"examples":{"success":{"summary":"Muvaffaqiyatli javob","value":{"ok":true,"message":"Telegram foydalanuvchi topildi.","result":{"username":"durov","name":"Pavel Durov","photo":"https://nft.fragment.com/photo.jpg","is_premium":true}}}}}}},"400":{"content":{"application/json":{"examples":{"error":{"summary":"Xatolik javobi","value":{"ok":false,"message":"Fragment bilan bog'liq muammo yuzaga keldi.","code":"FRAGMENT_ERROR"}},"insufficient_gas":{"summary":"Gaz uchun TON yetarli emas","value":{"ok":false,"message":"Blokcheyn to'lovi (gaz) uchun hamyonda 0.1 TON bo'lishi talab etiladi.","code":"INSUFFICIENT_GAS"}}}}},"description":"Bad Request"},"401":{"content":{"application/json":{"examples":{"auth_error":{"summary":"API key xatosi","value":{"ok":false,"message":"X-API-Key maydoni noto'g'ri yoki yetishmaydi.","code":"VALIDATION_ERROR"}}}}},"description":"Unauthorized"},"403":{"description":"Loyiha sozlamalarida IP cheklovi yoqilgan va so'rov ro'yxatda yo'q IP dan kelgan.","content":{"application/json":{"examples":{"ip_not_allowed":{"summary":"IP manzilga ruxsat yo'q","value":{"ok":false,"message":"Bu IP manzildan so'rov yuborishga ruxsat yo'q: 203.0.113.7.","code":"IP_NOT_ALLOWED"}}}}}},"500":{"content":{"application/json":{"examples":{"server_error":{"summary":"Server xatosi","value":{"ok":false,"message":"Serverda kutilmagan xatolik. Birozdan keyin qayta urinib ko'ring.","code":"CRITICAL_SERVER_ERROR"}}}}},"description":"Internal Server Error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/stars/pricing":{"post":{"tags":["Narxlar"],"summary":"Telegram Stars narxlarini olish","operationId":"stars_pricing_api_v1_stars_pricing_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Loyihaga tegishli API key","title":"X-Api-Key"},"description":"Loyihaga tegishli API key"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StarsPricingRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"examples":{"success":{"summary":"Stars narxlari","value":{"ok":true,"message":"Stars narxlari muvaffaqiyatli olindi.","result":{"amount":50,"price":{"ton":"0.3151","usd":"0.75","selected":"0.75"}}}}}}}},"400":{"content":{"application/json":{"examples":{"error":{"summary":"Xatolik javobi","value":{"ok":false,"message":"Fragment bilan bog'liq muammo yuzaga keldi.","code":"FRAGMENT_ERROR"}},"insufficient_gas":{"summary":"Gaz uchun TON yetarli emas","value":{"ok":false,"message":"Blokcheyn to'lovi (gaz) uchun hamyonda 0.1 TON bo'lishi talab etiladi.","code":"INSUFFICIENT_GAS"}}}}},"description":"Bad Request"},"401":{"content":{"application/json":{"examples":{"auth_error":{"summary":"API key xatosi","value":{"ok":false,"message":"X-API-Key maydoni noto'g'ri yoki yetishmaydi.","code":"VALIDATION_ERROR"}}}}},"description":"Unauthorized"},"403":{"description":"Loyiha sozlamalarida IP cheklovi yoqilgan va so'rov ro'yxatda yo'q IP dan kelgan.","content":{"application/json":{"examples":{"ip_not_allowed":{"summary":"IP manzilga ruxsat yo'q","value":{"ok":false,"message":"Bu IP manzildan so'rov yuborishga ruxsat yo'q: 203.0.113.7.","code":"IP_NOT_ALLOWED"}}}}}},"500":{"content":{"application/json":{"examples":{"server_error":{"summary":"Server xatosi","value":{"ok":false,"message":"Serverda kutilmagan xatolik. Birozdan keyin qayta urinib ko'ring.","code":"CRITICAL_SERVER_ERROR"}}}}},"description":"Internal Server Error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/premium/pricing":{"post":{"tags":["Narxlar"],"summary":"Telegram Premium narxlarini olish","operationId":"premium_pricing_api_v1_premium_pricing_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Loyihaga tegishli API key","title":"X-Api-Key"},"description":"Loyihaga tegishli API key"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"examples":{"success":{"summary":"Premium narxlari","value":{"ok":true,"message":"Premium narxlari muvaffaqiyatli olindi.","result":{"packages":[{"months":3,"ton":"5","usd":"11.99"},{"months":6,"ton":"6.67","usd":"15.99"},{"months":12,"ton":"12.1","usd":"28.99"}]}}}}}}},"400":{"content":{"application/json":{"examples":{"error":{"summary":"Xatolik javobi","value":{"ok":false,"message":"Fragment bilan bog'liq muammo yuzaga keldi.","code":"FRAGMENT_ERROR"}},"insufficient_gas":{"summary":"Gaz uchun TON yetarli emas","value":{"ok":false,"message":"Blokcheyn to'lovi (gaz) uchun hamyonda 0.1 TON bo'lishi talab etiladi.","code":"INSUFFICIENT_GAS"}}}}},"description":"Bad Request"},"401":{"content":{"application/json":{"examples":{"auth_error":{"summary":"API key xatosi","value":{"ok":false,"message":"X-API-Key maydoni noto'g'ri yoki yetishmaydi.","code":"VALIDATION_ERROR"}}}}},"description":"Unauthorized"},"403":{"description":"Loyiha sozlamalarida IP cheklovi yoqilgan va so'rov ro'yxatda yo'q IP dan kelgan.","content":{"application/json":{"examples":{"ip_not_allowed":{"summary":"IP manzilga ruxsat yo'q","value":{"ok":false,"message":"Bu IP manzildan so'rov yuborishga ruxsat yo'q: 203.0.113.7.","code":"IP_NOT_ALLOWED"}}}}}},"500":{"content":{"application/json":{"examples":{"server_error":{"summary":"Server xatosi","value":{"ok":false,"message":"Serverda kutilmagan xatolik. Birozdan keyin qayta urinib ko'ring.","code":"CRITICAL_SERVER_ERROR"}}}}},"description":"Internal Server Error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/stars/buy":{"post":{"tags":["Sotib olish"],"summary":"Telegram Stars sotib olish","operationId":"stars_buy_api_v1_stars_buy_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Loyihaga tegishli API key","title":"X-Api-Key"},"description":"Loyihaga tegishli API key"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StarsBuyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"examples":{"success":{"summary":"Stars sotib olindi","value":{"ok":true,"message":"Stars buyurtmasi muvaffaqiyatli bajarildi.","result":{"username":"durov","amount":50,"payment_method":"USDT","cost":"0.75"}}}}}}},"400":{"content":{"application/json":{"examples":{"error":{"summary":"Xatolik javobi","value":{"ok":false,"message":"Fragment bilan bog'liq muammo yuzaga keldi.","code":"FRAGMENT_ERROR"}},"insufficient_gas":{"summary":"Gaz uchun TON yetarli emas","value":{"ok":false,"message":"Blokcheyn to'lovi (gaz) uchun hamyonda 0.1 TON bo'lishi talab etiladi.","code":"INSUFFICIENT_GAS"}}}}},"description":"Bad Request"},"401":{"content":{"application/json":{"examples":{"auth_error":{"summary":"API key xatosi","value":{"ok":false,"message":"X-API-Key maydoni noto'g'ri yoki yetishmaydi.","code":"VALIDATION_ERROR"}}}}},"description":"Unauthorized"},"403":{"description":"Loyiha sozlamalarida IP cheklovi yoqilgan va so'rov ro'yxatda yo'q IP dan kelgan.","content":{"application/json":{"examples":{"ip_not_allowed":{"summary":"IP manzilga ruxsat yo'q","value":{"ok":false,"message":"Bu IP manzildan so'rov yuborishga ruxsat yo'q: 203.0.113.7.","code":"IP_NOT_ALLOWED"}}}}}},"500":{"content":{"application/json":{"examples":{"server_error":{"summary":"Server xatosi","value":{"ok":false,"message":"Serverda kutilmagan xatolik. Birozdan keyin qayta urinib ko'ring.","code":"CRITICAL_SERVER_ERROR"}}}}},"description":"Internal Server Error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/premium/buy":{"post":{"tags":["Sotib olish"],"summary":"Telegram Premium sotib olish","operationId":"premium_buy_api_v1_premium_buy_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Loyihaga tegishli API key","title":"X-Api-Key"},"description":"Loyihaga tegishli API key"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PremiumBuyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"examples":{"success":{"summary":"Premium sotib olindi","value":{"ok":true,"message":"Premium buyurtmasi muvaffaqiyatli bajarildi.","result":{"username":"durov","duration":3,"payment_method":"TON","cost":"5"}}}}}}},"400":{"content":{"application/json":{"examples":{"error":{"summary":"Xatolik javobi","value":{"ok":false,"message":"Fragment bilan bog'liq muammo yuzaga keldi.","code":"FRAGMENT_ERROR"}},"insufficient_gas":{"summary":"Gaz uchun TON yetarli emas","value":{"ok":false,"message":"Blokcheyn to'lovi (gaz) uchun hamyonda 0.1 TON bo'lishi talab etiladi.","code":"INSUFFICIENT_GAS"}}}}},"description":"Bad Request"},"401":{"content":{"application/json":{"examples":{"auth_error":{"summary":"API key xatosi","value":{"ok":false,"message":"X-API-Key maydoni noto'g'ri yoki yetishmaydi.","code":"VALIDATION_ERROR"}}}}},"description":"Unauthorized"},"403":{"description":"Loyiha sozlamalarida IP cheklovi yoqilgan va so'rov ro'yxatda yo'q IP dan kelgan.","content":{"application/json":{"examples":{"ip_not_allowed":{"summary":"IP manzilga ruxsat yo'q","value":{"ok":false,"message":"Bu IP manzildan so'rov yuborishga ruxsat yo'q: 203.0.113.7.","code":"IP_NOT_ALLOWED"}}}}}},"500":{"content":{"application/json":{"examples":{"server_error":{"summary":"Server xatosi","value":{"ok":false,"message":"Serverda kutilmagan xatolik. Birozdan keyin qayta urinib ko'ring.","code":"CRITICAL_SERVER_ERROR"}}}}},"description":"Internal Server Error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/wallet/balance":{"post":{"tags":["Hamyon"],"summary":"Loyiha hamyoni balansini olish","operationId":"wallet_balance_api_v1_wallet_balance_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Loyihaga tegishli API key","title":"X-Api-Key"},"description":"Loyihaga tegishli API key"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"examples":{"success":{"summary":"Loyiha hamyoni balansi","value":{"ok":true,"message":"Loyiha hamyoni balansi muvaffaqiyatli olindi.","result":{"project":"Oscar stars","address":"EQBCb8...PFKUBY","balance_ton":"0.2400","balance_usdt":"12.500000","wallet_version":"V4R2","network":"TON Mainnet"}}}}}}},"400":{"content":{"application/json":{"examples":{"error":{"summary":"Balans xatosi","value":{"ok":false,"message":"Blokcheyn tarmog'ida vaqtinchalik muammo. Birozdan keyin qayta urinib ko'ring.","code":"BLOCKCHAIN_FAIL"}},"insufficient_gas":{"summary":"Gaz uchun TON yetarli emas","value":{"ok":false,"message":"Blokcheyn to'lovi (gaz) uchun hamyonda 0.1 TON bo'lishi talab etiladi.","code":"INSUFFICIENT_GAS"}}}}},"description":"Bad Request"},"401":{"content":{"application/json":{"examples":{"auth_error":{"summary":"API key xatosi","value":{"ok":false,"message":"X-API-Key maydoni noto'g'ri yoki yetishmaydi.","code":"VALIDATION_ERROR"}}}}},"description":"Unauthorized"},"403":{"description":"Loyiha sozlamalarida IP cheklovi yoqilgan va so'rov ro'yxatda yo'q IP dan kelgan.","content":{"application/json":{"examples":{"ip_not_allowed":{"summary":"IP manzilga ruxsat yo'q","value":{"ok":false,"message":"Bu IP manzildan so'rov yuborishga ruxsat yo'q: 203.0.113.7.","code":"IP_NOT_ALLOWED"}}}}}},"500":{"content":{"application/json":{"examples":{"server_error":{"summary":"Server xatosi","value":{"ok":false,"message":"Serverda kutilmagan xatolik. Birozdan keyin qayta urinib ko'ring.","code":"CRITICAL_SERVER_ERROR"}}}}},"description":"Internal Server Error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/wallet/calculate":{"post":{"tags":["Hamyon"],"summary":"Loyiha hamyoni bilan nimalar olish mumkinligini hisoblash","operationId":"wallet_calculate_api_v1_wallet_calculate_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Loyihaga tegishli API key","title":"X-Api-Key"},"description":"Loyihaga tegishli API key"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"examples":{"success":{"summary":"Loyiha hamyoni imkoniyatlari","value":{"ok":true,"message":"Loyiha hamyoni imkoniyatlari muvaffaqiyatli hisoblandi.","result":{"balance_ton":"0.2400","balance_usdt":"12.500000","stars":{"max_amount":16,"asset":"USDT","amount":"0.2398","ton":"0.0000","usdt":"0.239800"},"premium":{"packages":[]}}}}}}}},"400":{"content":{"application/json":{"examples":{"error":{"summary":"Balans xatosi","value":{"ok":false,"message":"Blokcheyn tarmog'ida vaqtinchalik muammo. Birozdan keyin qayta urinib ko'ring.","code":"BLOCKCHAIN_FAIL"}},"insufficient_gas":{"summary":"Gaz uchun TON yetarli emas","value":{"ok":false,"message":"Blokcheyn to'lovi (gaz) uchun hamyonda 0.1 TON bo'lishi talab etiladi.","code":"INSUFFICIENT_GAS"}}}}},"description":"Bad Request"},"401":{"content":{"application/json":{"examples":{"auth_error":{"summary":"API key xatosi","value":{"ok":false,"message":"X-API-Key maydoni noto'g'ri yoki yetishmaydi.","code":"VALIDATION_ERROR"}}}}},"description":"Unauthorized"},"403":{"description":"Loyiha sozlamalarida IP cheklovi yoqilgan va so'rov ro'yxatda yo'q IP dan kelgan.","content":{"application/json":{"examples":{"ip_not_allowed":{"summary":"IP manzilga ruxsat yo'q","value":{"ok":false,"message":"Bu IP manzildan so'rov yuborishga ruxsat yo'q: 203.0.113.7.","code":"IP_NOT_ALLOWED"}}}}}},"500":{"content":{"application/json":{"examples":{"server_error":{"summary":"Server xatosi","value":{"ok":false,"message":"Serverda kutilmagan xatolik. Birozdan keyin qayta urinib ko'ring.","code":"CRITICAL_SERVER_ERROR"}}}}},"description":"Internal Server Error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"GetInfoRequest":{"properties":{"username":{"type":"string","title":"Username","description":"Telegram username, @ bilan ham yuborish mumkin."}},"type":"object","required":["username"],"title":"GetInfoRequest","example":{"username":"durov"}},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"PremiumBuyRequest":{"properties":{"username":{"type":"string","title":"Username","description":"Telegram username."},"duration":{"type":"integer","title":"Duration","description":"Premium muddati: 3, 6 yoki 12."}},"type":"object","required":["username","duration"],"title":"PremiumBuyRequest","example":{"duration":12,"username":"durov"}},"StarsBuyRequest":{"properties":{"username":{"type":"string","title":"Username","description":"Telegram username."},"amount":{"type":"integer","title":"Amount","description":"Sotib olinadigan stars miqdori."}},"type":"object","required":["username","amount"],"title":"StarsBuyRequest","example":{"amount":60,"username":"durov"}},"StarsPricingRequest":{"properties":{"amount":{"type":"integer","title":"Amount","description":"Olinadigan stars miqdori.","default":60}},"type":"object","title":"StarsPricingRequest","example":{"amount":60}},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"tags":[{"name":"Ma'lumot","description":"Telegram foydalanuvchi ma'lumotlarini olish endpointlari."},{"name":"Narxlar","description":"Stars va Premium narxlarini olish endpointlari."},{"name":"Sotib olish","description":"Stars va Premium sotib olish endpointlari."},{"name":"Hamyon","description":"Loyiha hamyoni balansi va hisob-kitob endpointlari."}]}