知方号

知方号

钉钉二次开发<钉钉单点登陆地址不存在>

钉钉二次开发

建用户

 

调试工具:在线调试

请求方式:POST(HTTPS)

请求地址:https://oapi.dingtalk.com/user/create?access_token=ACCESS_TOKEN

请求包结构体:

{ "userid": "zhangsan", "name": "张三", "orderInDepts" : "{1:10, 2:20}", "department": [1,2], "position": "产品经理", "mobile": "1xxxxxxxxxx", "tel" : "xxxx-xxxxxxxx", "workPlace" :"", "remark" : "", "email": "test@xxx.com", "orgEmail": "test@xxx.com", "jobnumber": "xxx", "isHide": false, "isSenior": false, "extattr": { "爱好":"旅游", "年龄":"24" }}

 

参数说明:

参数

类型

必须

说明

access_token

String

调用接口凭证

userid

String

员工在当前企业内的唯一标识,也称staffId。可由企业在创建时指定,并代表一定含义比如工号,创建后不可修改,企业内必须唯一。

长度为1~64个字符,如果不传,服务器将自动生成一个userid。

name

String

成员名称。

长度为1~64个字符

orderInDepts

JSONObject

在对应的部门中的排序,

Map结构的json字符串,key是部门的id, value是人员在这个部门的排序值

department

List

数组类型,数组里面值为整型,成员所属部门id列表

position

String

职位信息。

长度为0~64个字符

positionInDepts

JSONObject

设置用户在每个部门下的职位。

Map结构的json字符串,

Map的Key是deptId,表示部门id,

Map的Value是职位,表示在这个部门下的职位

mobile

String

手机号码,企业内必须唯一,不可重复。如果是国际号码,请使用+xx-xxxxxx的格式

tel

String

分机号,长度为0~50个字符,企业内必须唯一,不可重复

workPlace

String

办公地点,长度为0~50个字符

remark

String

备注,长度为0~1000个字符

email

String

邮箱。长度为0~64个字符。企业内必须唯一,不可重复

orgEmail

String

员工的企业邮箱,员工的企业邮箱已开通,才能增加此字段, 否则会报错

jobnumber

String

员工工号。对应显示到OA后台和客户端个人资料的工号栏目。

长度为0~64个字符

isHide

Boolean

是否号码隐藏。true表示隐藏,false表示不隐藏。

隐藏手机号后,手机号在个人资料页隐藏,但仍可对其发DING、发起钉钉免费商务电话。

isSenior

Boolean

是否高管模式。true表示是,false表示不是。

开启后,手机号码对所有员工隐藏。普通员工无法对其发DING、发起钉钉免费商务电话。高管之间不受影响。

extattr

JSONObject

扩展属性,可以设置多种属性(手机上最多显示10个扩展属性,具体显示哪些属性,请到OA管理后台->设置->通讯录信息设置和OA管理后台->设置->手机端显示信息设置)。

该字段的值支持

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至lizi9903@foxmail.com举报,一经查实,本站将立刻删除。