Domoscio Docs

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
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.\\

{{ :api2:student:student_group.png?600 |Student Groups}}


===Object resources===
^ Property     ^ Type      ^ Description         ^
| name    | String     | Custom data        |

===Create (POST)===

^ Method | POST |
^ URL | /student_groups |

==Parameters (*Requiered parameters)==

^ Property     ^ Type      ^ Description         ^
| name    | String     | Custom data        |

==Send the request (JSON input example)==

<code>
{
	name : "2nd year associates financial services"
}
</code>

==Get the response (JSON output example)==

<code>
{
	id: 1,
	name: "2nd year associates financial services"
}
</code>

===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**\\

<code>
{
	id: 1,
	name: "2nd year associates financial services"
}
</code>

**Without ID provided**\\
<code>
[{
	id: 1,
	name: "2nd year associates financial services"
},
{
	id: 2,
	name: "senior associates financial services"
}]
</code>


===EDIT (PUT)===

^ Method | PUT |
^ URL | /student_groups/{student_group_id} |

==Editable parameters==

^ Property ^ Type ^ Description/expected values |
| name | String | Custom data (<255 chars) |

==Send the request (JSON input example)==

<code>
{
	name : "No more 2nd year associates financial services"
}
</code>

==Get the response (JSON output example)==

<code>
{
	id: 1,
	name: "No more 2nd year associates financial services"
}
</code>
Domoscio Docs

User Tools

Site Tools

Page Tools
