新增用户

新增用户

地址URL

https://api.es.xiaojukeji.com/river/Member/single

支持格式

Json

HTTP请求方式

POST

是否需要登录

是 关于登录授权,参见 如何登录授权

访问授权限制

暂无

请求参数

名称 类型 必选 描述
client_id string yes 申请应用时分配的AppKey
access_token string yes 授权后的access token
timestamp int yes 当前时间戳,精确到秒级
company_id bigint yes 企业ID
data string yes 员工数据json格式
sign string(32) yes 签名

员工信息(data对应数组中每条记录中字段)

名称 类型 必选 描述
phone string yes 员工手机号
realname string yes 员工姓名(最多32个字符)
employee_number string no 员工ID(员工在公司的员工号)(最多32个字符)
email string no 邮箱
department string no 部门名称(老),后续此参数会去掉
branch_name string no 所在分公司名称(老),后续此参数会去掉
system_role int no 系统角色(0-车辆预定人员,1-普通管理员,2-超级管理员;默认为0)
role_ids string no 角色(默认为员工),通过角色获取API 。可以填多个,以_分隔。初始管理员、主管不支持新增
immediate_superior_phone string no 员工直属上级的手机号码(需为本企业中已存在账号),直属上级可在审批流中担任审批人
residentsname string no 常驻地中文,可通过城市查询接口获得地级市名称
use_company_money int no 是否企业支付余额(0-否,1-是,默认为0)
total_quota string no 每月配额
is_remark int no 叫车时备注信息是否必填(0-选填,1-必填,2-按制度填写;默认为0)
budget_center_id bigint no 所在部门ID(新),默认为1(企业)。通过成本中心查询api获取id(类型为1)
regulation_id string no 用车制度ID(从 9.1用车制度查询 中选取,可以填多个,以_分隔,如 123_456_789)注:如不传用车制度ID,无法使用企业支付
project_ids string no 所在项目ID(新)。可以填多个,以_分隔。通过成本中心查询api获取id(类型为2)

注意事项

1、参数data为json字符串格式(传参时,data中的中文字符必须进行unicode编码,data外的参数不需要unicode编码,后面有具体示例),如:

{"phone":"18611869995","realname":"\u5f20\u4e09","employee_number":"","email":"dys@didichuxing.com","department":"QA","branch_name":"TEST","system_role":0,"use_company_money":1,"total_quota":10000,"is_remark":0,"regulation_id":"5489198484344538189_5489709520894035023"}

2、常驻地目前只支持如“北京”、“北京市”、“北京市海淀区”格式,不支持“海淀区”此类格式,如果传参中带了区县则必须把“市”、“区“、”县”字段都带上。

返回值

返回值字段 字段类型 字段说明
errno int 0表示成功,非0表示失败
errno string errno=0时为常量"SUCCESS",errno!=0时为错误信息
data object 返回值对象
id bigint 员工在滴滴企业平台的ID
phone string 员工手机号

请求及返回示例

请求参数

client_id = "client_id_test", "access_token" = "access_token_test", timestamp = "1565875844", company_id = "12345678980"
data原始值:phone = 11000001234, realname = "张三", employee_number = "D123456", email = "1234@test.com"
data转换为json串后为(注意中文字):{"phone":11000001234,"realname":"\u5f20\u4e09","employee_number":"D123456","email":"1234@test.com"}
sign_key = "sign_key_test"

计算签名

加密前的字符串:access_token=access_token_test&client_id=client_id_test&company_id=12345678980&data={"phone":11000001234,"realname":"\u5f20\u4e09","employee_number":"D123456","email":"1234@test.com"}&sign_key=sign_key_test&timestamp=1565875844
计算得到的签名:sign = md5("access_token=access_token_test&client_id=client_id_test&company_id=12345678980&data={"phone":11000001234,"realname":"\u5f20\u4e09","employee_number":"D123456","email":"1234@test.com"}&sign_key=sign_key_test&timestamp=1565875844") = 7473eb9bff6e1aa352dd2e433ed1924a

发送请求

curl -X POST -H "content-type:application/json" \
-d '{"client_id":"client_id_test","access_token":"access_token_test","timestamp":"1565875844","company_id":"12345678980","data":"{\"phone\":\"11000001234\",\"realname\":\"\u5f20\u4e09\",\"employee_number\":\"D123456\",\"email\":\"1234@test.com\"}","sign":"7473eb9bff6e1aa352dd2e433ed1924a"}' \
https://api.es.xiaojukeji.com/river/Member/single

返回值

{
    "errno": 0,
    "errmsg": "SUCCESS",
    "data": {
        "id": 1125904406565093,
        "phone": "19811110001"
    }
}

results matching ""

    No results matching ""