This describes the resources that make up the official Doorkeeper API. If you have any problems or requests, please contact support.

Note: This API is in an alpha state. Breaking changes are expected to occur.


Schema

All API access is over HTTP, and accessed via api.doorkeeper.jp. All data is sent and received as JSON or XML.

Example

$ curl -i http://api.doorkeeper.jp/
HTTP/1.1 200 OK
Content-Length: 2
Status: 200
Content-Type: application/json; charset=utf-8

{}

Blank fields are included as null instead of being omitted.

All timestamps are returned in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ

Pagination

Requests that return multiple items will be paginated to 25 items. You can specify further pages with the ?page parameter.


Events

There are two scopes for the events API, you can either request the events for a specific community, or all featured events on Doorkeeper.

List a community's events

GET /groups/:group/events

List all featured events

GET /events

Parameters

To further control the results, we support the following paramters:

page
The page offset of the results.
locale
The localized text for an event. One of en, ja. Default: en.
sort
The order of the results. One of published_at, starts_at, updated_at. Default: published_at.
since
Only events taking place during or after this date will be included. (ISO 8601 date) Default: Today.
until
Only events taking place during or before this date will be included. (ISO 8601 date)
callback
JSON-P callback that wraps the results in the given function.

Event

Show a specific event

GET /events/:id

Application Showcase

API Terms of Use

updated 2014-7-31

Thank you for using the Doorkeeper Inc (“Doorkeeper” or “we”) application programming interfaces and associated tools and documentation (including all updates and other modifications thereto, the “Doorkeeper API”) to create a website or software application (including all components and content thereof, your “Application”), which will display and use certain data and content made available through the Doorkeeper API (the “Content”) or Doorkeeper’s website located at www.doorkeeper.jp and www.doorkeeperhq.com (the “Website”).

By using the Doorkeeper API, you agree to these terms of use (these “Terms of Use”) and the Doorkeeper Terms of Service (“TOS”) located at http://www.doorkeeper.jp/terms (including the Doorkeeper Privacy Policy referenced therein). If you disagree with any of the terms below or the TOS, Doorkeeper does not grant you a license to use the Doorkeeper API. In the event of any inconsistency between these Terms of Use and the TOS, these Terms of Use control.

Here are the basic rules governing your use of the Doorkeeper API:

Ownership

The Content transmitted in connection with the Doorkeeper API belongs to Doorkeeper’s customers and/or Doorkeeper. Please keep this in mind as you plan your Application. Don’t do anything that would undermine the Content.

Must Have Information

If you display an event, the event must include and display a link to the event webpage associated with that event on Doorkeeper, and you may not specify a nofollow or similar HTML attribute value to such link.

Responsibility

You are responsible for your Application and any use of your Application. Among other things, this means that you are responsible for maintaining your own user agreement and privacy policy for users of your Application. Your user agreement must permit you and the users of your Application to comply with these Terms of Use and the TOS (including Doorkeeper’s Privacy Policy). Your privacy policy must be at least as stringent and user-friendly as Doorkeeper’s Privacy Policy. In general, we expect you to be thoughtful and considerate and not abuse users’ data.

Have any questions about these terms? Feel free to get in touch