5.1 代开发应用设置迁移完成

POST

/cgi-bin/service/finish_openid_migration

服务商完成了代开发应用的新旧id（userid/corpid/external_userid)的迁移，即可主动将该企业设置为“迁移完成”，设置之后，该代开发应用获取到的将是升级后的id。注意，该接口需要使用provider_access_token来调用。

注意：
\1. 当该企业同时是服务商，并对自己授权的情况，无需调用本接口。
\2. 设置迁移完成后，接口不再吐出unionid。

注：
1.userid与corpid只能同时设置为升级模式，external_userid可以单独升级。
2.此接口还可为第三方应用设置迁移完成状态，若只传入正确corpid，未传入代开发应用agentid，则视为：更新该企业下同服务商所有第三方应用的对应升级状态。

权限说明：

该企业授权了该服务商代开发应用

请求参数

Query 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/service/finish_openid_migration?provider_access_token=ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{  
    "corpid":"xxxxx",
    "agentid":1111,
    "openid_type":[
        1,3
    ]
}'

响应示例

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

修改于 2025-09-22 08:57:00

3.2.2 转换客户群成员external_userid

5.2 代开发应用查询迁移状态