Skip to content
Sprax edited this page Mar 5, 2020 · 6 revisions

Api.Sprax2013.de

This API is publicly hosted on Api.Sprax2013.de. The API uses its own cache and CloudFlare. For the best performance, you should pay attention to the expiry headers.

Routes

Route Description
/mc Like the original Mojang-API (for Minecraft) but with a cache to prevent rate limiting and more
/SkinDB The API used for SkinDB.net Outdated
/status The api's status (not cached)

User-Agent

Please set a custom User-Agent! I don't want to block you for extensive use but I would love to see who or witch projects are using my API. Additionally, keep in mind that your User-Agent may be made public in the future to provide some fancy graphs and statistics.

General Information

This API always sends and receives JSON formatted bodies, unless specified. If your request was blocked by CloudFlare (non 200 status code), you're likely to get HTML instead of JSON.

Errors

Errors reported by the API currently consist of two parts: HTTP Status Code and an JSON-Body

Example:

{
  "error": "Bad Request",
  "message": "Missing or invalid url parameters",
  "details": [
    {
      "param": "user",
      "condition": "user.length > 0"
    }
  ]
}

https://api.sprax2013.de/mc/profile/

  • error always is a string, normally containing an explanaition of the HTTP Status Code.
  • message tries to explain what is wrong
  • details (not always there) gives a more detailed explanation on how to fix this error

Rate Limiting

This API in generall is not rate limited. Please make sure to take a look on the other wiki pages for further information for this.

The API is protected by CloudFlare, to block bad behaving clients. If you are having trouble, don't hesitate to open an issue.

Contents

Routes

Clone this wiki locally