kianiadkny/kisima_champions
1
0
Fork 0
Code Issues Pull requests 2 Projects Releases Packages Wiki Activity Actions

docs(api): publish Swagger to public host + fix attendance spec #2

Open
kianiadee wants to merge 1 commit from feat/public-api-docs into dev
pull from: feat/public-api-docs
merge into: kianiadkny:dev
Conversation 0 Commits 1 Files changed 1 +76 -1
kianiadee commented 2026-07-11 17:44:10 +03:00
Contributor
Copy link

What

Publish the Swagger docs to the live hosts and fix attendance spec accuracy.

  • servers: add https://api.karuracc.dev and https://staging.karuracc.dev/api so Swagger UI "Try it out" hits the live API (was localhost:3001 only, which broke the hosted docs).
  • Add missing endpoint POST /attendance/{id}/verify-pin (checkout PIN verification, routes/attendance.js).
  • Fix OpenAPI path templating: /attendance/:id/checkout → /attendance/{id}/checkout.

Live once merged to staging

🤖 Generated with Claude Code

## What Publish the Swagger docs to the live hosts and fix attendance spec accuracy. - `servers`: add `https://api.karuracc.dev` and `https://staging.karuracc.dev/api` so Swagger UI "Try it out" hits the live API (was `localhost:3001` only, which broke the hosted docs). - Add missing endpoint **POST /attendance/{id}/verify-pin** (checkout PIN verification, `routes/attendance.js`). - Fix OpenAPI path templating: `/attendance/:id/checkout` → `/attendance/{id}/checkout`. ## Live once merged to `staging` - Swagger UI: https://staging.karuracc.dev/api/api-docs/ (and https://api.karuracc.dev/api-docs/ after the dedicated route is added) - Raw spec: https://staging.karuracc.dev/api/swagger.json 🤖 Generated with [Claude Code](https://claude.com/claude-code)
- servers: add https://api.karuracc.dev and https://staging.karuracc.dev/api
  so Swagger UI "Try it out" targets the live API (was localhost:3001 only)
- add missing POST /attendance/{id}/verify-pin endpoint
- fix OpenAPI path templating: /attendance/:id/checkout -> /attendance/{id}/checkout

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This pull request can be merged automatically.
This branch is out-of-date with the base branch
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin feat/public-api-docs:feat/public-api-docs
git switch feat/public-api-docs

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch dev
git merge --no-ff feat/public-api-docs
git switch feat/public-api-docs
git rebase dev
git switch dev
git merge --ff-only feat/public-api-docs
git switch feat/public-api-docs
git rebase dev
git switch dev
git merge --no-ff feat/public-api-docs
git switch dev
git merge --squash feat/public-api-docs
git switch dev
git merge --ff-only feat/public-api-docs
git switch dev
git merge feat/public-api-docs
git push origin dev
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
kianiadkny/kisima_champions!2
No description provided.