Accessing and testing Pega DX API Version 2

Familiarize yourself with Pega DX API Version 2 (V2) and learn to use it successfully by exploring what you can achieve with individual endpoints. By generating a sample response to a simulated endpoint call, you can better understand how the endpoint works and what types of responses to expect.
Before you begin: Create an OAuth 2.0 client registration data instance and save the credentials to be able to test individual endpoints. For more information, see Creating authorization for DX API tests.
  1. In the header of Dev Studio, click the Resources menu icon, and then click Pega API.
  2. In the Pega API Help window, in the Service package list, select V2 DX API.
    Note: The Pega API Help window might appear as a new tab in your browser, depending on your setup.
  3. Click Authorize.
  4. In the Available authorizations window, in the Password (OAuth2, password) section, enter the required credentials:
    1. In the username: and password: fields, enter your Pega credentials.
    2. In the client_id: and client_secret: fields, enter the OAuth credentials that you saved in Creating authorization for DX API tests.
  5. Click Authorize, and then click Close.
    Result: You can now test the endpoints.
  6. Click the endpoint that you want to test.
    Result: The details of the endpoint appear, including a description, parameters, and sample responses.
  7. Test the endpoint:
    1. Click Try it out!.
    2. If the endpoint requires additional parameters, enter the information in the required fields.
    For example: If you want to test the GET /cases/{caseID}/attachments endpoint, which retrieves a list of attachments in a specific case, after you click Try it out!, provide the case ID.
    1. Click Execute.
    Result: The system generates a response to the simulated query, as in the following example:

    Figure: Sample JSON response

    A sample V2 DX API test response generated by the system.