You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Next »

Definition

Grade API can perform functions to interact or exchange data for Grade.


NameDescription
1

Add grade

Add a new grade.

Name

Description
URL/grade
HTTP MethodPOST
Body Parameters
ParameterDescription
idGrade ID.
nameGrade name.
descriptionDescription of grade.
Sample Response
{
  "id": "apiTestGrade",
  "name": "API Test Grade",
  "description": "This is a grade created by API."
}
2

Delete grade

Delete a grade via grade ID.

Name

Description
URL/grade/{id}
HTTP MethodDELETE
Path Parameters
ParameterDescription
idGrade ID.
Sample Response
{
  "date": "Wed Aug 28 15:43:58 SGT 2019",
  "code": "200",
  "message": "Successful operation"
}
3

Find grade

Gets all grades from all organizations by default.

Able to filter or sort the returned results via parameters.

Name

Description
URL/grade/find
HTTP MethodGET
Query String Parameters
ParameterDescription
nameFilterFilters the response via grade ID.
organizationIdFilter grades that belong to an organization, via organization ID.
sort

Grade data column to sort.

Must be used in conjunction with "sortDescending" parameter.

sortDescending

Sort the specified "sort" parameter value in ascending or descending order.

Expects a boolean value.

Must be used in conjunction with "sort" parameter.

startOffsetStarting position of records to start query. Expects an integer.
pageSizeNumber of results to return. Expects an integer.
Sample Response
[
  {
    "id": "G-001",
    "name": "Board Members",
    "description": ""
  },
  {
    "id": "G-002",
    "name": "Managers",
    "description": ""
  },
	.....
]
4

Get grade by ID

Get details of a grade via grade ID.

Name

Description
URL/grade/{id}
HTTP MethodGET
Path Parameters
ParameterDescription
idGrade ID.
Sample Response
{
  "id": "G-001",
  "name": "Board Members",
  "description": ""
}
5

Update grade

Update the details of a grade.

Name

Description
URL/grade
HTTP MethodPUT
Body Parameters
ParameterDescription
idGrade ID.
nameGrade name.
descriptionDescription of grade.
Sample Response
{
  "id": "apiTestGrade",
  "name": "API Test Grade",
  "description": "This grade is updated via API."
}




  • No labels