探马OpenAPI

获取员工id

POST

/api/v3/common/user/info

通过外部唯一标识，获取探马内部员工id

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

以下参数任一查询条件满足即可

qwUserId

string

企微员工id

可选

mobile

string

手机号

可选

示例

{
  "qwUserId": "QingShanMuXue",
  "mobile": "1213134131313"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v3/common/user/info' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "qwUserId": "QingShanMuXue",
    "mobile": "1213134131313"
}'

返回响应

🟢200成功

application/json

Body

code

integer

业务状态码

必需

message

string

消息

必需

data

array [object {10}]

消息体

必需

userId

string

探马员工id

必需

qwUserId

string

企微员工id

必需

mobile

string

手机号

可选

name

string

名称

可选

enable

integer

探马后台启用禁用

可选

1启用，0禁用

avatar

string

头像

可选

position

string

职位

可选

corpid

string

公司id

可选

departmentList

string

部门id

可选

departmentName

string

部门名

可选

示例

成功示例异常示例

{
  "code": 0,
  "message": "success",
  "data": [
    {
      "userId": "470942800445824",
      "qwUserId": "v",
      "mobile": "18643659295",
      "name": "v",
      "enable": 1,
      "avatar": "https://wework.qpic.cn/wwpic/832582_sr3kN8XVT16I_eh_1649661934/0"
    }
  ]
}

修改于 2025-04-18 10:42:25

获取客户id

查询企业字段