# 获取基本信息

调试诊断

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

接口英文名：getAccountBasicInfo

调用本 API 可以获取小程序的基本信息，所属权限集为30。使用过程中如遇到问题，可在开放平台服务商专区发帖交流。

补充：该接口同适用于获取公众号基本信息，所属权限集为3；

# 1. 调用方式

# HTTPS 调用

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

# 云调用

• 本接口不支持云调用

# 第三方调用

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

• 该接口所属的权限集 id 为：3、30

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

# 2. 请求参数

# 查询参数 Query String parameters

# 请求体 Request Payload

无

# 3. 返回参数

# 返回体 Response Payload

# Res.wx_verify_info Object Payload

微信认证信息

# Res.signature_info Object Payload

功能介绍信息

# Res.head_image_info Object Payload

头像信息

# Res.nickname_info Object Payload

名称信息

# 4. 枚举信息

# Res.principal_type Enum

主体类型

# Res.realname_status Enum

实名验证状态

# Res.registered_country Enum

注册国家

# Res.customer_type Enum

认证类型；如果未完成微信认证则返回0；不同枚举值对应的类型说明看下方

# 5. 注意事项

• 创建账号时，实名验证状态会初始化为 2;对于注册方式为微信认证的账号，资质认证成功时，realname_status 会更新为 1
• 当 realname_status 不为 1 时，账号只允许调用以下 API（即无权限调用其他 API）：微信认证相关接口和 账号设置相关接口
• 组织类型小程序发布代码后不可改名，需走认证，所以如果发布后modify_used_count就是2；

# 6. 代码示例

请求示例

GET https://api.weixin.qq.com/cgi-bin/account/getaccountbasicinfo?access_token=ACCESS_TOKEN

返回示例

{
  "errcode": 0,
  "errmsg": "ok",
  "appid": "wx355c737061e52e03",
  "account_type": 3,
  "principal_type": 1,
  "principal_name": "深圳市xx计算机系统有限公司",
  "realname_status": 1,
  "wx_verify_info": {
    "qualification_verify": false,
    "naming_verify": false
  },
  "signature_info": {
    "signature": "美味助手",
    "modify_used_count": 0,
    "modify_quota": 5
  },
  "head_image_info": {
    "head_image_url": "http://wx.qlogo.cn/mmhead/Q3auHgzwzM6B72gFBvs0ViaE7RkqsAzp59QeMY0GphWAQiauhcG2sCCA/0",
    "modify_used_count": 0,
    "modify_quota": 5
  },
  "nickname": "美味助手",
  "registered_country": 1017,
  "nickname_info": {
    "nickname": "美味助手",
    "modify_used_count": 2,
    "modify_quota": 2
  },
  "credential": "91440xxxx08461136T",
  "customer_type": 0
}

# 7. 错误码

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

# 8. 适用范围

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