{"openapi":"3.0.3","info":{"title":"SadiePass API","version":"1.0.0","description":"SadiePass global tonal fashion rental & color analysis API. A PH3AR project by Michael Barbine and Sadie Bauer, hosted by Platphorm News.","contact":{"name":"SadiePass / Platphorm News","url":"https://fashion.platphormnews.com/contact","email":"sadie.bauer@yahoo.com"},"license":{"name":"All rights reserved","url":"https://fashion.platphormnews.com/terms"},"x-logo":{"url":"https://fashion.platphormnews.com/placeholder-logo.png"},"x-network":"https://platphormnews.com","x-mcp":"https://mcp.platphormnews.com"},"servers":[{"url":"https://fashion.platphormnews.com/api","description":"Production"}],"paths":{"/palettes":{"get":{"summary":"Get all seasonal color palettes","description":"Returns the four seasonal color palettes (Spring, Summer, Autumn, Winter) with color recommendations.","operationId":"getPalettes","tags":["Color Analysis"],"responses":{"200":{"description":"Array of seasonal palettes","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Palette"}}}}}}}},"/color-analysis":{"post":{"summary":"Submit color analysis","description":"Submit user color data to receive seasonal color type classification.","operationId":"submitColorAnalysis","tags":["Color Analysis"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ColorAnalysisRequest"}}}},"responses":{"200":{"description":"Color analysis result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ColorAnalysisResult"}}}}}}},"/recommendations":{"get":{"summary":"Get personalized fashion recommendations","description":"Returns designer items recommended for the user's seasonal color type.","operationId":"getRecommendations","tags":["Recommendations"],"parameters":[{"name":"palette","in":"query","description":"Seasonal color type: spring, summer, autumn, winter","schema":{"type":"string","enum":["spring","summer","autumn","winter"]}}],"responses":{"200":{"description":"Array of fashion recommendations","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/FashionItem"}}}}}}}},"/subscription":{"get":{"summary":"Get subscription plans","description":"Returns all available subscription tiers and pricing.","operationId":"getSubscriptionPlans","tags":["Subscription"],"responses":{"200":{"description":"Array of subscription plans","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SubscriptionPlan"}}}}}}}},"/public/search":{"get":{"summary":"Search fashion items","description":"Search the public fashion item catalog.","operationId":"searchItems","tags":["Public"],"parameters":[{"name":"q","in":"query","description":"Search query","schema":{"type":"string"}},{"name":"palette","in":"query","description":"Filter by seasonal palette","schema":{"type":"string","enum":["spring","summer","autumn","winter"]}}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/FashionItem"}},"total":{"type":"integer"}}}}}}}}},"/documentation":{"get":{"summary":"API documentation","description":"Returns this OpenAPI documentation.","operationId":"getDocumentation","tags":["Meta"],"responses":{"200":{"description":"OpenAPI specification"}}}}},"components":{"schemas":{"Palette":{"type":"object","properties":{"id":{"type":"string","example":"spring"},"name":{"type":"string","example":"True Spring"},"undertone":{"type":"string","example":"warm"},"description":{"type":"string"},"colors":{"type":"array","items":{"type":"string"}}}},"ColorAnalysisRequest":{"type":"object","required":["skinTone","eyeColor","hairColor"],"properties":{"skinTone":{"type":"string","description":"User's skin tone description"},"eyeColor":{"type":"string","description":"User's eye color"},"hairColor":{"type":"string","description":"User's hair color"},"contrastLevel":{"type":"string","enum":["low","medium","high"]}}},"ColorAnalysisResult":{"type":"object","properties":{"season":{"type":"string","example":"spring"},"type":{"type":"string","example":"True Spring"},"confidence":{"type":"number","format":"float","example":0.92},"palette":{"$ref":"#/components/schemas/Palette"}}},"FashionItem":{"type":"object","properties":{"id":{"type":"string"},"brand":{"type":"string","example":"BALMAIN"},"name":{"type":"string","example":"Sequin Mini Dress"},"price":{"type":"number","example":2195},"palette":{"type":"string","example":"winter"},"imageUrl":{"type":"string","format":"uri"},"available":{"type":"boolean"}}},"SubscriptionPlan":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","example":"Popular"},"itemsPerMonth":{"type":"integer","example":10},"priceUsd":{"type":"number","example":39},"features":{"type":"array","items":{"type":"string"}}}}}},"tags":[{"name":"Color Analysis","description":"Seasonal color type analysis endpoints"},{"name":"Recommendations","description":"Personalized fashion recommendations"},{"name":"Subscription","description":"Subscription plans and management"},{"name":"Public","description":"Public catalog and search"},{"name":"Meta","description":"API meta endpoints"}],"externalDocs":{"description":"SadiePass documentation","url":"https://fashion.platphormnews.com/api/documentation"}}