| 服务地址 | ahpp.zoneland.net:20030/x_program_c… | |
| 调用方式 | HTTP | |
| 调用方法 | POST | |
| 请求报文Content-Type | application/json; charset=utf-8 | |
| 响应报文Content-Type | application/json; charset=utf-8 |
本服务对应组织的增删改查操作,通过传请求报文的action参数进行对应的操作:
| 参数 | 执行操作 |
|---|---|
| add | 新增组织 |
| update | 修改组织 |
| delete | 删除组织 |
如:删除组织的请求报文可以为
{
"action": "delete", //删除组织
"flag" : "" //组织标志
}
一、新增组织
请求报文
{
"action":"add",
"name":"", //名称,可以重名.
"unique":"", //唯一标识,不可重复,为空则使用自动填充值
"distinguishedName":"", //识别名.以@U结尾.
"typeList":"", //组织类型.
"description":"", //描述.
"shortName":"", //组织简称。
"superior":"", //上级组织.
"orderNumber":"", //排序号,升序排列,为空在最后
"controllerList":"", //组织的管理人员.
"dingdingId":"", //钉钉部门ID.
"dingdingHash":"", //钉钉部门哈希特征.
"qiyeweixinId":"", //企业微信人员ID.
"zhengwuDingdingId":"", //政务钉钉人员ID.
"zhengwuDingdingHash":"", //政务钉钉人员哈希特征.
"qiyeweixinHash":"", //企业微信人员哈希特征.
"attributeList" : [ //组织属性
{
description:"", //描述.
name:"", //名称,不可重名.
unique:"", //唯一标识,不可重复,为空则使用自动填充值
distinguishedName:"", //识别名,自动填充,@UA结尾.
orderNumber:"", //排序号,升序排列,为空在最后
value:"", //属性值,多值.
}
...
],
"dutyList" : [ //组织职务
{
description:"", //描述.
name:"", //名称,同一组织下不可重名.
unique:"", //唯一标识,不可重复,为空则使用自动填充值
distinguishedName:"", //识别名,自动填充,@UD结尾.
orderNumber:"", //排序号,升序排列,为空在最后
value:"", //组织职务身份成员,多值.
}
...
]
}
| 属性 | 上级 | 类型 | 单值/多值 | 说明 | 样例 |
|---|---|---|---|---|---|
| action | string | single | add | ||
| name | string | single | 名称,可重名. | 技术支持 | |
| unique | string | single | 唯一标识,不可重复,为空则使用自动填充值 | 1000263571 | |
| distinguishedName | string | single | 识别名.如果未空系统自动填充.以@U结尾. | 技术支持@1000263571@U | |
| typeList | array | multi | 组织类型. | [ "部门" ] | |
| description | string | single | 描述. | ||
| shortName | string | single | 组织简称。 | ||
| levelName | string | single | 显示的层级名. | 安徽联通/技术支持 | |
| superior | string | single | 上级组织标志位,可以为组织唯一编码unique/组织的distinguishedName/组织id | "companyLeader/"公司管理层@9b45cb75-52f8-4e73-8470-4cdc78230b7d@U"/9d14f85a-27ba-4e02-b4ef-4ebfcf3f19c0 | |
| orderNumber | number | single | 排序号,升序排列,为空在最后 | 20 | |
| controllerList | array | multi | 组织的管理人员的.distinguishedName 、unique 、employee或mobile | ["138000000"] | |
| dingdingId | string | single | 钉钉部门ID. | ||
| dingdingHash | string | single | 钉钉部门哈希特征. | ||
| qiyeweixinId | string | single | 企业微信人员ID. | ||
| zhengwuDingdingId | string | single | 政务钉钉人员ID. | 1000263571 | |
| zhengwuDingdingHash | string | single | 政务钉钉人员哈希特征. | 8ecfc82b45c5d33be7f84599b265e4fffb56108c0f8f85bde7856e01521a7d0b | |
| qiyeweixinHash | string | single | 企业微信人员哈希特征. | ||
| attributeList | array | single | 组织属性列表 | ||
| name | attributeList | string | multi | 名称,不可重名. | 组织属性 |
| description | attributeList | string | single | 描述. | |
| distinguishedName | attributeList | string | single | 识别名,自动填充,@UA结尾. | 组织属性@e762a4df-44ce-418c-bb20-899558b49622@UA |
| unique | attributeList | string | single | 唯一标识,不可重复,为空则使用自动填充值 | e762a4df-44ce-418c-bb20-899558b49622 |
| value | attributeList | string/array | multi | 属性值,多值. | ["组织属性值"] |
| orderNumber | attributeList | string | single | 排序号,升序排列,为空在最后 | 112345 |
| dutyList | array | multi | 组织职务 | ||
| name | dutyList | string | single | 名称,同一组织下不可重名. | 部门领导 |
| description | dutyList | string | single | 描述 | |
| unique | dutyList | string | single | 唯一标识,不可重复,为空则使用自动填充值 | 7a1b7021-8812-4d18-9447-6b27ce7454ed |
| distinguishedName | dutyList | string | single | 识别名,自动填充,@UD结尾. | 部门领导@7a1b7021-8812-4d18-9447-6b27ce7454ed@UD |
| orderNumber | dutyList | string | single | 排序号,升序排列,为空在最后 | 排序号,升序排列,为空在最后 |
| value | dutyList | aray | multi | 组织职务身份成员,多值.可以是人员的.distinguishedName 、unique 、employee或mobile | ["张三@fb3ea7de-d54f-4679-8e9a-35cb1e6b3d01@P","P0780","13800000000","fb3ea7de-d54f-4679-8e9a-35cb1e6b3d01"] |
响应报文
{
"data": {
"value": {
"id" : "", //如果成功,组织64位id
"distinguishedName: "", //如果成功,组织识别名
"result" : "", //响应成功为 success, 失败为error
"description": "" //响应结果描述
}
}
}
二、删除组织
请求报文
{
action : "delete",
distinguishedName : "", //识别名,@P结尾.
unique : "", //唯一标识
}
说明:distinguishedName 、unique 用来查找组织,其中一项不为空即可
响应报文
{
"data": {
"value": {
"result" : "", //响应成功为 success, 失败为error
"description": "" //响应结果描述
}
}
}