API documentation

Porq Game exposes every wired provider behind one REST API. You bring an operator launch URL per session; the aggregator runs that provider's real client bootstrap and translates your calls into its native protocol.

Base URL & authentication

Base URL: https://game.porq.site/api/v1

Every API call needs an API key in the x-api-key header. Keys are issued by the operator from the aggregator admin and are shown once at creation — store yours like a password.

curl https://game.porq.site/api/v1/providers -H "x-api-key: pq_live_…"

Endpoints

Examples

Create a session — the launch URL is the operator-issued game URL for your player; it carries the session credentials, so treat it as a secret.

curl -X POST https://game.porq.site/api/v1/creedroomz/session \
  -H "x-api-key: pq_live_…" -H "content-type: application/json" \
  -d '{"launchUrl":"https://games.example/authorization.php?…"}'

→ 200
{
  "session": "creedroomz-1",
  "provider": "creedroomz",
  "summary": { "ok": true, "partnerId": 18760475, "tableId": 3403,
               "gameId": 144, "currency": "INR", "hasSessionToken": true }
}

Balance

curl "https://game.porq.site/api/v1/creedroomz/balance?session=creedroomz-1" \
  -H "x-api-key: pq_live_…"

→ 200   { "balance": 1000.00, "currency": "INR" }

Place a bet (dry-run receipt)

curl -X POST https://game.porq.site/api/v1/crashlive/bet \
  -H "x-api-key: pq_live_…" -H "content-type: application/json" \
  -d '{"session":"crashlive-1","bet":{ "…": "provider-shaped fields" }}'

→ 200   { "fired": false, "dryRun": true, "request": { …exact provider payload… } }

Sessions & launch URLs

• One session = one operator launch URL. Most providers expire launch tokens quickly — fetch a fresh URL per session.
• Sessions live in the aggregator's memory only. Restarting the service invalidates session ids; provider-side tokens are never written to disk.
• A session id is only valid for the provider it was created under, and only on this aggregator instance.
• Fun / demo launches create whatever session type the provider issues for them (e.g. creedroomz fun launches are anonymous spectator sessions with no wallet — balance returns the session-carried value, null).

Errors

Providers — status & notes