{"openapi":"3.1.0","info":{"title":"Wishiva Public API","version":"1.0.0","description":"Public REST API for Wishiva - Interactive Digital Surprises & Keepsakes, deployed on Netlify. Allows AI agents and developers to query templates, inspect platform health, and interact with the surprise platform.","contact":{"name":"Wishiva Team","url":"https://wishiva.netlify.app/docs"}},"servers":[{"url":"https://wishiva.netlify.app","description":"Production Server on Netlify"}],"paths":{"/api/templates":{"get":{"summary":"List experience templates","description":"Retrieve curated interactive greeting and surprise templates.","operationId":"listTemplates","parameters":[{"name":"occasion","in":"query","required":false,"schema":{"type":"string","enum":["birthday","anniversary","bestie","graduation","gratitude","farewell","family"]},"description":"Filter templates by occasion."}],"responses":{"200":{"description":"Successful template list response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"count":{"type":"integer"},"templates":{"type":"array","items":{"$ref":"#/components/schemas/Template"}}}}}}}}}},"/api/health":{"get":{"summary":"Service Health Check","description":"Returns platform status, version, and Netlify deployment metadata.","operationId":"getHealth","responses":{"200":{"description":"Service is operational","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"platform":{"type":"string"},"version":{"type":"string"},"netlify":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"}}}}}}}}},"/api/feedback":{"post":{"summary":"Submit User or Agent Feedback","description":"Submit product feedback, bug reports, or automated audit evidence.","operationId":"submitFeedback","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["rating","feedback"],"properties":{"rating":{"type":"integer","minimum":1,"maximum":5},"feedback":{"type":"string"},"category":{"type":"string"}}}}}},"responses":{"200":{"description":"Feedback recorded successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"}}}}}}}}},"/api/mcp":{"get":{"summary":"Model Context Protocol (MCP) Tool Catalog","description":"Returns the MCP tool manifest for AI agent tool calling.","operationId":"getMcpTools","responses":{"200":{"description":"MCP tools specification"}}}}},"components":{"schemas":{"Template":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"occasion":{"type":"string"},"revealStyle":{"type":"string","enum":["envelope","scratch","cake","giftbox"]},"previewImage":{"type":"string"},"badge":{"type":"string"},"description":{"type":"string"}}}}}}