DEVELOPER PLATFORMDeveloper API5 min read

REST API & Webhooks Integration

Integrate WilBot programmatically into your own websites, dashboards, and automated scripts.

Prerequisites & Permissions

HTTP client (cURL, fetch, Python requests) and valid authorization header where required.

Architecture & Overview

The WilBot Web Platform exposes modern JSON REST APIs under `https://wilbot.link/api/` for developers building third-party integrations, custom dashboards, and automation scripts.

All endpoints support CORS, return standard HTTP status codes, and provide predictable error envelopes with detailed diagnostic messages.

Key Features & Capabilities

Comprehensive Endpoints

Access server stats, AI model arena, health status, and chat streaming.

Predictable JSON Schemas

Structured request and response formats with TypeScript definitions.

High-Availability Edge Delivery

Fast responses backed by global edge infrastructure.

Step-by-Step Walkthrough

Query System Health & Uptime

Perform an unauthenticated GET request to inspect live system status.

terminal / command

curl -s https://wilbot.link/api/status

Run an AI Arena Dual Benchmark

Trigger a concurrent model battle.

terminal / command

curl -X POST https://wilbot.link/api/arena \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Explain quantum entanglement in one paragraph"}'

Inspect Guild Stats Programmatically

Fetch live stats for your server using your session token.

terminal / command

curl -s https://wilbot.link/api/guilds/1503910985524711476/stats \
  -H "Cookie: wilbot_session=<YOUR_TOKEN>"

Real-World Examples & Outputs

GET /api/status Response Sample

JSON response returned by the status health endpoint.

{ "status": "operational", "version": "4.2.0", "gatewayPingMs": 42, "shards": 1, "guilds": 15, "timestamp": "2026-10-17T18:00:00Z" }

Troubleshooting & Common Pitfalls

Issue:API returns 429 Too Many Requests.

Resolution: Respect the Retry-After header. Authenticated requests have higher rate limit quotas than unauthenticated queries.

Frequently Asked Questions

Where do I obtain an API key?

Standard endpoints authenticate using Discord OAuth2 session cookies. Dedicated developer API keys can be generated in the Dashboard Developer tab.

Architecture & Overview

Key Features & Capabilities

Step-by-Step Walkthrough

Query System Health & Uptime

Run an AI Arena Dual Benchmark

Inspect Guild Stats Programmatically

Real-World Examples & Outputs

GET /api/status Response Sample

Troubleshooting & Common Pitfalls

Frequently Asked Questions

Where do I obtain an API key?

Related Documentation & Guides