ページを選択

グループ

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