Skip to content

feat: complete API collections with all documented endpoints#218

Merged
ogazboiz merged 1 commit intoLabsCrypt:mainfrom
Itodo-S:feature/complete-api-collections
Mar 26, 2026
Merged

feat: complete API collections with all documented endpoints#218
ogazboiz merged 1 commit intoLabsCrypt:mainfrom
Itodo-S:feature/complete-api-collections

Conversation

@Itodo-S
Copy link
Copy Markdown
Contributor

@Itodo-S Itodo-S commented Mar 24, 2026

Summary

The existing Postman and Hoppscotch collections only covered 5 endpoints (health, create stream, SSE subscribe, SSE stats) and used paths without the required /v1/ prefix. This PR completes both collections with all 15 documented API endpoints and fixes the path prefixes.

Added endpoints

Folder Endpoint Method
Health /api-docs GET
Health /api-docs.json GET
Streams /v1/streams (list) GET
Streams /v1/streams/{streamId} GET
Streams /v1/streams/{streamId}/events GET
Streams /v1/streams/{streamId}/claimable GET
Users /v1/users (register) POST
Users /v1/users/{publicKey} GET
Users /v1/users/me (auth) GET
Users /v1/users/{publicKey}/events GET

Fixes

  • All versioned endpoints now use correct /v1/ prefix (was missing before)
  • Environment files (local + test, both Postman and Hoppscotch) now include streamId and authToken variables
  • Sandbox mode documented in Postman collection description
  • Example responses added for all endpoints including error cases (400, 401, 404)

Files changed (6)

  • docs/api/flowfi.postman_collection.json — complete rewrite with all 15 endpoints
  • docs/api/flowfi.hoppscotch_collection.json — complete rewrite with all 15 endpoints
  • docs/api/local.postman_environment.json — add streamId, authToken
  • docs/api/test.postman_environment.json — add streamId, authToken
  • docs/api/local.hoppscotch_environment.json — add streamId, authToken
  • docs/api/test.hoppscotch_environment.json — add streamId, authToken

Test plan

  • Import flowfi.postman_collection.json into Postman — verify all 15 requests appear
  • Import local.postman_environment.json — verify variables resolve in requests
  • Import flowfi.hoppscotch_collection.json into Hoppscotch — verify all 15 requests appear
  • Import local.hoppscotch_environment.json — verify variables resolve
  • Send GET /health to a running backend — verify 200 response

Closes #141

The existing collections only covered Health, Create Stream, and SSE
endpoints, and used paths without the required /v1/ prefix. This
update adds all missing endpoints and fixes path prefixes.

Added endpoints:
- Streams: List streams, Get stream by ID, Get stream events,
  Get claimable amount
- Users: Register wallet, Get user by public key,
  Get current user (authenticated), Get user activity events
- Health: Swagger UI, OpenAPI JSON spec

Fixes:
- All versioned paths now use /v1/ prefix (e.g. /v1/streams)
- Environment files include streamId and authToken variables
- Sandbox mode documented in collection description

Closes LabsCrypt#141
Copy link
Copy Markdown
Contributor

@ogazboiz ogazboiz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is clean, well-structured work — thanks for completing the API collections, @Itodo-S! 🎉

you've covered every documented endpoint, updated them all to the /v1/ prefix, added the missing Users collection, Swagger UI entries, and the sandbox mode note in the Postman description. that's exactly what this needed.

CI is all green and there are no conflicts. merging this in!

come hang with us on Telegram if you haven't already: https://t.me/+DOylgFv1jyJlNzM0

@ogazboiz ogazboiz merged commit c9c6017 into LabsCrypt:main Mar 26, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

DX: Example Postman or Hoppscotch Collection

2 participants