文因云

文档与支持

公告提取API

一:产品说明

公告数据API支持对主板上市企业的企业信息公告事件的查询,用户可以通过发送HTTP请求访问, 各类数据会以JSON的格式返回给用户。

二:授权说明

  • 阿里云市场授权:本授权适合于在阿里云市场有账号的用户,在阿里云市场购买产品即可获得授权。推荐使用阿里云调用API。商品连接
  • 自主开发授权:通过token授权,token价格,调用地址,具体购买方式请发送邮件到:cloudservice@memect.co 电话号码:13146982978。调用API时通过header传递token
curl 'https://example.memect.cn /v1/data/company/000961/announce?class=中标事件' -H
 'token: <your token>'

三:主要功能

目前仅提供中标事件类的查询,后续会逐步增加种类,敬请关注。

四:API详情

1 API请求格式

GET /v1/data/company/{company_code}/announce

支持的参数如下:

参数类型描述
classstring表示应该返回该公司哪一种类型的公告数据。该参数可选,如果为空则表示返回公司的所有类型公告数据。目前支持以下字段:
中标事件:中标事件类公告的数据
periodstring表示应该返回哪个时间段的公告数据。该参数可选,如果为空,则表示返回公司最近一个月的公告数据。支持如下形式的时间段格式:
week:表示返回公司最近一周的公告数据
month:表示返回公司最近一个月的公告数据
year:表示返回公司最近一年的公告数据
YYYYMMDD-YYYYMMDD:表示返回公司这两个时间段之间的公告数据

2 请求示例

GET /v1/data/company/000961/announce?class=中标事件

会返回代码为000961公司最近一个月的中标事件类公告数据

[
  {
    "项目名称": "日照科技创新中心PPP项目",
    "项目周期": "合作期限为15年,其中建设期2年",
    "招标机构": "日照市高新技术产业开发区招商促进局",
    "中标金额": "总投资约154,191万元",
    "发布日期": "2017-08-24"
  }
]

请求:

GET /v1/data/company/000001/announce?class=中标事件&period=week

会返回代码为000001公司最近一周的中标事件类公告数据

请求

GET /v1/data/company/000001/announce?class=中标事件&period=year

会返回代码为000001公司最近一年的中标事件类公告数据

GET /v1/data/company/000001/announce?class=中标事件&period=20171007-20171114

会返回代码为000001公司2017-10-07至(含)2017-11-14期间的 中标事件类公告数据

五:客户端错误代码

如果一切顺利,服务器返回的HTTP状态码为200 OK。但是人生中总是充满了意外,服务器也一样。 如果遇到异常,不要惊慌,请仔细阅读如下错误代码。

  • 400 Bad Request

表示HTTP请求的参数无效,比如请求了不存在的{field},或者参数为空。 返回的内容如下:

HTTP/1.1 400 Bad Request

{"message":"无效的HTTP请求参数"}
  • 401 Unauthorized

表示没有收到有效的token(注意:无效token可能也会返回404)。 返回的内容如下:

HTTP/1.1 401 Unauthorized

{"message":"未授权用户"}
  • 404 Not Found

表示请求的资源不存在,比如请求了{company_code}为000000的公司。 返回的内容如下:

HTTP/1.1 404  Not Found

{"message":"请求的资源不存在"}

注:为了防止对token的穷举试验,token未验证通过的HTTP请求可能会返回404 Not Found,而不是401 Unauthorized.

  • 500 Internal Server Error

表示服务器挂掉了,此时可以联系客服人员请求帮助。 返回的内容如下:

HTTP/1.1 500 Internal Server Error

{"message":"服务器出问题了"}
  • 503 Service Unavailable

表示服务器暂时不可用,可能是超出负载或者在维护。 返回的内容如下:

HTTP/1.1 503 Service Unavailable

{"message":"服务器忙"}

联系方式

contact@memect.co
联络人:13146199749
北京市朝阳区圣世一品B5-6A