COBBLEBOXby MBx
Anmelden Mitspielen

StartAPI

API

Für Apps, Bots und Overlays. Öffentliche Daten brauchen keinen Token. Vollständige Beschreibung: openapi.json (v0.1.0).

Live

get
/v1/stream ?fragments, topics, format, tenant
Live updates (Server-Sent Events)
get
/v1/fragments ?ids, v, tenant
Changed page fragments since given versions (polling fallback)

Öffentlich

get
/v1/meta ?tenant
Community info, event catalogue, resources, scopes
get
/v1/resources/{resource} ?tenant
Current state of one resource (ETag/304 supported)
get
/v1/server/status ?tenant
Server status
get
/v1/ranked/ladder/{fmt} ?tenant
Ranked ladder (singles | doubles)
get
/v1/ranked/matches ?tenant
Recent matches
get
/v1/market/listings ?tenant
Active auction listings
get
/v1/activity ?tenant
Activity feed
get
/v1/events ?since, limit, types, tenant
Public events after a cursor (polling, catch-up after reconnect)

Mit Anmeldung oder Token

get
/v1/me ?tenant
Who am I (token info)
post
/v1/actions ?tenant
Queue an action for the game server
get
/v1/actions/{aid} ?tenant
Action status
post
/v1/auth/login/start ?tenant
Start an in-game code login (cookie flow for the website)
get
/v1/auth/login/status ?tenant
Poll the code login; sets the session cookie when confirmed
get
/v1/auth/me ?tenant
Logged-in player (session cookie)
post
/v1/auth/logout ?tenant
Log out (deletes the session)
post
/v1/auth/token ?tenant
Personal read:player token for the logged-in player
post
/v1/auth/action ?tenant
Queue an action for the logged-in player (session)
get
/v1/auth/action/{aid} ?tenant
Status of an own action
get
/v1/me/player ?tenant
Own data for a personal token (scope read:player)

Connector (Spielserver)

post
/v1/ingest/events ?n
Push events (HMAC signed, batch up to 500)
get
/v1/connector/actions ?wait, limit, n
Lease queued actions (long poll up to 25 s)
post
/v1/connector/actions/{aid}/ack ?n
Report an action's result

Verwaltung der Community

get
/v1/manage/overview ?tenant
Everything the community admin page shows
post
/v1/manage/tokens ?tenant
Create a token (shown once)
delete
/v1/manage/tokens/{tid} ?tenant
Revoke a token
post
/v1/manage/whitelist/{rid}/approve ?tenant
Approve a whitelist request (queues whitelist.approve for the game server)
get
/v1/manage/export ?tenant
Export all community data as JSON (no secrets, no sessions)
post
/v1/manage/connectors/{cid}/rotate ?tenant
New connector secret; the old one stays valid 24 h
post
/v1/manage/webhooks ?tenant
Create a webhook (secret shown once)
post
/v1/manage/webhooks/{wid}/test ?tenant
Send a test event to a webhook now
delete
/v1/manage/webhooks/{wid} ?tenant
Delete a webhook
patch
/v1/manage/settings ?tenant
Name, language, colours, packs, hidden players

Neue Community

post
/v1/onboard
Create a community with an invite code (returns admin token, connector and collector config once)