# 获取证件类型
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
queryIcpCertificateTypes
# 功能描述
使用该接口获取证件类型定义。使用过程中如遇到问题,可在开放平台服务商专区发帖交流
# 注意事项
- 该接口返回的结果会不定期更新,切勿对某一次调用的返回结果长期保存或硬编码。
- 证件类型与单位性质存在关联,例如:个人的证件类型有居民身份证、护照,而企业则不存在这两类证件。接口返回的证件列表中会带有
subject_type
字段指示该证件属于哪种单位,例如:政府机关的单位性质 id 为 2,那么政府机关可选的证件类型仅有subject_type
为 2 的“统一社会信用代码证书”以及“组织机构代码证”。
# 调用方式
# HTTPS 调用
GET https://api.weixin.qq.com/wxa/icp/query_icp_certificate_types?access_token=ACCESS_TOKEN
# 第三方调用
调用方式以及出入参和HTTPS相同,仅是调用的token不同
该接口所属的权限集id为:18、156
服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用
# 请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用authorizer_access_token |
# 返回参数
属性 | 类型 | 说明 | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
errcode | number | 错误码 | |||||||||||||||||||||
errmsg | string | 错误信息 | |||||||||||||||||||||
items | array<object> | 证件类型列表 | |||||||||||||||||||||
|
# 调用示例
示例说明: 查询成功示例
# 请求数据示例
curl https://api.weixin.qq.com/wxa/icp/query_icp_certificate_types?access_token=ACCESS_TOKEN
# 返回数据示例
{
"errcode": 0,
"errmsg": "ok",
"items": [
{
"type": 1,
"subject_type": 4,
"name": "营业执照(个人或企业)"
},
{
"type": 2,
"subject_type": 5,
"name": "居民身份证"
},
......
]
}
# 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
0 | ok | ok |
-1 | system error | 系统繁忙,此时请开发者稍候再试 |