Sacred API – IDLE MMO Guild Tracking

Base Information

Base URL: https://api.idle-mmo.com/v1
Authentication: Bearer Token
Default Rate Limit: 20 requests / minute
Timestamp Format: UTC ISO 8601

Authentication

All API requests must include an API key using the Authorization header.

Authorization: Bearer <YOUR_API_KEY>

Never share your API key. If a key is exposed, revoke and rotate it immediately.

Required Headers

Authorization: Bearer <YOUR_API_KEY>
Accept: application/json
User-Agent: YourApp/1.0.0

Example request

curl -H "Authorization: Bearer <YOUR_API_KEY>" \
     -H "Accept: application/json" \
     -H "User-Agent: SacredDocs/1.0.0" \
     "https://api.idle-mmo.com/v1/guilds/12345"

Guild Tracking Endpoints

Guild Overview

GET /guilds/{guildId}

Guild Members

GET /guilds/{guildId}/members

Guild Activity Log

GET /guilds/{guildId}/activity?since=2026-02-01T00:00:00Z

Guild Contributions

GET /guilds/{guildId}/contributions

Guild Events

GET /guilds/{guildId}/events

These endpoints are intended for dashboards, attendance tracking, contribution summaries, and audit logs.

Rate Limits

The default rate limit is 20 requests per minute. Clients should cache responses and avoid excessive polling.

Error Format

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Retry after 12 seconds."
  }
}

Security Notes

Do not embed API keys in client-side code.
Use least-privilege keys when possible.
Rotate keys immediately if compromised.
Set a clear and descriptive User-Agent.