Managing applications

You can show or reset a client ID for an application, verify or reset a client secret, and view the details of the APIs in the application. You can also unsubscribe from a Plan that the application is subscribed to.

About this task

On the application details page, you can display and reset a client ID and client secret. You might want to reset a client secret if it is compromised or you forget it. A client secret is only displayed once, so after you reveal it for the first time at a time of your choosing, you can use this window to verify that what you have is correct or reset it if necessary.

You can, optionally, add further client ID/client secret pairs to an application, any of which can be used to identify the application when calling an API.

Procedure

To manage an application, complete the following steps:

  1. Click Apps.
    The Apps page opens.
  2. Select the application that you want to work with from the displayed list.
  3. The client ID is hidden; to display the client ID, select the Show check box. The client ID is displayed, and can be hidden again by clearing the Show check box.
  4. To reset your client ID, click Reset.
    Warning: API calls made by the application with the existing client ID will fail.
  5. If the client secret is compromised or you forget it, click Reset to generate a new value for the client secret.
  6. If you are unsure whether the value that you have for the client secret is correct, you can click Verify, enter the value, and click Submit to confirm whether or not it is correct.
  7. To add an additional client ID and client secret to the application, complete the following steps:
    1. Click Add alongside Client Credentials.
      The Request additional client credentials window opens.
    2. Enter an optional description, and click Submit.
    3. Select the Show Client ID or Show Client Secret check box to display the client ID or client secret for the new credentials.
    4. To add a description to a set of client credentials, or to change the current description, click Update alongside the required credentials.
    5. To remove a set of client credentials from the application, click Delete alongside the required credentials.
    If you add additional credentials to an application, any of the associated client ID/client secret pairs can be used to identify the application when calling an API. An application can have at most 20 client ID/client secret pairs.
    Note: If you add two or more sets of client credentials to an application, OAuth tokens are not shared between them; each client credential set uses a different OAuth token.
  8. To view more details about an individual API, click the API name.
    The operations are listed.
  9. To unsubscribe from a Plan, click Unsubscribe alongside the Plan name.