查询 IDMap

GEThttps://open.teambition.com/api/idmap/query

该接口用于根据条件查询 IDMap 信息。

常见的 refer 类型：

dingTalk-app 钉钉应用

dingTalk-corp 钉钉企业

dingTalk-team 钉钉部门

dingTalk-user 钉钉用户

dingTalk-task 钉钉任务

dingTalk-project钉钉项目

weixin-corp 微信企业

weixin-team 微信部门

weixin-user 微信用户

请求参数

Header 参数

Content-Type

string

可选

示例值:

application/json

tbId

string

可选

tb方的被绑定 id，对应的对象依照 refer 字段而不同

refId

string

可选

绑定关系标识符，比如钉钉企业的 Corpid

refer

string

可选

绑定的类型： "-user": tbId 对应用户userId； "-team": tbId 对应部门 teamId； "*-corp": tbId 对应企业 orgId；以此类推

extraUserId

string

可选

tb 方绑定的 id，比如钉钉平台返回的 userid

{
  "extraUserId": "51",
  "tbId": "83",
  "refer": "ex do reprehenderit aliqua esse",
  "refId": "43"
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

code

integer

必需

返回码，200 表示成功

errorMessage

string

必需

调用失败时的错误信息

result

object

必需

用户 IDMap 信息

extra

object

必需

第三方信息，返回对象内参数不统一，根据实际需求查看返回值

string

IDMap ID

必需

refId

string

绑定关系 ID

必需

refer

string

绑定关系

必需

tbId

string

绑定的 tbId

必需

{
  "code": 200,
  "errorMessage": "",
  "result": {
    "extra": {},
    "id": "5923d04bcc...",
    "refId": "team_2_2",
    "refer": "test-team",
    "tbId": "5923d04baad..."
  }
}

最后修改时间： 2 年前