后浪云百度小程序教程:书架内容查询接口说明

  • 书架内容查询接口说明
    • 百度 APP-书架发送给小程序的查询请求,为以下形式
    • 小程序返回给百度 APP-书架的参数,需遵照以下形式

    书架内容查询接口说明

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

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

    请求方式:POST

    请求参数

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

    请求示例

     
     
     
    1. {
    2. "content_ids": [
    3. "comic-20",
    4. "123456"
    5. ]
    6. }

    小程序返回给百度 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

    返回成功示例

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

    返回失败示例

     
     
     
    1. {
    2. "errno":0,
    3. "errmsg":"",
    4. "data":{
    5. }
    6. }
    THE END