# 转换openid

调试诊断

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南

接口英文名：changeopenid

该接口用于公众号、服务号之后进行 openid 转换。

# 应用场景

公众号/服务号账号迁移后，关注用户的 openid 会变化，微信用户关注不同的公众号或服务号，对应的openid是不一样的，迁移成功后，关注用户的openid 以目标账号（即新账号）对应的 openid 为准。原账号非个人主体的，可以通过当前接口转换openid。

# 接口用途

当账号迁移后，可以通过该接口：

1. 将原账号关注用户的openid转换为新账号的openid。
2. 将有授权关系用户的openid转换为新账号的openid。
3. 将卡券关联用户的openid转换为新账号的openid。

# 名词解释

• 原账号：准备要迁移的账号，当审核完成且管理员确认后即被回收。
• 新账号：用来接纳关注用户的账号。新账号在整个流程中均能正常使用。

# 注意

1. 原账号为个人主体的，不支持使用该接口进行。
2. 一定要在原账号被冻结之前，最好是准备提交审核前，获取原账号的用户列表。如果没有原账号的用户列表，用不了转换工具。如果原账号被回收，这时候也没办法调用接口获取用户列表。
3. 转换openid的API接口如下，可在账号迁移审核完成后开始调用，并最多保留15天。若账号迁移没完成，调用时无返回结果或报错。账号迁移15天后，该转换接口将会失效、无法拉取到数据。

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/cgi-bin/changeopenid?access_token=ACCESS_TOKEN

# 云调用

• 本接口不支持云调用

# 第三方调用

• 本接口支持第三方平台使用 component_access_token 自己调用，同时还支持代商家调用。

• 服务商获得任意权限集授权后，即可通过使用 authorizer_access_token 代商家进行调用，具体可查看 第三方调用 说明文档。

# 2. 请求参数

# 查询参数 Query String parameters

# 请求体 Request Payload

# 3. 返回参数

# 返回体 Response Payload

# Res.result_list(Array) Object Payload

openid结果列表

# 4. 注意事项

本接口无特殊注意事项

# 5. 代码示例

请求示例

{
    "from_appid": "gh_91ae50dfeb1c",
    "openid_list": "[\"oEmYbwN-n24jxvk4Sox81qedINkQ\",\"oEmYbwH9uVd4RKJk7ZZg6S zL6tTo\"]"
}

返回示例

{
    "errcode": 0,
    "errmsg": "",
    "result_list": [
        {
            "ori_openid": "oEmYbwN-n24jxvk4Sox81qedINkQ",
            "new_openid": "o2FwqwI9xCsVadFah_HtpPfaR-X4",
            "err_msg": "ok"
        }
    ]
}

# 6. 错误码

以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。

# 7. 适用范围

该接口用于公众号、服务号之后进行 openid 转换，并且在账号迁移审核完成后开始调用，并最多保留15天。若账号迁移没完成，调用时无返回结果或报错。账号迁移15天后，该转换接口将会失效、无法拉取到数据。