About

dl.bukkit.org is written in Python, using the Django Framework.

Our API

Version 1 (the current) of our API may be found at http://dl.bukkit.org/api/1.0/downloads/ - all relative URLs below have this as their base.

You may view an apigee console for this version over here.

Depending on your Accept header, you may be sent XML (application/xml), JSON (application/json) or JSONP (application/jsonp). If you cannot change headers and wish a different format, you may override the Accept header by adding a new query field "_accept=application/json". JSONP uses the "callback" query field for the method to use.

The API has the following entrypoints:

channels/
This entrypoint provides general information on all the download "channels" (e.g. Recommended Build, Beta) that are available on dl.bukkit.org
channels/CHANNEL_SLUG_HERE/
This entrypoint provides detailed information on the specified channel
projects/
This entrypoint provides general information on all the download projects available on the system (e.g. CraftBukkit, Bukkit)
projects/PROJECT_SLUG_HERE/
This entrypoint provides detailed information on the specified project
projects/PROJECT_SLUG_HERE/artifacts/
This entrypoint provides general information on all the downloadable files available for the specified project
projects/PROJECT_SLUG_HERE/artifacts/CHANNEL_SLUG_HERE/
This entrypoint provides general information on all the downloadable files in the specified download "channel" for the specified project
projects/PROJECT_SLUG_HERE/view/ARTIFACT_SLUG_HERE/
This entrypoint provides detailed information on the specified specific artifact

Artifact slugs may be in the following format:

latest
The absolute latest artifact.
latest-{channel_slug}
The latest artifact for the given channel. Note that it's not guaranteed that the artifact will be in this channel, only that it's "at least" this channel. For example, requesting the latest dev may return an RB if the RB is new enough.
git-{commit_ref}
The artifact with the given commit reference. The commit ref doesn't have to be full, but it's advised to use a full ref to avoid ambiguity.
build-{build_number}
The artifact with the given build number.

Attributions

  • Some icons (img/fugue directory) by Yusuke Kamiyamane: all rights reserved. Those icons licensed under a Creative Commons Attribution 3.0 License.
  • "Download" symbol by The Noun Project, from thenounproject.com collection
  • "Skull and crossbones" symbol by Matthew Hock, from The Noun Project, from thenounproject.com collection
  • Landing Page Design inspired by GetFirefox