概览

头条接口提供了小理后台自动聚合形成的热门资讯,按照时间排序。

获取头条

获取头条新闻列表,可根据小理给定的分类法通过类别筛选。

请求地址

URL地址:https://api.xiaoli.ai/v1/api/headline

请求方式:POST

请求参数

字段 名称 取值 备注
token 访问凭证 必选
type_uuid 头条类别 类别的uuid,参见获取头条分类接口,默认为空:不设置分类 必选
page_no 分页 - 开始页 取值范围:1~10 可选,默认为1
per_page 分页 - 每页条数 取值范围:1~50 可选,默认为20

请求数据示例:

{
  "token": "AppSecret",
  "type_uuid": "some_type_uuid",
  "per_page": 10
}

响应结果

字段 名称 取值 备注
contents 资讯列表 JSON数组 注意如果未查询到内容,该字段可能为空数组(“[ ]”)
contents.url 资讯URL
contents.title 资讯标题
contents.news_abstract 资讯摘要 可能为空。摘要由算法自动生成,最多4段话,用“...”分隔 开发者可根据需求截取其中部分内容
contents.pub_date 资讯发布时间 可能为空。时间由算法自动抽取,所以可能存在错误或者为空
contents.seed_title 来源名称 请在显示资讯的同时注明来源
contents.img_url 图片地址
page_no 分页 - 当前页
per_page 分页 - 每页条数
total_count 分页 - 总新闻条数
total_pages 分页 - 总页数

返回数据示例:

{
    "data": {
        "contents": [
            {
                "img_url": "https://img.xiaolizhuli.com/get/0ac8a891-9488-4fc7-9592-052a41a106a4uuid-namedb05005ca320a2e.png",
                "news_abstract": "...12月14日消息,上周四,阿里巴巴刚刚同福特汽车签署战略合作协议,其中涉及到在天猫上出售福特汽车。现在,阿里巴巴已经将汽车自动贩卖机已经落实到行动。据外媒报道,阿里巴巴计划在南京和上海开设两家大型自动贩卖机,这将使潜在买家有机会看到、试驾、甚至在现场购买他们选择的汽车。是的,你没看错。欢迎来到2017年。",
                "pub_date": "2017-12-14T02:45:34",
                "seed_title": "CNBeta",
                "title": "阿里启动汽车自动贩卖机项目",
                "url": "http://www.cnbeta.com/articles/tech/679729.htm"
            },
            ...
        ],
        "page_no": 1,
        "per_page": 5,
        "total_count": 20,
        "total_pages": 4
    }
}

获取头条分类

获取分类信息,可用于对头条进行类别筛选

请求地址

URL地址: https://api.xiaoli.ai/v1/api/headline/types

请求方式:POST

请求参数

字段 名称 取值 备注
token 访问凭证 必选

请求数据示例:

{
  "token": "AppSecret",
}

响应结果

字段 名称 取值 备注
name 类别的名称 字符串
uuid 类别的uuid, 可作为头条接口的type_uuid参数 字符串

返回数据示例:

{
    "data": [
        {
            "name": "互联网",
            "uuid": "4481a0ff-5cbe-4993-81b3-e03ed52559cf"
        },
        {
            "name": "信息技术",
            "uuid": "c7b80745-e100-4360-b915-27d440b72819"
        },
        {
            "name": "金融业",
            "uuid": "1a5b4801-25db-41f3-a4ad-f28843dacef8"
        },
        ...
    ]
}