Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...


NameDescription
1

Anchor
Add grade
Add grade
Add grade

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Add a new grade.

Name

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

Anchor
Delete grade
Delete grade
Delete grade

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Delete a grade via grade ID.

Name

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

Anchor
Find grade
Find grade
Find grade

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

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 department grade ID.
organizationIdFilter departments grades that belong to an organization, via organization ID.
sort

Department 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
Code Block
languagejs
[
  {
    "id": "G-001",
    "name": "Board Members",
    "description": ""
  },
  {
    "id": "G-002",
    "name": "Managers",
    "description": ""
  },
	.....
]
4

Anchor
Get grade by ID
Get grade by ID
Get grade by ID

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Get details of a grade via grade ID.

Name

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

Anchor
Update grade
Update grade
Update grade

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Update the details of a grade.

Name

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

...