书架内容查询接口说明

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

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

请求方式:POST

请求参数

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

请求示例:

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

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

返回参数:

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

data 包含参数

参数 数据类型 必传 说明 示例
path string 小程序内容落地页链接,用户从书架点击回访小程序内容时,会跳转到此页面。(包含中文时需要 encode) /pages/detail/detail?type=5&id=7401883
category string 内容所属分类:article-专栏,doc-文档,cartoon-动漫,av-影音 cartoon
chapter_num string 内容所包含章节的总数,当内容分类为影音时必填。专辑型内容填写真实章节数量,单篇内容填 1 1200
status string 内容的基本状态,0 - 默认、1- 资源有更新、2 - 资源已下线 0
resource_free string 内容的付费状态,0 - 免费、1 - VIP 可看、2 - 付费、3 - 活动中、4 - 限时免费、5 - 按章节付费、6 - 有折扣 0
coupon_info string 优惠信息,当‘付费状态’为 4-限时免费时,coupon_info 和 pay_info 至少一个不为空 "限时七折,还剩 23 小时 59 分钟"
pay_info string 用于优惠信息计算,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\"}
cover string 内容封面图链接,建议尺寸:专栏模板 - 316x316px、文档/漫画模板 - 316x421px、视频模板 - 558x419px www.baidu.com
title string 内容的标题 斗罗大陆
author string 内容原作者 穆逢春
last_chapter string 连载专辑型内容的最新章节,结构: 最新章节数 . 最新章节 title 248.勤奋的凤凰(1)
create_time string 内容发布时间,十位时间戳格式 1553529600
modify_time string 最近更新时间,十位时间戳格式 1553529600
duration string 视频时长,当资源类型为单个影音时必填,格式 HH:MM:SS 01:22:57

pay_info 参数

参数 数据类型 必填 说明 示例
pay_money int64 内容原价 1000, ¥10.00
discount_money int64 优惠价格 0:限时免费;500:限时折扣价¥5.00
discount_starttime string 优惠开始时间 2020-03-05 00:00:00
discount_endtime string 优惠结束时间 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":{
        }
    }