グループに関する情報を取得するには、次の 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 | ユーザー グループを削除する権限がありません |