(FIN) API Reference & Examples

[Olu1111]

Complete OpenAPI/Swagger documentation (or Markdown)
Include request/response examples for all endpoints
Document authentication headers and error codes
Add rate limiting and usage guidelines