更新员工 - 探马OpenAPI

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

salesId

string

企微salesId

必需

对应企微，企业内必须唯一。长度为1~64个字节。只能由数字、字母和“_-@.”四种字符组成，且第一个字符必须是数字或字母。系统进行唯一性检查时会忽略大小写。

name

string

成员名称。

可选

长度为1~64个utf8字符

alias

string

成员别名。

可选

长度1~64个utf8字符

mobile

string

手机号码。

可选

企业内必须唯一。
如果该成员已登录过企业微信，需由成员自行修改手机号，通过接口无法修改（企微限制）

department

array[integer]

可选

成员所属部门id列表，不超过100个

email

string

邮箱。

可选

长度6~64个字节，且为有效的email格式。企业内必须唯一，mobile/email二者不能同时为空

is_leader_in_dept

array[integer]

表示在所在的部门内是否为部门负责人。

可选

个数必须和参数department的个数一致，表示在所在的部门内是否为部门负责人。1表示为部门负责人，0表示非部门负责人。在审批等应用里可以用来标识上级审批人

示例

{
    "salesId": "lisi111222",
    "name": "张",
    "alias": "jackzhang",
    "mobile": "13800000000",
    "department": [
        17133,
        17134
    ],
    "email": "zhangsan@gzdev.com",
    "isLeaderInDept": [
        1,
        0
    ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/api/v3/update-staff' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "salesId": "lisi111222",
    "name": "张",
    "alias": "jackzhang",
    "mobile": "13800000000",
    "department": [
        17133,
        17134
    ],
    "email": "zhangsan@gzdev.com",
    "isLeaderInDept": [
        1,
        0
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

示例：0

message

string

必需

示例：success

示例

{
    "code": 0,
    "message": "success"
}

⚪1000错误