moth/docs/download-everything.md

Download All Unlocked Puzzles

We get a lot of requests to "download everything" from an event. Here's how you could do that:

What You Need

• The URL to your puzzle server. We will call this $url.
• Your Team ID. We will call this $teamid.
• A way to POST id=$teamid with Content-Type: x-www-form-encoded to a URL, and save the result. We will call this procedure "Fetch".
• A way to parse JSON files

Steps

1. Fetch $url/state. This is the State object.
2. In the State object, Puzzles maps category name to a list of open puzzle point values.
3. For each category (we will call this $category):
   1. For each point value:
      1. If the point value is 0, skip it. 0 indicates all puzzles in this category are unlocked.
      2. Fetch $url/content/$category/$points/index.json. This is the Puzzle object.
      3. In the Puzzle object, Body contains the HTML body of the puzzle.
      4. In the Puzzle object, Attachments contains a list of attachments. For each attachment (we will call this $attachment):
         1. Fetch $url/content/$category/$points/$attachment.