API Reference

Introduction

Our REST API is structured to be intuitive and easy to use, supporting standard HTTP methods and returning data in JSON format for maximum compatibility and ease of parsing. In the following sections, you'll find a complete breakdown of available endpoints, request methods, expected parameters, and sample responses to help you get started quickly and efficiently.

Authentication

Our API supports OAuth 2 integration, providing a secure and standardized method for authenticating and authorizing users. There are two types of API keys...

  • Private: Private keys are designed for creating and updating posts, and can not be used to display a blog on your website. Employing them on your frontend poses a security risk.
  • Public: Public keys are used to render your blog on your website.

You can manage your OAuth tokens in your DropInBlog account.

Rate Limits

The default rate limit is 60 requests per minute. Exceeding the rate limit will result in a HTTP 429 error requesting you slow down the rate you are making requests at.

Every request has two rate limit related response headers.

Response HeaderDescription
x-ratelimit-limitContains the current overall rate limit per minute
x-ratelimit-remainingContains the number of available requests remaining in the current minute