API Documentation

Explore the App Center API Service with swagger.

Getting Started

How to acquire an API token from App Center and make calls to the App Center API

  1. Navigate to https://appcenter.ms and login with your account information.
  2. On the bottom left corner, click your username and select Account Settings.

    The account details menu to select Settings

  3. In the middle panel, select API Tokens from the menu list.

  4. On the top right corner, click New API token.
  5. In the text field, enter a descriptive name for your token.
  6. Select the type of access for your API token:
    • Full Access
      • A full access API token has all the permissions that the associated user has for that app. For example, if the user does not have manager or developer permissions for an app, the user cannot run a test (which requires developer or manager permissions) even though the user is using a full access API token.
    • Read Only
      • A read only API token has viewer access permissions. For example, with a read only API token, the user can perform actions such as reading data from crashes, analytics, and getting basic app information. Users cannot perform actions such as changing the app settings, triggering a build, creating an export configuration etc.
  7. At the bottom of the panel, click Add new API token.
  8. This will generate a pop up with your API token. Copy and store it in a secure location for later use. For security reasons, you will not be able to see or generate the same token again after you click the Close button.
  9. Click the Close button.
  10. Navigate to App Center's swagger page to explore our APIs.
  11. On the upper right corner, click on the Authorize button.
  12. Under the APIToken section, paste the API token value that you just copied into the text field titled Value and click Authorize.

    Setting api token value to authorize our API's

  13. If it shows "Authorized" and a Logout-Button, authorization was successful. On the top right corner of the pop up, click the "X" to exit the pop up.

  14. You are now able to use any App Center API and see the response. Enjoy!

Running your first API call

This section shows you how to use App Center's swagger page by using the API call GET /v0.1/user. This API call returns the user's profile data.

  1. Complete steps 1-14 in the previous section.
  2. Navigate to App Center's swagger page to explore our APIs.
  3. Under Account, click on GET /v0.1/user.
  4. On the left-hand corner, click the Try it out button.
  5. Click the Execute button under the Parameters section.
  6. Awesome! You can now see the response under the Responses section.