[C018]上市信息可以返回哪些数据？

[C018]上市信息：该接口提供企业的上市信息，包括股票代码，上市时间，交易所，上市板块等。完整响应结构请参见本页的响应结构与成功响应示例。

在哪里可以找到 [C018]上市信息的 OpenAPI schema？

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

[C018]上市信息

Q: [C018]上市信息 的接口地址是什么？

[C018]上市信息 的接口为 POST https://connect.zhihuiya.com/company/listing-Information。

post

https://connect.zhihuiya.com/company/listing-Information

在体验中心中试用

该接口提供企业的上市信息，包括股票代码，上市时间，交易所，上市板块等

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

请求参数

此 API 接口支持的参数列表

名称	类型	示例	描述
`company_name`	`string`	`小米科技有限责任公司`	查询企业名称，单个查询
`credit_code`	`string`	`91110108551385082Q`	查询企业的统一社会信用代码，单个查询
`org_number`	`string`	`5513850T82`	查询企业的组织机构代码，单个查询

响应结构

API 响应数据的结构说明

字段名	类型	示例	描述
`data`	`object`	-	响应数据
`org_number`	`string`	`722088964/72208896-4`	组织机构代码
`credit_code`	`string`	`914200007220889600`	统一社会信用代码
`company_name`	`string`	`中航工业机电系统股份有限公司`	公司名称
`listing_information`	`array`	`Please check the form: ListingInformation`	上市数据详情
`exchange`	`string`	`深圳交易所`	交易所
`bond_code`	`string`	`002013`	股票代码
`bond_name`	`string`	`中航机电`	股票简称
`bond_type`	`string`	`主板`	上市板块
`bond_label`	`string`	`A股`	股票标签
`english_name`	`string`	`AVIC Electromechanical Systems Co., Ltd.`	英文名称
`listing_date`	`string`	`20040705`	上市日期
`delisting_date`	`string`	`20230317`	终止上市日期
`status` 必填	`boolean`	`false`	状态
`error_msg`	`string`	`The request parameter format is incorrect！`	错误信息
`error_code` 必填	`integer`	`0`	错误代码

成功响应示例

成功调用 API 的响应示例

JSON

{
  "data": {
    "org_number": "722088964/72208896-4",
    "credit_code": 914200007220889600,
    "company_name": "中航工业机电系统股份有限公司",
    "listing_information": [
      {
        "exchange": "深圳交易所",
        "bond_code": "002013",
        "bond_name": "中航机电",
        "bond_type": "主板",
        "bond_label": "A股",
        "english_name": "AVIC Electromechanical Systems Co., Ltd.",
        "listing_date": 20040705,
        "delisting_date": 20230317
      }
    ]
  },
  "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`	企业数据不存在