Getting started
Caching
The data changes only when someone edits the wiki, so most calls can be answered with “nothing new”.
The catalogue version
Every answer carries version (“v790”): the catalogue it comes from. It changes with every edit on the wiki, and the root route gives it for the price of a few bytes.
ETags
Every JSON answer has an ETag for that version and that question (path and query, in any order). Send it back as If-None-Match: if nothing changed, the answer is a 304 with no body.
# the first time: 200, with an ETag
curl -i "https://isleswiki.net/api/v1/elixirs"
# ETag: "v790-kJc8a3VnXw2T"
# after that: 304 while nothing changed
curl -i "https://isleswiki.net/api/v1/elixirs" \
-H 'If-None-Match: "v790-kJc8a3VnXw2T"'In a browser
Answers may be kept for a minute (Cache-Control: public, max-age=60), and browsers send ETags back by themselves. Every route allows calls from any site (CORS).
Icons