IslesWikiNot officially affiliated with Isles

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.

With curlshell
# 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

Icons are kept for a day, player heads for a week, and they have ETags too.