A good way to manage your students is to gather them into groups on our API. Il will provide you some convenient method to get aggregated results on a group.
A group can represent a class, or a formation session.
Object resources
Property | Type | Description |
id | Integer | identifier for the database of Domoscio's API |
name | String | Custom data |
created_at | DateTime | Date of creation of the object |
updated_at | DateTime | Last time the object has been modified |
Create (POST)
Method | POST |
URL | /student_groups |
Parameters (*Requiered parameters)
Property | Type | Description |
name | String | Custom data |
{
"name": "2nd year associates financial services"
}
Get the response (JSON output example)
{
"id": 31,
"name": "2nd year associates financial services",
"created_at": "2017-11-24T17:01:39.016Z",
"updated_at": "2017-11-24T17:01:39.016Z"
}
Fetch (GET)
Method | GET |
URL | /student_groups/{student_group_id} |
If no student_group_id is provided it will fetch all the Student Groups for your instance.
Get the response (JSON output example)
With ID provided
{
"id": 31,
"name": "2nd year associates financial services",
"created_at": "2017-11-24T17:01:39.016Z",
"updated_at": "2017-11-24T17:01:39.016Z"
}
Without ID provided
[
{
"id": 29,
"name": "test",
"created_at": "2017-11-21T16:25:29.409Z",
"updated_at": "2017-11-21T16:25:29.409Z"
},
{
"id": 30,
"name": "test",
"created_at": "2017-11-21T16:25:57.926Z",
"updated_at": "2017-11-21T16:25:57.926Z"
},
{
"id": 31,
"name": "2nd year associates financial services",
"created_at": "2017-11-24T17:01:39.016Z",
"updated_at": "2017-11-24T17:01:39.016Z"
}
]
EDIT (PUT)
Method | PUT |
URL | /student_groups/{student_group_id} |
Editable parameters
Property | Type | Description/expected values |
name | String | Custom data (<255 chars) |
{
"name": "3nd year associates financial services"
}
Get the response (JSON output example)
{
"id": 31,
"name": "3nd year associates financial services",
"created_at": "2017-11-24T17:01:39.016Z",
"updated_at": "2017-11-24T17:05:55.390Z"
}