[C021]资质证书可以返回哪些数据？

[C021]资质证书：该接口提供企业获得的证书信息，包括质量管理体系认证（ISO9001）、安全生产许可证等。完整响应结构请参见本页的响应结构与成功响应示例。

在哪里可以找到 [C021]资质证书的 OpenAPI schema？

OpenAPI schema 位于 /openapi.json#/paths/~1company~1qualification-certificate/post，也可在 /openapi.json 浏览完整规范。

[C021]资质证书

Q: [C021]资质证书 的接口地址是什么？

[C021]资质证书 的接口为 POST https://connect.zhihuiya.com/company/qualification-certificate。

post

https://connect.zhihuiya.com/company/qualification-certificate

在体验中心中试用

该接口提供企业获得的证书信息，包括质量管理体系认证（ISO9001）、安全生产许可证等

company_name、credit_code、org_number三者必填其一，同时填写则以credit_code 为准，其次org_number，最后以company_name为准。

请求参数

此 API 接口支持的参数列表

名称	类型	示例	描述
`company_name`	`string`	`小米科技有限责任公司`	查询企业名称，单个查询
`credit_code`	`string`	`91110108551385082Q`	查询企业的统一社会信用代码，单个查询
`org_number`	`string`	`5513850T82`	查询企业的组织机构代码，单个查询
`page_number` 必填	`integer<int32>`	`1`	默认第1页（1页最多20条，按发布日期降序返回，不足20条返回所有

响应结构

API 响应数据的结构说明

字段名	类型	示例	描述
`data`	`object`	-	响应数据
`org_number`	`string`	`572927506/57292750-6`	组织机构代码
`credit_code`	`string`	`91330424572927506D`	统一社会信用代码
`company_name`	`string`	`浙江新东方汽车零部件有限公司`	公司名称
`certificate_count`	`integer<int32>`	`1`	证书数量
`qualification_certificate`	`array`	`Please check the form: QualificationCertificate`	证书信息详情
`detail`	`array`	`Please check the form: CertificateDetail`	原始证书详情
`title`	`string`	`认证项目`	字段名称
`content`	`string`	`汽车行业质量管理体系认证`	字段内容
`cert_no`	`string`	`0380558`	证书编号
`end_date`	`string`	`20240111`	截止日期
`start_date`	`string`	`20210112`	发证日期
`certificate_name`	`string`	`汽车行业质量管理体系认证`	证书类型
`status` 必填	`boolean`	`false`	状态
`error_msg`	`string`	`The request parameter format is incorrect！`	错误信息
`error_code` 必填	`integer`	`0`	错误代码

成功响应示例

成功调用 API 的响应示例

JSON

{
  "data": {
    "org_number": "572927506/57292750-6",
    "credit_code": "91330424572927506D",
    "company_name": "浙江新东方汽车零部件有限公司",
    "certificate_count": 1,
    "qualification_certificate": [
      {
        "detail": [
          {
            "title": "认证项目",
            "content": "汽车行业质量管理体系认证"
          }
        ],
        "cert_no": "0380558",
        "end_date": 20240111,
        "start_date": 20210112,
        "certificate_name": "汽车行业质量管理体系认证"
      }
    ]
  },
  "status": true,
  "error_code": 0
}

错误码

此接口可能返回的错误码列表

业务错误码

错误码	描述
`68300004`	请求参数异常!
`68300005`	查询Api失败!
`68300006`	解析基本存取错误!
`68300007`	存在错误的请求!
`68300008`	服务中断异常，请稍后再试!
`68300010`	文件不符合上传规范!

平台错误码

错误码	描述
`67200001`	API整体限流错误!
`67200002`	用户调用请求限流限制错误!
`67200003`	申请token的key和secret不正确或者状态错误!
`67200004`	无权限或该接口的套餐已超过系统设置的上限!
`67200005`	账户余额不足，调用失败!
`67200006`	客户端已过期，调用失败!
`67200007`	超过调用额度，调用失败!

HTTP 状态码

状态码	描述
`0`	请求成功
`201`	Created
`401`	Unauthorized
`403`	Forbidden
`404`	Not Found
`68300012`	企业数据不存在