文因云

文档与支持

公司基本面信息API

一:产品说明

文因互联公司基本面API支持对主板上市企业的基本信息、资产负债表、利润表、现金流量表等财务信息数据的查询。用户可以通过发送HTTP请求访问, 各类数据会以JSON的格式返回给用户。

二:授权说明

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

三:主要功能

目前API提供的数据包括公司的基本信息和财务信息,具体如下:

* 公司基本信息
    * 包括:'董事长', '董事会秘书', '法定代表人', '实际控制人', '公司名称', '注册资本', '机构全称', '成立日期', '董秘电话', '注册地址', '营业执照号码', '公司传真', '英文全称', '公司网址', '注册会计师', '办公地址', '公司电子邮箱', '办公地址邮政编码', '公司电话', '最终控制人', '境内会计师事务所名称'
* 财务信息
    * 资产负债表
        * 该公司的所有资产负债表会计科目
    * 利润表
        * 该公司的所有合并利润表会计科目
    * 现金流量表
        * 该公司的所有合并现金流量表会计科目

四:API详情

1 API请求格式

GET /v1/data/company/{company_code}

支持的参数如下:

ABC
参数类型描述
fieldstring表示应该返回公司哪些信息。该参数可选,如果为空则表示返回公司的基本信息。目前支持以下字段:
基本信息:公司的基本信息
资产负债表:公司的合并资产负债表
现金流量表:公司的合并现金流量表
利润表:公司的合并利润表
periodstring表示应该返回哪个财报周期的信息。支持如下形式的财报周期:
201[567]:表示返回公司对应年份的财报信息
2017Q[1234]:表示返回公司对应季报的信息

注:

  1. 当请求的filed是基本信息时,可以不提供period参数,其他field必须同时提供period参数.
  2. 目前period仅支持2015、2016、2017Q3这三个财报周期

2 公司基本信息请求示例

  • 请求URL示例
GET /v1/data/company/000001?field=基本信息
  • 返回数据示例

会返回代码为000001公司的基本信息

{
  "证券事务代表联系地址": "中国广东省深圳市深南东路5047号平安银行董事会办公室",
  "外部监事": "骆向东,王聪,周建国",
  "董秘联系地址": "中国广东省深圳市深南东路5047号平安银行董事会办公室",
  .
  .
  .
  "会计师事务所办公地址": "上海市黄浦区湖滨路202号企业天地2号楼",
  "董事": "蔡方方,姚波,胡跃飞,郭建,叶素兰,陈心颖",
  "机构全称": "平安银行股份有限公司",
  "成立日期": "1987-12-22"
}

3 公司财务数据请求示例

  • 请求示例:
GET /v1/data/company/000001?field=资产负债表&period=2016
  • 返回数据:

会返回代码为000001公司的2016年年报的资产负债表信息

{
  "减:库存股": "",
  "应收利息": 15770000000,
  .
  .
  .
  "应付手续费及佣金": "",
  "其他综合收益": -809000000
}
  • 请求:
GET /v1/data/company/000001?field=资产负债表&period=2017Q3
  • 返回数据说明

会返回代码为000001公司的2017第3季度的资产负债表信息

五:客户端错误代码

如果一切顺利,服务器返回的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