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

POST

https://qyapi.weixin.qq.com/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，则视为：更新该企业下同服务商所有第三方应用的对应升级状态。

权限说明：

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

请求示例

Shell

JavaScript

Java

Swift

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

响应示例

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

请求参数

Query 参数

provider_access_token

string

可选

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

示例值:

ACCESS_TOKEN

Body 参数application/json

corpid

string

企业corpid

必需

agentid

integer

企业代开发应用id

必需

openid_type

array[integer]

必需

id类型：1-userid与corpid; 3-external_userid

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

修改于 2022-12-05 03:29:47

3.2.2 转换客户群成员external_userid

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