Sending POSTs

You use a request tool, such as Postman, to ensure POSTs are well-formed and to review the structure of the response payloads. For more information, see Requests and responses.

Send a POST using Postman

Procedure

  1. In Postman, start a new request by clicking the + to the right of the Launchpad tab.
  2. Specify Basic Auth authorization using user aapplegate and password gw.
  3. Under the Untitled Request label, make sure that POST is selected.
  4. In the Enter request URL field, enter the URL for the server and the endpoint.
    • For example, to create a new note for activity pc:101 on an instance of PolicyCenter on your machine, enter: http://localhost:8180/pc/rest/common/v1/activities/pc:101/notes
  5. Specify the request payload.
    1. In the first row of tabs (the one that starts with Params), click Body.
    2. In the row of radio buttons, select raw.
    3. At the end of the row of radio buttons, change the drop-down list value from Text to JSON.
    4. Paste the request payload into the text field underneath the radio buttons.
  6. Click Send. The response payload appears below the request payload.

Tutorial: Create a new note that specifies required fields only

This tutorial assumes you have set up your environment with Postman and the correct sample data set. For more information, see Tutorial: Set up your Postman environment.

In this tutorial, you will create a note whose subject is "API tutorial note 1" for an existing activity. The other fields will not be specified and will be assigned default values by the application (such as not being confidential and having a subject of "General").

Tutorial steps

  1. In Postman, start a new request by clicking the + to the right of the Launchpad tab.
  2. Specify Basic Auth authorization using user aapplegate and password gw.
  3. Enter the following call and click Send:

    GET http://localhost:8180/pc/rest/common/v1/activities

  4. Identify the id of the first activity in the payload. (It is pc:101.)
  5. Enter the following call, but do not click Send yet:

    POST http://localhost:8180/pc/rest/common/v1/activities/pc:101/notes

  6. Specify the request payload.
    1. In the first row of tabs (the one that starts with Params), click Body.
    2. In the row of radio buttons, select raw.
    3. At the end of the row of radio buttons, change the drop-down list value from Text to JSON.
    4. Paste the following into the text field underneath the radio buttons. 
      {
    "data":
        {
            "attributes": {
                "body": "API tutorial note 1"
                }
        }
}
  7. Click Send. The response payload appears below the request payload.

Checking your work

  1. View the new note in PolicyCenter.
    1. Log on to ClaimCenter as aapplegate and click My Activities.
    2. Activity pc:101 is a "Verify coverage" activity. Click the subject of this activity. PolicyCenter opens an Activity Detail worksheet in the bottom pane.
    3. Click View Notes.

The API tutorial note should be listed as one of the notes.

Tutorial: Create a new note that specifies optional fields

This tutorial assumes you have set up your environment with Postman and the correct sample data set. For more information, see Tutorial: Set up your Postman environment.

In this tutorial, you will create a note whose subject is "API tutorial note 2" for an existing activity. You will also specify values for two optional fields: confidential (set to true) and subject (set to "Legal").

Tutorial steps

  1. In Postman, start a new request by clicking the + to the right of the Launchpad tab.
  2. Specify Basic Auth authorization using user aapplegate and password gw.
  3. Enter the following call and click Send:

    GET http://localhost:8180/pc/rest/common/v1/activities

  4. Identify the id of the first activity in the payload. (It is pc:101.)
  5. Enter the following call, but do not click Send yet:

    POST http://localhost:8180/pc/rest/common/v1/activities/pc:101/notes

  6. Specify the request payload.
    1. In the first row of tabs (the one that starts with Params), click Body.
    2. In the row of radio buttons, select raw.
    3. At the end of the row of radio buttons, change the drop-down list value from Text to JSON.
    4. Paste the following into the text field underneath the radio buttons. 
      {
    "data":
        {
            "attributes": {
                "body": "API tutorial note 2",
                "confidential": true,
                "topic": {
                    "code": "legal"
                }
            }
        }
}
  7. Click Send. The response payload appears below the request payload.

Checking your work

  1. View the new note in PolicyCenter.
    1. Log on to ClaimCenter as aapplegate and click My Activities.
    2. Activity pc:101 is a "Verify coverage" activity. Click the subject of this activity. PolicyCenter opens an Activity Detail worksheet in the bottom pane.
    3. Click View Notes.

The API tutorial note should be listed as one of the notes. This note is confidential and it has the category specified in the request payload.