generate Swagger documentation for API

[tenkus47]

Summary

This RFC proposes integrating Swagger (OpenAPI Specification) to standardize and automate the documentation of our API. Swagger will provide a clear, interactive, and up-to-date interface for developers, QA, and third-party consumers to understand and test the API endpoints.

🧩 Alternatives Considered

Option	Pros	Cons
Manual Markdown Docs	Simple to write	Easy to become outdated, no interactivity
Postman Collections	Good for testing	Not standardized, no integration with CI/CD
Redoc	Clean UI, OpenAPI-based	Less interactive than Swagger UI

---

steps:

• integrate swagger docs
• Validate RESTful Conventions

[tenkus47]

swagger : https://api-translation.pecha.tools/docs