# 个微unionid+openid转换企微客户external_user_id

  • 当前授权企微的企业必须已认证或已验证。
  • 微信开放平台账号主体与小程序或服务号账号主体需要认证,且主体名称需与当前授权企业的主体名称一致。
  • openid与unionid必须是在同一个小程序或同一个公众号获取到的。

接口调用频率限制

每分钟/次
200

企微转换频率限制

每小时/次 每天/次 每月/次
40000 150000 4000000

请求方式:POST

请求地址:https://$basehost/gateway/eaopen/ConvertUnionIdToExternalUserId

body参数

{
    "union_id": "owSkl6L1oS6vzx8UmsC1tq123456",
    "open_id": "orzNI6MBWsXGraTvkXJ-SO123456"
}
字段 类型 必填 说明
union_id string 小程序/公众号用户的unionid
open_id string 小程序/公众号用户的openid

返回值:

{
    "data": {
        "external_user_id": "wmfd4MDAAAqbtlmlLXjoNjj6TY123456"
    },
    "errcode": 0,
    "errmsg": "",
    "hint": "vwS9S99xyhcjaANddysA"
}

返回说明

字段 类型 说明
data.external_user_id string 企微客户external_user_id,未加好友则为空
errcode int 状态码,0为正常,非0代表错误
errmsg string 错误信息
hint string 请求日志ID

完整请求示例:

curl -X POST https://$basehost/gateway/eaopen/ConvertUnionIdToExternalUserId \
     -H 'Content-Type: application/json; charset=UTF-8' \
     -H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
     -d '{
             "union_id": "owSkl6L1oS6vzx8UmsC1tq123456",
             "open_id": "orzNI6MBWsXGraTvkXJ-SO123456"
         }'
最后更新时间: 2023/6/26 10:38:50