⚡ Community API Suite Pro

Developer applications · scoped access keys · concurrency-safe rate limits · signed event webhooks

Developer access

API credentials and webhook configuration are managed by community administrators. Contact your community administrator to request an integration.

REST API v1 reference

v1.9 adds Prestige reward auditing; v1.7 added an operations dashboard, error diagnostics and webhook retry visibility; v1.6 added API key expiration controls, with expired keys denied at authentication. Existing keys remain valid until an administrator sets an expiration.

Endpoint: /addon.php?id=streamwave-api-suite&api=1&route=v1/health

Use Authorization: Bearer swc_... on every request. Read endpoints use GET; Prestige XP awards use POST and require the prestige.award scope.

Route	Scope	Data
v1/health	Authenticated key	API status
v1/members	members.read	Public usernames and join dates
v1/forums	forums.read	Forum directory
v1/topics	topics.read	Topic titles and authors
v1/stats	forums.read	Aggregate community statistics
v1/prestige	prestige.read	Member ranks and prestige
v1/prestige/award (POST)	prestige.award	Idempotent XP award
v1/prestige/awards (GET)	prestige.award	Application’s own award history

Pagination: &limit=20&after=0, maximum 50 rows. Responses include next_after for cursor pagination. Keys are stored only as SHA-256 hashes. Rotate to revoke previous keys.

Example request

curl -H 'Authorization: Bearer YOUR_KEY' 'https://YOUR-DOMAIN/addon.php?id=streamwave-api-suite&api=1&route=v1/forums&limit=10'

Webhook integration

Trusted PHP add-ons can queue events using swapi_emit('forum.topic.created', ['topic_id' => 123]). Events are not automatically emitted by existing forum code. Webhook delivery requires a scheduled cron invocation, and receiving servers must verify X-SW-Signature using the secret shown when creating a webhook.

SSO, OAuth/OpenID Connect, credit transfers, forum writes, and external game score submissions are not enabled in this release. They require dedicated permission, anti-abuse and transaction integrations.