Make applications with DIY

Getting Started

DIY's API is open for use by any institution or individual. We only ask that you follow the content guidelines and other terms found in our TOS. If you have any feature requests or questions about our roadmap, please let us know.

Limits & Pagination

Resources that return an array of objects support limits and pagination. These parameters may be passed to the API using the "limit" and "offset" query variables respectively. For example, the following cURL command will return the first 2 results from the /skills resource:

curl "https://api.diy.org/skills?limit=2&offset=0"

API Versioning

It is recommended that API users declare the "Accept-Version" header prior to deploying any application to production. The current API version is 3.3.1 and follows semantic versioning conventions.

curl -H "Accept-Version:~3.3" https://api.diy.org/skills

Authentication

The authorize method returns an access token that can be used as the key to generate an SHA1 HMAC token for subsequent requests by using the provided maker "url". Once generated, future requests can be signed as:

Rate Limits & Bursting

The API enforces a rate limit of approximately 10 requests/sec per IP. Bursting is provided as a convienence, but continuous usage above the rate limit may result in the API returning a 429 status code. If you feel that your application may need an exception to this rate limit, please contact us.