# 个微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"
}'