查詢分組
基本信息
GET /api/v1/group/list
介面描述:查詢分組訊息,分組資訊包括分組ID和分組名稱,其中分組ID用於新增帳號時給帳號分組,分組ID為0是系統建立的預設分組
請求參數
Query 非必需參數可以不傳遞
參數名稱 | 必需 | 默認值 | 示例 | 說明 |
---|---|---|---|---|
group_name | 否 | - | group1 | 指定分組名稱查詢分組,預設空查所有分組 |
page | 否 | 1 | 1 | 頁碼預設1第一頁 |
page_size | 否 | 1 | 10 | 每頁條數默認1條,最大2000 |
返回數據
//執行成功
{
"code": 0,
"data": {
"list": [
{
"group_id": "100", //分組ID,新增帳號時需要
"group_name": "group1" //分組名稱
"remark": "xxxx" //分組備註
},
{
"group_id": "101",
"group_name": "group2"
"remark": "xxxx" //分組備註
}
],
"page": 1,
"page_size": 10
},
"msg": "Success"
}
//執行失敗
{
"code":-1,
"data":{},
"msg":"failed"
}