Publish an OpenAPI specification and serve interactive docs

[Manuel1234477]

Context

The API is documented only in prose in the README. There is no machine-readable spec for client generation or a try-it-out UI.

Tasks

• Produce an OpenAPI 3 spec for /payments (create/get/list) and /health — generated (e.g. utoipa) or hand-written.
• Serve it plus a Swagger UI / Redoc page.
• Keep it in sync with handler request/response shapes.

Acceptance criteria

• A valid OpenAPI document is served and matches the implemented endpoints.

[xx7412421-cloud]

/claim #20

I can take this if it is still available.

Plan:

• inspect the existing API routes and project documentation structure
• add an OpenAPI specification that reflects the current public endpoints and request/response shapes
• serve interactive docs through the existing app stack with minimal dependencies and clear local usage notes
• run the relevant checks and note any local environment limitation before opening a PR

I will wait for assignment before submitting a PR.

[whiteghost0001]

i would love to work on this issue and summit pr withing 2 days

[grantfox-oss]

🦊 GrantFox — @whiteghost0001 has been assigned to this issue as part of the Official Campaign campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #20)
2. Your PR will be reviewed by the StellarGateLabs maintainers

Good luck! Track your progress on GrantFox.

[GBOYEE]

Hi! I'd like to work on this issue. I can deliver a clean fix.

[GBOYEE]

Hi! I'd like to work on this issue.

I have experience with this stack and can deliver a clean, tested solution. Please assign this to me and I'll submit a PR shortly.

My approach:

• Analyze the root cause
• Implement a fix following existing code patterns
• Add tests and documentation

Thanks!