parameter for api documetnation table code example
Example: types of parameters in rest service
2 TYPES OF PARAMETERS IN REST SERVICES:
1) QUERY PARAMETERS:
-> is NOT part of url and passed in key=value format
those parameters must be defined by API developer
http://34.223.219.142:1212/ords/hr/employees?limit=100
Query parameters are the most common type of parameters.
They appear at the end of the request URL after a question mark (?),
with different name=value pairs separated by ampersands (&).
Query parameters can be required and optional.
GET /pets/findByStatus?status=available
GET /notes?offset=100&limit=50
2) PATH PARAMETERS
Path parameters are variable parts of a URI path. They are typically
used to point to a specific resource within a collection, such as a user
identified by ID. A URL can have several path parameters, each
denoted with curly braces { }.
GET /users/{id}
GET /cars/{carId}/drivers/{driverId}
GET /report.{format}