API: Basics and Authentication

HockeyApp provides two different APIs:

The Client API is used by our SDKs to provide features like in-app updates, crash reporting, and feedback. This API requires no authentication. It should be accessed through the domain sdk.hockeyapp.net.

The Developer API is intended for developers to upload new builds, to manage data like crash reports, or in combination with third party libraries and apps. This API requires an API token for authentication. It should be accessed through the domain rink.hockeyapp.net.

Tools

Windows

The built in HockeyApp command line tool for APIs from Windows is called Hoch (Hoch.exe) and is installed with HockeyApp for Windows App.

Mac OS X

The built in HockeyApp command line tool for APIs from Mack OS X is called Puck and is installed with HockeyApp for Mac OS X App.

Multi-Platform

You can use the HockeyApp APIs from standard third-party tools such as: cURL or the Jenkins HockeyApp Plugin.
You can also write Python, Ruby, or PowerShell scripts to call the HockeyApp APIs.

Note: If you have any issues accessing the HockeyApp APIs please confirm that you are using the most updated version of command line tools.

Schema

All API access is over HTTPS. The base path for all endpoints is /api/2. Many API methods take optional parameters:

For GET requests, any parameters not specified as a segment in the path can be passed as an HTTP query string parameter.

For POST and PUT requests, parameters not included in the URL should be submitted as form data (application/x-www-form-urlencoded or multipart/form-data). All strings and plain text files must be encoded as UTF-8.

Authentication

Requests that require authentication need to set the HTTP header X-HockeyAppToken to a valid API token. Each user can create multiple tokens under API Tokens in the account menu.

JSON-P Callbacks

You can send a callback parameter to any GET call to have the results wrapped in a JSON function. This is typically used when browsers want to embed HockeyApp content in web pages by getting around cross domain issues. The response includes the same data output as the regular API.

Pagination

Requests that return multiple items will be paginated to 25 items by default. You can specify further pages with the page parameter. For some resources, you can also set a higher page size (50 or 100) with the per_page parameter.

Rate Limiting

We limit requests to 60 per minute and App ID. If the limit is exceeded, please throttle your scripts.