Try It walkthrough
Prove Stoplight-equivalent Try It on your machine.
Prerequisites
cd SfeyDocs
npm run redis:up
npm run start:all
Wait for [test-rig] SfeyMCP mock listening and compiled successfully.
Steps
- Open http://localhost:3000/api-reference?spec=demo.
- Expand GET /health → Try it out → Execute.
- Confirm 200 and JSON such as
"status": "ok". - Expand POST /demo/v1/payments → use the example body → Execute.
- Confirm 201 with a
payment_id. - Optional: click Authorize, enter any value for
X-Demo-Key, retry a secured call.
Troubleshooting
| Symptom | Fix |
|---|---|
| Execute does nothing / network error | Demo mock not running — check terminal for [demo-mock] on port 4010 |
| Explorer says Try It disabled | You are not on localhost — demo Try It is local-only by design |
404 on /api-reference | Use dev proxy fix branch; restart npm run start:all |
Compare to AFC production spec
Open AFC v2.2 explorer for the full Stoplight-imported spec (Try It remains example-only until sandbox proxy exists).