[Enhancement] Document API Request/Response Contracts #23

Problem

API endpoints exist but no OpenAPI/Swagger documentation

Impact

• Developers must read code to understand API
• No machine-readable API spec
• Harder to generate client SDKs

Solution

Add Swagger/OpenAPI documentation

Acceptance Criteria

• OpenAPI 3.0 spec created
• All endpoints documented
• Request/response examples
• Error responses documented