{"openapi":"3.1.0","info":{"title":"KeysGift Public API","version":"1.0.0","description":"کیز گیفت — پلتفرم ایرانی خرید گیفت کارت، بازی، استریم، شارژ مسترکارت و ویزا با تحویل سریع و قیمت لحظه‌ای از پنل رسمی.","contact":{"name":"KeysGift Support","url":"https://t.me/keysgift"}},"servers":[{"url":"https://keysgift.com"}],"x-service-info":{"categories":["ecommerce","catalog"],"docs":{"homepage":"https://keysgift.com","apiReference":"https://keysgift.com/openapi.json","llms":"https://keysgift.com/llms.txt","auth":"https://keysgift.com/auth.md"}},"paths":{"/api/public/catalog":{"get":{"operationId":"getCatalog","summary":"Product catalog with live IRR prices","tags":["Catalog"],"x-payment-info":{"intent":"charge","method":"stripe","amount":"100","currency":"usd","description":"KeysGift API access — catalog is free; purchases complete on panel in IRR"},"responses":{"200":{"description":"Catalog snapshot","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogResponse"}}}},"402":{"description":"Payment Required — complete purchase on KeysGift panel","headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"MPP payment challenge"}}}}}},"/api/public/search":{"get":{"operationId":"searchProducts","summary":"Search products by name or keyword","tags":["Catalog"],"x-payment-info":{"intent":"charge","method":"stripe","amount":"100","currency":"usd","description":"KeysGift API access — catalog is free; purchases complete on panel in IRR"},"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":30,"default":12}}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"402":{"description":"Payment Required — complete purchase on KeysGift panel","headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"MPP payment challenge"}}}}}}},"components":{"schemas":{"CatalogResponse":{"type":"object","properties":{"site":{"type":"string"},"url":{"type":"string","format":"uri"},"currency":{"type":"string","example":"IRR"},"productCount":{"type":"integer"},"products":{"type":"array","items":{"$ref":"#/components/schemas/Product"}}}},"SearchResponse":{"type":"object","properties":{"query":{"type":"string"},"total":{"type":"integer"},"results":{"type":"array","items":{"$ref":"#/components/schemas/SearchHit"}}}},"Product":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"},"priceToman":{"type":"number","nullable":true},"priceFormatted":{"type":"string","nullable":true},"url":{"type":"string","format":"uri"},"buyUrl":{"type":"string","format":"uri"}}},"SearchHit":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"priceFormatted":{"type":"string","nullable":true},"score":{"type":"number"}}}}},"externalDocs":{"url":"https://keysgift.com/llms.txt","description":"LLM-readable site overview"}}