Viserio Cooldowns API
For Developers
A small, read-only API for your group roster, raid resets, and note structure.
v0, unstable. Responses can change and access can be switched off while this settles. Build against the /v1 prefix and expect the shape to tighten before it is called stable.
What v1 gives you
Roster
Members and their characters: name, realm, class and spec, rank, and who has claimed what.
Raid resets
Each week’s setups: boss order, the players in them, and which notes and assignments are attached.
Notes & assignments
Structure and labels only: name, boss, difficulty, counts, timestamps. The contents are never returned.
Read-only
The API only reads. There is no way to change your group through it in v1.
How access works
Per group, not per person
A group admin turns on API sharing in the group settings. It stays off until they do.
One key, sent in a header
Each group has a single key, shown once. Send it in the request Authorization header, never in a URL.
Hourly request quota
Each group gets 20 requests an hour, raised to 75 then 200 as the group is boosted. Access is never gated; boost only lifts this ceiling.
Conditional requests save bandwidth
Send the ETag back as If-None-Match. If nothing changed you get an empty 304 instead of the full payload. Every request still counts against the quota, so poll on a sensible interval.
Get started
- 1
Be a group admin
Only an admin can turn on sharing and manage the key. Not an admin? Ask your raid lead.
- 2
Open API Access
In your group, go to Settings, then API Access.
- 3
Create your key
Turn on sharing, add a short note about what the key is for, and copy it right away. It is shown once and cannot be recovered.
- 4
Make your first call
Send the key in the Authorization header. Start at the root and follow the links it returns to reach your group data.
Feature requests
v1 is deliberately small. If you need something it does not do yet, tell us in Discord and ask for Penkek. Say what you are building and what you need next.
v1 is read-only and offered as-is, with no uptime promise. It is rate limited and can be throttled or switched off to protect the site.