导出用户的所属组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 | 类型 | 内容 |
---|---|---|
groups | group类型数组 | 用户所属组的列表 |
{ "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的来宾用户不可访问。