REST API - View a list of SLAs
GET /slas
- This method allows a list of SLAs to be obtained.
- To obtain detailed information for a specified SLA: GET /slas/{sla_id}.
See the method.
Notes
See Service Manager REST API Conventions
- If successful, an HTTP status code 200 is returned.
- By default, if the optional parameter fields is not used, only an extract of the most useful fields selected by EasyVista is displayed for each record provided.
- A URL link (HREF) to each resource is provided so that the complete list of fields for a record can be obtained.
List of parameters / fields
Mandatory parameters
None
Optional parameters
You can use the parameters detailed below in the HTTP request string.
Minimum version | Parameter | Type | Description / Example | ||
---|---|---|---|---|---|
max_rows | integer | Maximum number of records to display.
|
|||
sort | string | Sort in ascending or descending order.
|
|||
fields | string | Select fields to display.
|
|||
search | string | Search/filter the specified fields. ![]()
|
|||
Oxygen 2.1.2 - Build 2018.1.183.0 | search
(logical OR operator) |
string | Search/filter to several values from a same field
|
||
Oxygène 1.7 - Build 2018.1.131.0 | ~
(equivalent to like) |
string | Include the results which begin with or contain a given character string.
|
||
Oxygen 1.7 - Build 2018.1.131.0 | !~
(equivalent to not like) |
string | Exclude the results which begin with or contain a given character string.
|
||
Oxygen 1.7 - Build 2018.1.131.0 | !
(equivalent to not) |
string | Exclude all results equal to a given character string.
|
||
Oxygen 2.1.2 - Build 2018.1.183.0 | is_null | string | Retrieve all results in which the field has no value (field value = null)
|
||
Oxygen 2.1.2 - Build 2018.1.183.0 | is_not_null | string | Retrieve all results in which the field has a value (field value = not null)
|
||
Oxygen 1.7 - Build 2018.1.131.0 | formatDate | string | Format display of Date fields in the HTTP request result. ![]()
|
Fields that could be used in optional parameters
You can use all the fields from the SD_SLA table.
HTTP status codes for the method
StatusHeader
Note: A Timeout error code will be returned if the server does not respond to the REST Web service request within a given time (by default 60 seconds).
Code | Error | Description |
---|
Status200
200 | OK (Success) | Request processed successfully. |
Status401
401 | Unauthorized | Authentication process for accessing the resource is incorrect: Login/Password incorrect, Invalid session, Incorrect Service Manager account.
example { "error": "Invalid Login / Password" } |
Example
Result for 2 SLAs (status code 200)
"HREF": "http://{your_server}/api/v1/{your_account}/slas?fields=name_en,name_fr&max_rows=2",
"record_count": "2",
"total_record_count": "6",
"records": [
{
"HREF": "http://{your_server}/api/v1/{your_account}/80003/slas/4",
"DELAY": "4,00",
"NAME_EN": "4 hours",
"NAME_FR": "4 heures",
"SLA_ID": "4"
},
{
"HREF": "http://{your_server}/api/v1/{your_account}/slas/8",
"DELAY": "6,00",
"NAME_EN": "6 hours",
"NAME_FR": "6 heures",
"SLA_ID": "8"
}
]
}
ConventionsAPI
REST API Conventions
Convention | Meaning | |
---|---|---|
Orange | Parameters used in an HTTP request string which do not correspond to Service Manager database fields.
example Method View a list of assets https://{your_server}/api/v1/{your_account}/assets?max_rows=3&fields=asset_tag |
|
Black and Bold | Parameters used in the URL of an HTTP request which correspond to Service Manager database fields.
example Method View an asset https://{your_server}/api/v1/{your_account}/assets/{asset_id} |
|
Green | Parameters used in the body of an HTTP request which represent JSON object names corresponding to Service Manager database fields; they allow the value of a database field to be assigned or modified.
example Method Close an incident/request { "closed": { "end_date": "11/20/2016 12:12:12", } } |
|
Parameters used in the body of an HTTP request which represent JSON object names not corresponding to Service Manager database fields.
example Method Reopen an incident/request { "restarted": { "comment": "string (required)" } } |