设置迁移完成

POST

https://qyapi.weixin.qq.com/cgi-bin/service/externalcontact/finish_external_userid_migration

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

当该企业同时是服务商，并对自己授权的情况，无需调用本接口。自授权应用不在此次回收范围之内。

权限说明：

该企业授权了该服务商第三方应用

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/service/externalcontact/finish_external_userid_migration' \
--header 'Content-Type: application/json' \
--data-raw '{
  "corpid":"xxxxx"
}'

响应示例

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

请求参数

Query 参数

provider_access_token

string

可选

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

示例值:

ACCESS_TOKEN

Body 参数application/json

corpid

string

企业corpid

必需

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

修改于 2022-12-05 08:50:32

转换客户群成员external_userid

4.1 升级之后的接口变化