Runrun.it API Documentation
How to authenticate to use the API
Every request to the API, should be sent with the authentication information, the
user_token sent on the HEADER like:
curl "https://secure.runrun.it/api/v1.0/users" -X GET \ -H "App-Key: f9c650c98eeb28e345e0a38a184d20cb" \ -H "User-Token: roBknmkPI0ALmwkRuC1q"
Whenever you send the incorrect information on
user_token, the response is going to be
user_token is per user and when you use this, you will perform actions on behalf of that user, on Runrun.it, it will appear that the user have done the action
How to obtain authentication information to use the API
API access is a premium feature only available for customers of certain paid accounts. To see which plans have API access check here. However developers with ideas for apps taking advantage of Runrun.it are always welcome to contact firstname.lastname@example.org about setting up a test account with API access.
- Go to your profile on Runrun.it
- Then click on
app_keywill be displayed with the
All responses will be valid JSON. Requests should be in JSON as well (although for most actions form-encoded data is accepted as well).
All dates will be in ISO 8601 format. The time-zones if specified, will take in account when doing date operations. Another thing to be mentioned is that you need to
urlencode your dates if it does contains special characters as
+ to specify time-zones.
All calls to the API are recorded. Excessive use of the API will result in the offending
app_key being revoked to ensure quality of service for other users. If you anticipate a need
to issue a large number of API of calls please enter in contact with support beforehand.
Contacting API Support
If you have any trouble using the API, you can send an email to email@example.com.