中文
Index
导入用户所属组织 API（JSON）
更新用户所属组织
导入用户所属组织 API（CSV）
此API用于把通过文件上传API上传的CSV文件作为用户的所属组织进行导入。
HTTP 方法
POST
URI
https://{sub-domain}.cybozu.cn/v1/csv/userOrganizations.json
请求头部
| 头部 | 值和说明 |
|---|---|
| X-Cybozu-Authorization | 值为“登录名:密码”通过BASE64编码之后的字符。 |
| Authorization | 使用Basic验证时，值为“Basic”和“登录名:密码”通过BASE64编码之后的字符。 |
| Content-Type | 指定为“application/json”。 ※不指定时，无法解析JSON ，执行时将报错。 |
// Sample X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU= Authorization: Basic QWRtaW5pc3RyYXRvcjpjeWJvenU= Content-Type: application/json
请求正文
| 参数值 | 要指定的值 | 必须 | 说明 |
|---|---|---|---|
| fileKey | 字符串 | 必须 | 指定用文件上传 API上传文件时返回的“fileKey”。 |
{
"fileKey": "c15b3870-7505-4ab6-9d8d-b9bdbc74f5d6"
}应答
应答中含有用确认结果API确认相应处理所需的处理结果ID 。
{
"id": 1
}CSV文件的格式
请参考用户所属组织信息CSV。
访问权限
仅cybozu.cn共通管理员可执行。
注意事项
CSV仅更新文件中记载的且跟系统中不一样的数据。 CSV中没有记载的用户，不会进行更新或删除处理。
如要删除所有记载了登录名的用户的所属组织，仅需要指定登录名。
导入用户所属组织 API（JSON）
更新用户所属组织
以JSON格式更新用户所属组织信息。
HTTP 方法
PUT
URI
https://（子域名）.cybozu.cn/v1/userOrganizations.json
请求头部
| 头部 | 值和说明 |
|---|---|
| X-Cybozu-Authorization | 值为“登录名:密码”通过BASE64编码之后的字符。 |
| Authorization | 使用Basic验证时，值为“Basic”和“登录名:密码”通过BASE64编码之后的字符。 |
| Content-Type | 指定为“application/json”。 ※不指定时，无法解析JSON ，执行时将报错。 |
// Sample X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU= Authorization: Basic QWRtaW5pc3RyYXRvcjpjeWJvenU= Content-Type: application/json
请求正文
对于 userOrganizations 属性，指定一个包含以下属性的对象。
| 参数名称 | 要指定的值 | 必须 | 说明 |
|---|---|---|---|
| code | 字符串 | 必须 | 登录名 128个字符或以下 |
| organizations | 数组 | 必须 | 用户所属组织信息列表 最多可指定 100 个。 更新用户的所属组织时，必须指定现有用户所属的所有 organizations。 organizations 中未指定的组织将从用户的所属组织中删除。 指定为空数组时，用户的所属组织变为未所属。 |
| organizations[].orgCode | 文字列 | 条件必须 | 組織コード组织代码 128个字符或以下 |
| organizations[].titleCode | 文字列 | 职务代码 128个字符或以下 |
请求正文范例
{
"userOrganizations" : [
{
"code" : "user1",
"organizations": [
{
"orgCode":"J_Sales",
"titleCode":"J_Manager"
}
]
},
{
"code" : "user2",
"organizations": [
{
"orgCode":"J_Sales",
"titleCode":"J_Chief"
},
{
"orgCode": "J_HR"
}
]
},
{
"code": "user3",
"organizations": []
}
]
}应答
成功时，返回以下应答。
{ }代码范例
用curl发送请求的范例 ：
curl -X PUT 'https://sample.cybozu.cn/v1/userOrganizations.json' \
-H 'X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=' \
-H 'Content-Type: application/json' \
-d '{
"userOrganizations": [
{
"code": "fei-chen",
"organizations": [
{
"orgCode": "Sales01",
"titleCode": "TeamLeader"
}
]
}
]
}'访问权限
只有 cybozu.cn 共通管理员 才能执行。
限制事项
CSV 对用户的所属组织更新和处理重叠时，应按写入顺序进行操作。
由于此 API 不锁定，因此不建议并行执行此 API 更新、CSV 导入和从通用页面处更新用户的操作。
