API Calls
Name | Description | Shortcut |
---|---|---|
GET: List Weights resources Request | This method can be used to retrieve a list of current weight resources. | Description |
GET: List a specific Weights resource | This method can be used to retrieve a specific weight resource based on its id. | Description |
POST: Create a new weight resource | This method can be used to create a new weight resource | Description |
PUT: Update a weight resource | This method can be used to update information on an existing weight resource | Description |
DELETE: Delete a weight resource | This method can be used to delete an existing weight resource | Description |
[GET]: List weight resources
This method can be used to retrieve a list of current weight resources
Input
GET /weights
Optional Query Parameters
Type | Description | Required |
---|---|---|
name |
weight resource name to be used as query | NO |
date |
Date to retrieve a historic version of the weights resource. If no date parameter is provided the most current profile will be returned | NO |
Request headers
x-api-key: shared_key_value
Accept: application/json
Response
Headers: Status: 200 OK
Response body
Json Response
{
"status": {
"message": "Success",
"code": "200"
},
"data": [
{
"id": "6ac7d684-1f8e-4a02-a502-720e8f11e50b",
"date": "2019-11-04",
"name": "Critical",
"weight_type": "hepsepc",
"group_type": "SITES",
"groups": [
{
"name": "SITE-A",
"value": 1673
},
{
"name": "SITE-B",
"value": 1234
},
{
"name": "SITE-C",
"value": 523
},
{
"name": "SITE-D",
"value": 2
}
]
},
{
"id": "6ac7d684-1f8e-4a02-a502-720e8f11e50c",
"date": "2019-11-02",
"name": "NonCritical",
"weight_type": "hepsepc",
"group_type": "SERVICEGROUPS",
"groups": [
{
"name": "SVGROUP-A",
"value": 334
},
{
"name": "SVGROUP-B",
"value": 588
}
]
}
]
}
[GET]: List A Specific weight resource
This method can be used to retrieve specific weight resource based on its id
Input
GET /weights/{ID}
Optional Query Parameters
Type | Description | Required |
---|---|---|
date |
Date to retrieve a historic version of the weights resource. If no date parameter is provided the most current profile will be returned | NO |
Request headers
x-api-key: shared_key_value
Accept: application/json
Response
Headers: Status: 200 OK
Response body
Json Response
{
"status": {
"message": "Success",
"code": "200"
},
"data": [
{
"id": "6ac7d684-1f8e-4a02-a502-720e8f11e50c",
"date": "2019-11-02",
"name": "NonCritical",
"weight_type": "hepsepc",
"group_type": "SERVICEGROUPS",
"groups": [
{
"name": "SVGROUP-A",
"value": 334
},
{
"name": "SVGROUP-B",
"value": 588
}
]
}
]
}
[POST]: Create a new weight resource
This method can be used to insert a new weight resource
Input
POST /weights
Optional Query Parameters
Type | Description | Required |
---|---|---|
date |
Date to create a historic version of the weights resource. If no date parameter is provided the current date will be supplied automatically | NO |
Request headers
x-api-key: shared_key_value
Accept: application/json
POST BODY
{
"name": "weight_set3",
"weight_type": "hepspec2",
"group_type": "SITES",
"groups": [
{ "name": "site-a", "value": 336 },
{ "name": "site-b", "value": 343 },
{ "name": "site-c", "value": 553 },
{ "name": "site-d", "value": 435 },
{ "name": "site-e", "value": 3.33 },
{ "name": "site-f", "value": 323.3 }
]
}
Response
Headers: Status: 201 Created
Response body
Json Response
{
"status": {
"message": "Weight resource successfully created",
"code": "201"
},
"data": {
"id": "{{ID}}",
"links": {
"self": "https:///api/v2/weights/{{ID}}"
}
}
}
[PUT]: Update information on an existing weight resource
This method can be used to update information on an existing weight resource
Input
PUT /weights/{ID}
Optional Query Parameters
Type | Description | Required |
---|---|---|
date |
Date to update a historic version of the weights resource. If no date parameter is provided If no date parameter is provided the current date will be supplied automatically | NO |
Request headers
x-api-key: shared_key_value
Accept: application/json
PUT BODY
{
"name": "weight_set3",
"weight_type": "hepspec2",
"group_type": "SITES",
"groups": [
{ "name": "site-a", "value": 1336 },
{ "name": "site-b", "value": 1343 }
]
}
Response
Headers: Status: 200 OK
Response body
Json Response
{
"status": {
"message": "Weight resource successfully updated",
"code": "200"
},
"data": {
"id": "{{ID}}",
"links": {
"self": "https:///api/v2/weights/{{ID}}"
}
}
}
[DELETE]: Delete an existing weight resource
This method can be used to delete an existing weight resource
Input
DELETE /weights/{ID}
Request headers
x-api-key: shared_key_value
Accept: application/json
Response
Headers: Status: 200 OK
Response body
Json Response
{
"status": {
"message": "Weight resource Successfully Deleted",
"code": "200"
}
}