グループに関する情報を取得するには、次の API メソッドを使用します。
get_group
既存のグループを返します。
GET index.php?/api/v2/get_group/{group_id}
パラメーター
| 名前 | タイプ | 必須 | 説明 |
|---|---|---|---|
| group_id | integer | true | グループの ID |
レスポンスの内容
{
"id": 1,
"name": "New group",
"user_ids": [1, 2, 3, 4, 5]
}
レスポンスには次のフィールドが含まれます。
| 名前 | タイプ | 説明 |
|---|---|---|
| id | integer | グループの一意の ID |
| name | string | グループの名前 |
| user_ids | array | ユーザー ID の配列。各 ID は、このグループに所属するユーザーです。 |
レスポンス コード
| ステータス コード | 説明 |
|---|---|
| 200 | 成功 (グループが取得されました) |
| 400 | 無効な group_id パラメーター |
get_groups
利用可能なグループのリストを返します。
GET index.php?/api/v2/get_groups
レスポンスの内容
{
"offset": 0,
"limit": 250,
"size": 0,
"_links": {
"next": null,
"prev": null,
},
"groups": [
{
"id": 1,
"name": "New group",
"user_ids": [1, 2, 3, 4, 5]
}
]
}
レスポンス コード
| ステータス コード | 説明 |
|---|---|
| 200 | 成功 (グループが取得されました) |
add_group
新しいグループを作成します。
POST index.php?/api/v2/add_group
リクエストの例
新しい空のグループを作成する方法を示す例については下記を参照してください。
{
"name": "New Group",
"user_ids": [1, 2, 3, 4, 5]
}
レスポンスの内容
成功した場合、このメソッドは get_group と同じレスポンス形式を使用して新しいグループを返します。
レスポンスには次のフィールドが含まれます。
| 名前 | タイプ | 説明 |
|---|---|---|
| name | string | グループの名前 |
| user_ids | array | ユーザー ID の配列。各 ID は、このグループに所属するユーザーです。 |
レスポンス コード
| ステータス コード | 説明 |
|---|---|
| 200 | 成功 (グループが作成されました) |
| 400 |
無効なフィールド値。user_ids 配列に無効な ID がある場合などです |
| 403 |
ユーザー グループを作成する権限がありません |
update_group
既存のグループを更新します。
POST index.php?/api/v2/update_group/{group_id}
パラメータ
| 名前 | タイプ | 必須 | 説明 |
|---|---|---|---|
| group_id | integer | true | グループの ID |
エンドポイントは add_group と同じフィールドをサポートしています。
update_group を使用すると、指定された user_ids 配列に合わせてグループのメンバーが設定されます。ユーザーを追加または削除することはできません。サブミットされた user_ids 配列は、必ずグループのユーザーの完全なリストでなければなりません。
レスポンスの内容
成功した場合、このメソッドは get_group と同じレスポンス形式を使用して新しいグループを返します。
レスポンス コード
| ステータス コード | 説明 |
|---|---|
| 200 | 成功 (グループが更新されました) |
| 400 | 無効なフィールド値。user_ids 配列に無効な ID がある場合などです |
| 403 | ユーザー グループを編集する権限がありません |
delete_group
既存のグループを削除します。
POST index.php?/api/v2/delete_group/{group_id}
パラメーター
| 名前 | タイプ | 必須 | 説明 |
|---|---|---|---|
| group_id | integer | true | グループの ID |
レスポンスの内容
このエンドポイントはグループ データを返しません。
レスポンス コード
| ステータス コード | 説明 |
|---|---|
| 200 | 成功 (グループが削除されました) |
| 400 | 無効な group_id |
| 403 | ユーザー グループを削除する権限がありません |