导出用户的所属组API

aki发表于:2019年11月14日 12:22:27更新于:2023年04月28日 15:32:30

导出用户的所属组API(JSON)

此API用于通过JSON格式获取用户的所属组。

HTTP 方法

GET

URI

https://(子域名).cybozu.cn/v1/user/groups.json

请求头部

头部值和说明
X-Cybozu-Authorization值为“登录名:密码”通过BASE64编码之后的字符。
Authorization使用Basic验证时,值为“Basic”和“登录名:密码”通过BASE64编码之后的字符。
// Sample    
X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=    
Authorization: Basic QWRtaW5pc3RyYXRvcjpjeWJvenU=

请求参数

参数名称类型必须说明
code字符串必须要获取其所属组列表的用户的code

通过HTTP的查询字符串发送参数

查询字符串
code=user1

包含请求头部的字符串

GET /v1/user/groups.json?code=user1 HTTP/1.1    
Host: example.cybozu.cn:443    
X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=    
Authorization: Basic QWRtaW5pc3RyYXRvcjpjeWJvenU=
  • Content-Type头部不需要。

应答

key类型内容
groupsgroup类型数组用户所属组的列表

 

{    
    "groups":[    
        {    
            "id": "1",    
            "code": "g1",    
            "name": "开发组",    
            "description": ""    
        },    
        {    
            "id": "7532782697181632513",    
            "code": "everyone",    
            "name": "Everyone",    
            "description": null    
        }    
    ]    
}

代码范例

用curl发送请求的范例 :

curl -X GET 'https://sample.cybozu.com/v1/user/groups.json?code=sato-noboru' \
 -H 'X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU='

访问权限

所有用户均可访问。

※kintone的来宾用户不可访问。