Add Request Body Examples

Q

How to add request body examples to my Azure API operation to make it more user friendly?

✍: FYIcenter.com

A

If you have created the "First API" API and "Add new user" operation as described in previous tutorials, you can follow this tutorial to add request body examples.

1. Go to the publisher portal of the API Management Service.

2. Open the "First API" and open the operation "Add new user".

3. Click "Body" on the left. You see a list of body detail fields.

4. Fill in each field with the following:

Description: Provide the new user information in the body.

ADD REPRESENTATION
   text/xml
      <user>
         <name>Joe</name>
         <age>25</age>
      </user>

5. Click the "Save" button. The API operation is updated.

Click "ADD REPRESENTATION" to add more examples, like:

application/json
   {
       "user": {
           "name": "Joe",
           "age": "25"
       }
   }

The picture below shows you steps on how to add request body examples on an API operation:
API Operation - Add Request Body Example

 

Making API More User Friendly

⇒⇒Microsoft Azure API Management Tutorials

2017-09-23, 122👍, 0💬