Path Parameters
Path parameters are part of the URI. For example, the URI can include phones/item, where /item is a path parameter that identifies the item in the collection of /phones. Because path parameters are part of the URI, they are essential in identifying the request.
Now, consider the above online Phone Store API example. A customer may wish to fetch details about a phone {phone-id} whose product code is "412456". The URI for this resource could look like this:
/phones/412456
Important: | When you specify a path parameter in the resource URI, as a best practice, we recommend that you adopt the following conventions: Append the path parameter variable within curly {} brackets. Specify the path parameter variable to exactly match with the path parameter. |