Snippets

zhao fuyun 金风网站文档

Created by zhao fuyun last modified
goldwind-doc.md
Raw

接口文档

数据格式

{
    "status": 0, // 0表示正常响应，其他整数表示异常情况
    "message": "请求成功", // 可选字段
    "data": {
        // 数据部分放到此字段里，可以是任意的JSON数据类型
    }
}

上传图片

图片上传后保存成三种规格，尺寸约定如下

字段 类型 最大尺寸 (px)
origin 原图 原尺寸
cover 大图 1920 x 1920
thumbnail 缩略图 400 x 400

搜索

GET <url>?keyword=金风

搜索范围：mock/list.json 和 mock/file.json 对应的数据

{
    "status": 0,
    "data": {
        "limit": 10,
        "current": 1,
        "count": 923,
        "list": [
            {
                "id": 111,

                // `category`对照表请参考上面的list.json接口
                "category": "news-focus",
                "title": "金风科技入选2013《财富》中国企业社会责任榜",

                // list.json接口对应的数据请增加字段`summary`
                "summary": "根据中国企业会计准则，2016年公司实现营业、相关多元化战略布局和管理优化，报告期内公司盈利能力显著提升，净利率从9.48%提高到11.38%",
                "datetime": 1506929809795
            },
            {
                "id": 112,
                "category": "duty-voice",
                "title": "金风科技发布2016年度报告 盈利能力持续提升",

                // file.json接口对应的数据请增加字段 `url`, `extname`, `size`
                "url": "http://47.94.12.66:8080/flash/goldwind.pdf",
                "extname": "pdf",
                "size": 8703180,
                "datetime": 1506929809795
            },
            // ...
        ]
    }
}

大事记

GET <url>

  • 参数 无

响应 mock/about/timeline.json

{
    "status": 0,
    "data": {
        "limit": 10,
        "current": 1,
        "count": 923,
        "list": [
            {
                "year": 1988,
                "events": [
                    {
                        "cover": "/images/_temp/201709250002.jpg",
                        "content": "在多年管理运营、消化吸收进口风机的基础上，这是金风科技诞生的事业基础。"
                    },
                    {
                        "content": "风能公司在基本解决生存问题后，开始谋求更快发展。对引进不同厂家大型机组的消化吸收为研制国产化机组做了技术准备。"
                    },
                    {
                        "cover": "/images/_temp/201709250004.jpg",
                        "content": "和当时全国大多数风电场一样，达坂城风电场投运后就遇到了风电电价缺乏政策依据、导致企业生存困难的严峻局面。"
                    }
                ]
            },
            // ...
        ]
    }
}

文章列表

GET <url>?page=1&category=xxx

  • page 页码，下标从1开始
  • category 页面标识
页面 category值 额外参数
新闻聚焦 news-focus 无
金风声音 duty-voice 无
文化活动 duty-event 无
投资者常见问题 invest-faq 无

响应 mock/list.json

{
    "status": 0,
    "data": {
        "limit": 10, // 每页最多条数
        "current": 9, // 当前页码，下标从1开始
        "count": 923, // 数据总条数
        "list": [
            {
                "id": 1,
                "title": "金风科技发布2016年度报告 盈利能力持续提升",

                // 请从文章正文提取前100个汉字（剥掉html标签，只留下纯文本）
                "summary": "根据中国企业会计准则，2016年公司实现营业收入人民币263.96亿元。得益于技术创新",
                "cover": "/images/_temp/201709250001.jpg",
                "thumbnail": "/images/_temp/201709250001.jpg",
                "datetime": 1506478733016
            },
            // ...
        ]
    }
}

文件列表

GET <url>?page=1&category=xxx&额外参数

  • page 页码，下标从1开始
  • category 页面标识
  • limit 可选参数，表示每页最多显示的数据条数，默认是10，参数有效值是1-50，其他值认为是无效的，忽略掉
页面 category值 额外参数
资料下载 news-asset type: 企业介绍about，成功案例case，金风人user
视频中心 news-video 无
公司治理制度 invest-rule 无
主要股东信息 invest-shareholder 无
股东大会通知 invest-notice stock股票类型：a股，h股
投票方式和投票表格 invest-sheet stock
公告 invest-announce stock
演示材料 invest-asset stock
公司季报 invest-season stock
公司半年报 invest-semiyear stock
公司年报 invest-year stock
财务指标 invest-target stock; filter: 资产负债表debt，利润表profit， 现金流量表cash，公司综合能力指标ability
股东大会决议 invest-decision stock

响应 mock/file.json

{
    "status": 0,
    "data": {
        "limit": 10,
        "current": 9,
        "count": 923,
        "list": [
            {
                "id": "111",
                "title": "金风科技发布年度报告盈利能力持续提升",
                "description": "根据中国企业会计准则，2016年公司实现营业收入人民币263", // 纯文本描述
                "origin": "/images/_temp/201709250001.jpg",
                "cover": "/images/_temp/201709250001.jpg",
                "thumbnail": "/images/_temp/201709250001.jpg",
                "url": "http://47.94.12.66:8080/flash/goldwind.pdf", // 文件地址
                "extname": "pdf", // 文件扩展名
                "size": 8703180, // 文件大小（字节）
                "length": 1212345, // 当上传文件是mp4时才有此字段，表示`时长`，单位毫秒
                "datetime": 1506755546032
            },
            // ...
        ]
    }
}

图片下载

GET <url>?id=1

响应 mock/photo.json

{
    "status": 0,
    "data": {
        "limit": 10,
        "current": 1,
        "count": 923,
        "list": [
            {
                "id": "111",
                "title": "北京官厅湖奥运风电场项目",
                "origin": "/images/_temp/201709250001.jpg",
                "cover": "/images/_temp/201709250001.jpg",
                "thumbnail": "/images/_temp/201709250001.jpg",
                "place": "北京", // 拍摄地点
                "datetime": 1506957968317 // 拍摄时间
            },
            // ...
        ]
    }
}

文章正文

GET <url>?id=1

响应 mock/article.json

{
    "status": 0,
    "data": {
        "cover": "http://47.94.12.66:8080/upload/neir_03.jpg", // 封面大图
        "title": "风机或步入“高塔”时代",

        // 正文
        "content": "<p>金风科技联手设计院所打造钢混式风电塔架的中国标准</p> <br> <p> 单机容量越来越大，塔架高度越来越高，成为近年来风电行业一大趋势。</p>",

        "summary": "根据中国企业会计准则，2016年公司实现营业收入人民币263.96亿元。得益于技术创新、相关多元化战略布局和管理优化，报告期内公司盈利能力显著提升，净利率从9.48%提高到11.38%", 
        "prev": "116",
        "next": "118",
        "title": "风机或步入“高塔”时代",
        "source": "金风科技", // 来源
        "datetime": 1506856121119,

        // 文件列表
        "files": [
            {
                "filename": "演示材料一", // 文件名
                "url": "http://47.94.12.66:8080/flash/演示材料一.rar" // 下载地址
            },
            // ...
        ]
    }
}

Comments (0)

HTTPS SSH

You can clone a snippet to your computer for local editing. Learn more.