{"openapi":"3.1.0","info":{"title":"emploidai Marketplace API","version":"1.0.0","description":"Public catalog discovery contract. Private installation endpoints are service-to-service only."},"servers":[{"url":"/"}],"paths":{"/api/marketplace/items":{"get":{"summary":"Search catalog items","parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":160}},{"name":"type","in":"query","style":"form","explode":true,"schema":{"type":"array","items":{"enum":["plugin","applet","addon","solution"]}}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"enum":["featured","trending","newest","rating","installs"]}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":48}}],"responses":{"200":{"description":"Paginated catalog items"},"503":{"description":"Catalog unavailable"}}}},"/api/marketplace/items/{type}/{id}":{"get":{"summary":"Get a catalog item","parameters":[{"name":"type","in":"path","required":true,"schema":{"enum":["plugin","applet","addon","solution"]}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Catalog item detail"},"404":{"description":"Item not found"}}}},"/api/marketplace/categories":{"get":{"summary":"List catalog categories","responses":{"200":{"description":"Categories with item counts"}}}},"/api/marketplace/health":{"get":{"summary":"Marketplace readiness","responses":{"200":{"description":"Database and catalog ready"},"503":{"description":"Not ready"}}}}}}