设置迁移完成

POST

http://127.0.0.1/cgi-bin/service/externalcontact/finish_external_userid_migration

第三方应用开发/开发指南/企业微信账号ID安全性全面升级/三、企业员工external_userid的升级方案

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

责任人：未设置

企业授权确认之后，且服务商完成了新旧external_userid的迁移，即可主动将该企业设置为“迁移完成”，设置之后，从该企业获取到的将是新的external_userid。注意，该接口需要使用provider_access_token来调用，对于有多个应用的服务商，可逐个应用进行external_userid的转换，最后再使用provider_access_token调用该接口完成设置。设置迁移完成之后，就不能为该企业再调用转换external_userid接口了。
权限说明：
该企业授权了该服务商第三方应用

请求参数

Query 参数

provider_access_token

string

必需

应用提供商的provider_access_token，获取方法参见服务商的凭证

示例值:

ACCESS_TOKEN

Body 参数application/json

corpid

string

企业corpid

必需

示例

{
  "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/service/externalcontact/finish_external_userid_migration?provider_access_token=ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "corpid": "xxxxx"
}'

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

示例

{
  "errcode": 0,
  "errmsg": "ok"
}

转换external_userid

4.2 unionid查询external_userid