上下游企业应用获取微信用户的external_userid

POST

http://127.0.0.1/cgi-bin/corpgroup/unionid_to_external_userid

企业内部开发/上下游

最后修改时间：2022-08-30 03:03:35

责任人：未设置

external_userid的说明
external_userid是企业微信用于表示企业的外部联系人而设立的id，且满足以下条件
假设同一个微信用户属于多个下游企业的外部联系人
1.同一上游企业获取到不同企业的外部联系人的external_userid不一致。
2.不同一上游企业获取同一个企业的同一个外部联系人的external_userid也不一致。

通过unionid和openid查询external_userid

权限说明：
调用该接口的应用必须是上下游共享的应用
unionid（unionid的主体为绑定了该小程序的微信开放平台账号主体）和openid（即小程序账号主体）的主体需与当前企业的主体一致。
openid与unionid必须是在同一个小程序获取到的
调用频率最大为10000次/小时

请求参数

Query 参数

access_token

string

必需

应用的access_token

示例值:

ACCESS_TOKEN

Body 参数application/json

unionid

string

必需

微信客户的unionid

openid

string

必需

微信客户的openid

corpid

string

可选

需要换取的企业corpid，不填则拉取所有企业

示例

{
  "unionid": "xxxxx",
  "openid": "xxxxx",
  "corpid": "xxxxx"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://127.0.0.1/cgi-bin/corpgroup/unionid_to_external_userid?access_token=ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "unionid": "xxxxx",
    "openid": "xxxxx",
    "corpid": "xxxxx"
}'

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

external_userid_info

array [object {2}]

必需

该unionid对应的外部联系人信息

corpid

string

所属企业id

必需

external_userid

string

外部联系人id

必需

示例

{
  "errcode": 0,
  "errmsg": "ok",
  "external_userid_info": [
    {
      "corpid": "AAAAA",
      "external_userid": "BBBB"
    },
    {
      "corpid": "CCCCC",
      "external_userid": "DDDDD"
    }
  ]
}

获取下级/下游企业小程序session

获取会话内容获取机器人信息