{"openapi":"3.1.0","info":{"title":"Digche Icons API","version":"1.0","description":"Search Digche icons by name, alias, use case, tag, or functional meaning.","license":{"name":"Digche Icon License","url":"https://digche.vercel.app/terms"}},"externalDocs":{"description":"Digche AI and MCP discovery","url":"https://www.dig-che.ir/llms.txt"},"x-mcp":{"transport":"streamable-http","url":"https://www.dig-che.ir/api/mcp","descriptor":"https://www.dig-che.ir/mcp-server.json"},"servers":[{"url":"https://www.dig-che.ir"}],"paths":{"/api/v1/integrations":{"get":{"operationId":"getAiIntegrations","summary":"Get vendor-neutral MCP, OpenAPI, REST, and client connection presets","responses":{"200":{"description":"AI integration endpoints, presets, capabilities, and token policy"}}}},"/api/v1/health":{"get":{"operationId":"getApiHealth","summary":"Check API and database health","responses":{"200":{"description":"Healthy"},"503":{"description":"Degraded"}}}},"/api/v1/icons":{"get":{"operationId":"searchIcons","summary":"Search and list published icons","parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":120},"description":"Name, alias, use case, tag, or intent."},{"name":"category","in":"query","schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}},{"name":"style","in":"query","schema":{"type":"string","enum":["Bold","Bulk","Linear","Outline","Animated"]}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}}],"responses":{"200":{"description":"A ranked, paginated icon list"},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"type":"object","required":["apiVersion","error"],"properties":{"apiVersion":{"type":"string","example":"1.0"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}}}}}}}},"429":{"description":"Rate limit exceeded","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["apiVersion","error"],"properties":{"apiVersion":{"type":"string","example":"1.0"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}}}}}}}}}}},"/api/v1/icons/{slug}":{"get":{"operationId":"getIcon","summary":"Get icon metadata and available SVG styles","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}}],"responses":{"200":{"description":"Icon metadata and SVG variants"},"403":{"description":"Premium access required","content":{"application/json":{"schema":{"type":"object","required":["apiVersion","error"],"properties":{"apiVersion":{"type":"string","example":"1.0"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}}}}}}}},"404":{"description":"Icon not found","content":{"application/json":{"schema":{"type":"object","required":["apiVersion","error"],"properties":{"apiVersion":{"type":"string","example":"1.0"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}}}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["apiVersion","error"],"properties":{"apiVersion":{"type":"string","example":"1.0"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}}}}}}}}}}}}}