# 创建开放平台账号

调试诊断

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

接口英文名:createOpenAccount

  • 该 API 用于创建一个开放平台账号,并将一个尚未绑定开放平台账号的公众号/小程序绑定至该开放平台账号上。
  • 新创建的开放平台账号的主体信息将设置为与之绑定的公众号或小程序的主体。使用过程中如遇到问题,可在开放平台服务商专区发帖交流。

# 1. 调用方式

# HTTPS 调用

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

# 云调用

  • 本接口不支持云调用

# 第三方调用

  • 本接口支持第三方平台代商家调用。

  • 该接口所属的权限集 id 为:24-25

  • 服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代商家进行调用,具体可查看 第三方调用 说明文档。

# 2. 请求参数

# 查询参数 Query String parameters

参数名类型必填说明
access_tokenstring接口调用凭证,可使用 authorizer_access_token

# 请求体 Request Payload

参数名类型必填说明
appidstring非必填,如果不填则取生成authorizer_access_token的授权公众号或小程序的 appid。如果填,则需要填与生成authorizer_access_token的授权公众号或小程序的 appid一致的appid,否则会出现40013报错。

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明
open_appidstring所创建的开放平台账号的 appid
errcodenumber错误码
errmsgstring错误信息

# 4. 注意事项

  • 创建的open账号是未认证状态;对于未认证主体,相同主体最多只能绑定 5 个小程序,异主体不支持绑定;
  • 商家可以按照指引完成账号的认证,详情可查看如何认证通过api创建的开放平台账号
  • 不支持用试用小程序创建open账号。

# 5. 代码示例

请求示例

{
    "appid": ""
}

返回示例

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

# 6. 错误码

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

错误码错误描述解决方案
-1system error系统繁忙,此时请开发者稍候再试
0okok
40001invalid credential  access_token isinvalid or not latest获取 access_token 时 AppSecret 错误,或者 access_token 无效。请开发者认真比对 AppSecret 的正确性,或查看是否正在为恰当的公众号调用接口
40013invalid appid不合法的 AppID ,请开发者检查 AppID 的正确性,避免异常字符,注意大小写
89000account has bound openaccount has bound open,该公众号/小程序已经绑定了开放平台帐号
89001not same contractornot same contractor,Authorizer 与开放平台帐号主体不相同

# 7. 适用范围

本接口支持「第三方平台」账号类型代调用,权限集请参考「调用方式」部分。其他账号类型如无特殊说明,均不可调用。