Punchy System Hub

Punchy Peer-to-Peer Delivery REST API Gateway

A secure, high-integrity peer-to-peer logistical engine built for on-demand routing, coordinates blur, and atomic bid card matchmaking workflows.

📚
API & SDK Documentation

OpenAPI reference with SDK quick start, auth, and per-endpoint JavaScript samples (generated from the spec).

Read Documentation →
⚙️
Download JavaScript SDK

Auto-generated PunchySDK client — also at /sdk/v1/punchy-sdk.min.js.

Get punchy-sdk.js →
🟢
Live Service Status

Verify current database connections, microservice health parameters, and sandbox availability.

Check API Health →

Quick Sandbox Curl Starter

bash
# 1. Probe the system health state
curl -i https://<your-deployment-host>/api/health

# 2. Extract your sandbox profile
curl -H "X-User-Id: user_dev_100" \
     -H "X-User-Email: tester@punchy.fit" \
     -H "X-User-Name: Alice Smith" \
     https://<your-deployment-host>/api/me

Quick JS SDK Integration Starter

javascript
// <script src="/sdk/v1/punchy-sdk.js"></script>
const sdk = new PunchySDK({ baseUrl: location.origin });

// Production: Google ID token exchange
const { accessToken } = await sdk.loginWithGoogle(googleIdToken);
sdk.setToken(accessToken);

// Or sandbox: sdk.setSandboxUser("user_dev", "dev@punchy.fit");
const identity = await sdk.getMe();

Punchy Peer-to-Peer Delivery REST API

Primary Endpoints Map