阅读(4369) (8)

百度智能小程序 书架内容查询接口说明

2020-08-13 16:30:02 更新

书架内容查询接口说明

解释:百度 APP-书架发送给小程序的查询请求,接入百度 APP-书架同步能力的开发者,需要参照本文档开发书架内容查询接口,并在“开发者平台-产品试验室- 百度 APP 书架同步”页面填写提交接口路径,以供百度 APP-书架服务查询并展示对应内容详情。

百度 APP-书架发送给小程序的查询请求,为以下形式

请求方式:POST

请求参数:

参数数据类型说明
content_idsArray.<String>内容 id ,由开发者调用 swan.insertBookshelf 向百度 APP-书架同步小程序内容时定义。批量最多 100 条,重复的 contentId 只取一个

请求示例:

    {
        "content_ids":[
            "comic-20",
            "123456"
        ]
    }

小程序返回给百度 APP-书架的参数,需遵照以下形式

返回参数:

参数数据类型必填说明
errnoString错误码,0-表示成功,1-表示失败
msgString错误描述信息,由开发者自定义
dataObject返回的内容详情列表,详见下方列表

data 包含参数:

参数数据类型必传说明示例
pathString小程序内容落地页链接,用户从书架点击回访小程序内容时,会跳转到此页面。(包含中文时需要 encode)/pages/detail/detail?type=5&id=7401883
categoryString内容所属分类:article-专栏,doc-文档,cartoon-动漫,av-影音cartoon
chapter_numString内容所包含章节的总数,当内容分类为影音时必填。专辑型内容填写真实章节数量,单篇内容填 11200
statusString内容的基本状态,0 - 默认、1- 资源有更新、2 - 资源已下线0
resource_freeString内容的付费状态,0 - 免费、1 - VIP 可看、2 - 付费、3 - 活动中、4 - 限时免费、5 - 按章节付费、6 - 有折扣0
coupon_infoString优惠信息,当‘付费状态’为 4-限时免费时,coupon_info 和 pay_info 至少一个不为空"限时七折,还剩 23 小时 59 分钟"
pay_infoString用于优惠信息计算,json 字符串,详见下方 pay_info 参数列表{\"pay_money\":1000,\"discount_money\":700,\"discount_starttime\":\"2020-03-05 00:00:00\",\"discount_endtime\":\"2020-03-24 00:00:00\"}
coverString内容封面图链接,建议尺寸:专栏模板 - 316x316px、文档/漫画模板 - 316x421px、视频模板 - 558x419pxwww.baidu.com
titleString内容的标题斗罗大陆
authorString内容原作者穆逢春
last_chapterString连载专辑型内容的最新章节,结构: 最新章节数 . 最新章节 title248.勤奋的凤凰(1)
create_timeString内容发布时间,十位时间戳格式1553529600
modify_timeString最近更新时间,十位时间戳格式1553529600
durationString视频时长,当资源类型为单个影音时必填,格式 HH:MM:SS01:22:57

pay_info 参数:

参数数据类型必填说明示例
pay_moneyInt64内容原价1000 ,¥10.00
discount_moneyInt64优惠价格0:限时免费;500:限时折扣价¥5.00
discount_starttimeString优惠开始时间2020-03-05 00:00:00
discount_endtimeString优惠结束时间2020-03-24 00:00:00

返回成功示例:

{
    "errno":0,
    "errmsg":"succ",
    "data":{
        "comic-20":{
            "path": "/pages/detail/detail?type=5&id=7401883",
            "create_time":"1569311652",
            "modify_time":"1582082781",
            "chapter_num":"11",
            "status":"0",
            "resource_free":"1",
            "coupon_info":"限时折扣,还剩14天12小时54分钟结束",
            "cover":"http://t11.baidu.com/it/JPEG?&s=50A5",
            "title":"投资心理课——从错误中学习如何安全盈利",
            "author":"叶檀",
            "last_chapter":"11.如何安全盈利"
        }
    }
}

返回失败示例:

{
    "errno":0,
    "errmsg":"",
    "data":{
    }
}