文档中心 > API类目 > 书旗内容文巢

alibaba.shuqi.content.backend.search.getbooklist (版权库一体化查询)

版权库一体化查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
emp_id String 可选 285845 工号
copr_product_code Number 可选 1 授权产品码,curl --location --request POST 'https://bcsbackend.shuqireader.com/innerapi/product/list'
cp_id Number 可选 10798 cp的ID
channel Number 可选 1 频道,1:男频,2女频
signs String 可选 sd7asfd7as8f7s9f8 签名
page_size Number 可选 10 每页数量,默认每页数量10,最大不超过50
content_level String 可选 S 内容等级,范围:S、A、B、C、D
cp_book_name String 可选 剑来 cp书名,支持模糊查询
is_bad_end Number 可选 1 是否烂尾,0:正常,1:烂尾
first_category_id Number 可选 123 分类,前台一级分类ID
book_ids String 可选 8712951 支持批量查询,单次最多100个,用英文逗号区隔
emp_name String 可选 张*硕 员工名字
vip_quality_rate String 可选 S 会员书优质率,范围:S、A、B、C、D
risk_score Number 可选 1 风险系数值,判断相等
risk_content_tag_id Number 可选 2 风控标签-内容标签ID
email String 可选 zongshuo.zzs@alibaba-inc.com 邮箱
timestamps Number 可选 1667956212 时间戳
copr_auth_type Number 可选 1 授权类型,1:免费,2:付费,3:免费&付费
data_date String 必须 20211210 日期,单日查询
serial_state Number 可选 2 连载状态,1:连载,2:完结
product_status Number 可选 2 产品线上状态,1:正常上架,2:隐藏可阅读-新章节可读,3:隐藏可阅读-新章节不可读,4:下架不能阅读
is_finish Number 可选 2 是否太监,0:正常,1:太监
book_name String 可选 剑来 书名
risk_main_tag_id Number 可选 1 风控标签-主线标签ID
product_code Number 可选 3 产品码,1:主端,3:UC,4:夸克
author_name String 可选 烽火戏诸侯 作者名
pool_id Number 可选 1000 选品集ID
second_category_id Number 可选 123 分类,前台二级分类ID
page Number 可选 1 页码
opera_tag_id Number 可选 60789 运营标签ID
shelf_check_status Number 可选 300001 审核状态,300001:上书待审核、300002:上书驳回、400001:内容待审核、400002:内容审核驳回、400011:内容待排查、400012:内容排查驳回、400003:待定价、500001:待上架、500002:已上架
copr_expire_status Number 可选 2 版权到期状态,1:正常,2:临期,3:到期,正常包括临期
top_class Number 可选 502 书籍类型,502:网文,503:出版物,1234:短故事
min_risk_score Number 可选 23 最低风险系数值,判断大于等于
max_risk_score Number 可选 98 最高风险系数值,判断小于等于
content_tag_id Number 可选 1290 内容标签ID
need_export Boolean 可选 false 是否需要导出

响应参数

名称 类型 示例值 描述
data PageResponse 返回值
  • └ total
  • Number
  • 0
  • 条数
  • list
  • BookSearchBizResponse []
  • data
  • 返回参数
  • └ book_id
  • Number
  • 1
  • 书籍ID
  • └ book_name
  • String
  • 书名
  • 书名
  • └ book_alias
  • String
  • 别名
  • 别名
  • └ cp_book_name
  • String
  • cp书名
  • cp书名
  • └ author_name
  • String
  • 作者名
  • 作者名
  • └ cp_name
  • String
  • cp名称
  • cp名称
  • └ serial_state
  • Number
  • 1
  • 连载状态,1:连载,2:完结
  • └ is_finish
  • Number
  • 1
  • 是否太监,0:正常,1:太监
  • └ is_bad_end
  • Number
  • 1
  • 是否烂尾,0:正常,1:烂尾
  • └ top_class
  • Number
  • 502
  • 书籍类型,502:网文,503:出版物,1234:短故事
  • └ channel
  • Number
  • 1
  • 频道,1:男频,2女频
  • └ first_category_name
  • String
  • 前台一级分类
  • 分类,前台一级分类
  • └ second_category_name
  • String
  • 前台二级分类
  • 分类,前台二级分类
  • └ pool_names
  • String
  • 选品集列表
  • 选品集列表,逗号分隔
  • └ content_level
  • String
  • 内容等级
  • 内容等级(测试域等级)
  • └ vip_quality_rate
  • String
  • 会员书优质率
  • 会员书优质率(等级)
  • └ exposure_pv
  • Number
  • 1
  • 主端日曝光pv
  • └ book_score
  • String
  • 1.1
  • 评分
  • └ content_tag_names
  • String
  • 内容标签
  • 内容标签
  • └ opera_tag_names
  • String
  • 运营标签
  • 运营标签
  • └ risk_main_tag_names
  • String
  • 主线标签
  • 主线标签(安全)
  • └ risk_content_tag_names
  • String
  • 内容标签
  • 内容标签(安全)
  • └ risk_score
  • Number
  • 11
  • 风险系数值
  • └ shelf_check_status
  • Number
  • 300001
  • 审核状态,300001:上书待审核、300002:上书驳回、400001:内容待审核、400002:内容审核驳回、400011:内容待排查、400012:内容排查驳回、400003:待定价、500001:待上架、500002:已上架
  • └ copr_expire_status
  • Number
  • 1
  • 版权到期状态
  • └ copr_type
  • Number
  • 1
  • 版权类型,1:自有,2:代理
  • └ copr_auth_type
  • Number
  • 1
  • 授权类型,1:免费,2:付费,3:免费&付费
  • └ copr_auth_vip
  • Number
  • 1
  • 授权会员书,1:授权,2:不授权
  • └ copr_auth_product_names
  • String
  • 授权产品
  • 授权产品
  • └ first_online_date_time
  • Date
  • 2022.01.01
  • 首次上架时间
  • └ last_chapter_create_time
  • Date
  • 2022.01.01
  • 最近更新时间戳
  • └ operate_reason
  • String
  • 操作原因
  • 操作原因
  • └ sq_and_status
  • Number
  • 1
  • 书旗Android线上状态,1:正常上架,2:隐藏可阅读-新章节可读,3:隐藏可阅读-新章节不可读,4:下架不能阅读
  • └ pc_status
  • Number
  • 1
  • pc站,1:正常上架,2:隐藏可阅读-新章节可读,3:隐藏可阅读-新章节不可读,4:下架不能阅读
  • └ uc_and_status
  • Number
  • 1
  • 全搜安卓,1:正常上架,2:隐藏可阅读-新章节可读,3:隐藏可阅读-新章节不可读,4:下架不能阅读
  • └ uc_ios_status
  • Number
  • 1
  • 全搜ios,1:正常上架,2:隐藏可阅读-新章节可读,3:隐藏可阅读-新章节不可读,4:下架不能阅读
  • └ quark_and_status
  • Number
  • 1
  • 夸克安卓,1:正常上架,2:隐藏可阅读-新章节可读,3:隐藏可阅读-新章节不可读,4:下架不能阅读
  • └ quark_ios_status
  • Number
  • 1
  • 夸克iOS,1:正常上架,2:隐藏可阅读-新章节可读,3:隐藏可阅读-新章节不可读,4:下架不能阅读
  • └ alipay_and_status
  • Number
  • 1
  • 支付宝小程序安卓,1:正常上架,2:隐藏可阅读-新章节可读,3:隐藏可阅读-新章节不可读,4:下架不能阅读
  • └ alipay_ios_status
  • Number
  • 1
  • 支付宝小程序iOS,1:正常上架,2:隐藏可阅读-新章节可读,3:隐藏可阅读-新章节不可读,4:下架不能阅读
  • └ taobao_and_status
  • Number
  • 1
  • 淘宝小程序安卓,1:正常上架,2:隐藏可阅读-新章节可读,3:隐藏可阅读-新章节不可读,4:下架不能阅读
  • └ taobao_ios_status
  • Number
  • 1
  • 淘宝小程序iOS,1:正常上架,2:隐藏可阅读-新章节可读,3:隐藏可阅读-新章节不可读,4:下架不能阅读
  • └ huawei_status
  • Number
  • 1
  • 华为,1:正常上架,2:隐藏可阅读-新章节可读,3:隐藏可阅读-新章节不可读,4:下架不能阅读
  • └ sq_ios_status
  • Number
  • 1
  • 书旗iOS线上状态,1:正常上架,2:隐藏可阅读-新章节可读,3:隐藏可阅读-新章节不可读,4:下架不能阅读
  • └ copr_auth_start_date
  • Date
  • 2022-10-10
  • 版权授权开始日期
  • └ copr_auth_end_date
  • Date
  • 2022-11-11
  • 版权授权结束日期
  • └ copr_confirm_date_time
  • Date
  • 2022-11-11 10:11:12
  • 版权引入通过时间
  • └ offline_chapter_nums
  • Number
  • 12
  • 线下章节数
  • └ online_chapter_nums
  • Number
  • 12
  • 线上章节数
  • └ douyin_and_status
  • Number
  • 1
  • 抖音小程序安卓,1:正常上架,2:隐藏可阅读-新章节可读,3:隐藏可阅读-新章节不可读,4:下架不能阅读
  • └ douyin_ios_status
  • Number
  • 1
  • 抖音小程序iOS,1:正常上架,2:隐藏可阅读-新章节可读,3:隐藏可阅读-新章节不可读,4:下架不能阅读
  • └ waxberry_and_status
  • Number
  • 1
  • 橙瓜杨梅故事会Android线上状态:1:上架,2:隐藏可阅读,3:隐藏不可读,4:下架
  • └ waxberry_ios_status
  • Number
  • 1
  • 橙瓜杨梅故事会iOS线上状态:1:上架,2:隐藏可阅读,3:隐藏不可读,4:下架
  • └ peach_and_status
  • Number
  • 1
  • 橙瓜桃子故事会Android线上状态:1:上架,2:隐藏可阅读,3:隐藏不可读,4:下架
  • └ peach_ios_status
  • Number
  • 1
  • 橙瓜桃子故事会iOS线上状态:1:上架,2:隐藏可阅读,3:隐藏不可读,4:下架
  • └ muskmelon_and_status
  • Number
  • 1
  • 抖音甜瓜故事会Android线上状态:1:上架,2:隐藏可阅读,3:隐藏不可读,4:下架
  • └ muskmelon_ios_status
  • Number
  • 1
  • 抖音甜瓜故事会iOS线上状态:1:上架,2:隐藏可阅读,3:隐藏不可读,4:下架
  • └ aliwx_dy_and_status
  • Number
  • 1
  • 阿里文学抖音故事会Android线上状态:1:上架,2:隐藏可阅读,3:隐藏不可读,4:下架
  • └ fuwen_dy_and_status
  • Number
  • 1
  • 富文抖音故事会Android线上状态:1:上架,2:隐藏可阅读,3:隐藏不可读,4:下架
  • └ aliwx_ks_and_status
  • Number
  • 1
  • 阿里文学快手故事会Android线上状态:1:上架,2:隐藏可阅读,3:隐藏不可读,4:下架
  • └ fuwen_ks_and_status
  • Number
  • 1
  • 富文快手故事会Android线上状态:1:上架,2:隐藏可阅读,3:隐藏不可读,4:下架
  • └ mini_program_status_json
  • String
  • {"小程序1":"正常上架","小程序2","下假不能阅读"}
  • 小程序多个平台的状态json字段
  • └ uc_harmony_status
  • Number
  • 1
  • UC鸿蒙线上状态:1:上架,2:隐藏可阅读,3:隐藏不可读,4:下架
  • └ sq_harmony_status
  • Number
  • 1
  • 书旗鸿蒙线上状态:1:上架,2:隐藏可阅读,3:隐藏不可读,4:下架
  • └ quark_harmony_status
  • Number
  • 1
  • 夸克鸿蒙线上状态:1:上架,2:隐藏可阅读,3:隐藏不可读,4:下架
state Number 200 状态码
message String success 提示信息
status Number 200 状态码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaShuqiContentBackendSearchGetbooklistRequest req = new AlibabaShuqiContentBackendSearchGetbooklistRequest();
req.setEmpId("285845");
req.setCoprProductCode(1L);
req.setCpId(10798L);
req.setChannel(1L);
req.setSigns("sd7asfd7as8f7s9f8");
req.setPageSize(10L);
req.setContentLevel("S");
req.setCpBookName("剑来");
req.setIsBadEnd(1L);
req.setFirstCategoryId(123L);
req.setBookIds("8712951");
req.setEmpName("张*硕");
req.setVipQualityRate("S");
req.setRiskScore(1L);
req.setRiskContentTagId(2L);
req.setEmail("zongshuo.zzs@alibaba-inc.com");
req.setTimestamps(1667956212L);
req.setCoprAuthType(1L);
req.setDataDate("20211210");
req.setSerialState(2L);
req.setProductStatus(2L);
req.setIsFinish(2L);
req.setBookName("剑来");
req.setRiskMainTagId(1L);
req.setProductCode(3L);
req.setAuthorName("烽火戏诸侯");
req.setPoolId(1000L);
req.setSecondCategoryId(123L);
req.setPage(1L);
req.setOperaTagId(60789L);
req.setShelfCheckStatus(300001L);
req.setCoprExpireStatus(2L);
req.setTopClass(502L);
req.setMinRiskScore(23L);
req.setMaxRiskScore(98L);
req.setContentTagId(1290L);
req.setNeedExport(false);
AlibabaShuqiContentBackendSearchGetbooklistResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_shuqi_content_backend_search_getbooklist_response>
    <data>
        <total>0</total>
        <list>
            <book_search_biz_response>
                <book_id>1</book_id>
                <book_name>书名</book_name>
                <book_alias>别名</book_alias>
                <cp_book_name>cp书名</cp_book_name>
                <author_name>作者名</author_name>
                <cp_name>cp名称</cp_name>
                <serial_state>1</serial_state>
                <is_finish>1</is_finish>
                <is_bad_end>1</is_bad_end>
                <top_class>502</top_class>
                <channel>1</channel>
                <first_category_name>前台一级分类</first_category_name>
                <second_category_name>前台二级分类</second_category_name>
                <pool_names>选品集列表</pool_names>
                <content_level>内容等级</content_level>
                <vip_quality_rate>会员书优质率</vip_quality_rate>
                <exposure_pv>1</exposure_pv>
                <book_score>1.1</book_score>
                <content_tag_names>内容标签</content_tag_names>
                <opera_tag_names>运营标签</opera_tag_names>
                <risk_main_tag_names>主线标签</risk_main_tag_names>
                <risk_content_tag_names>内容标签</risk_content_tag_names>
                <risk_score>11</risk_score>
                <shelf_check_status>300001</shelf_check_status>
                <copr_expire_status>1</copr_expire_status>
                <copr_type>1</copr_type>
                <copr_auth_type>1</copr_auth_type>
                <copr_auth_vip>1</copr_auth_vip>
                <copr_auth_product_names>授权产品</copr_auth_product_names>
                <first_online_date_time>2022.01.01</first_online_date_time>
                <last_chapter_create_time>2022.01.01</last_chapter_create_time>
                <operate_reason>操作原因</operate_reason>
                <sq_and_status>1</sq_and_status>
                <pc_status>1</pc_status>
                <uc_and_status>1</uc_and_status>
                <uc_ios_status>1</uc_ios_status>
                <quark_and_status>1</quark_and_status>
                <quark_ios_status>1</quark_ios_status>
                <alipay_and_status>1</alipay_and_status>
                <alipay_ios_status>1</alipay_ios_status>
                <taobao_and_status>1</taobao_and_status>
                <taobao_ios_status>1</taobao_ios_status>
                <huawei_status>1</huawei_status>
                <sq_ios_status>1</sq_ios_status>
                <copr_auth_start_date>2022-10-10</copr_auth_start_date>
                <copr_auth_end_date>2022-11-11</copr_auth_end_date>
                <copr_confirm_date_time>2022-11-11 10:11:12</copr_confirm_date_time>
                <offline_chapter_nums>12</offline_chapter_nums>
                <online_chapter_nums>12</online_chapter_nums>
                <douyin_and_status>1</douyin_and_status>
                <douyin_ios_status>1</douyin_ios_status>
                <waxberry_and_status>1</waxberry_and_status>
                <waxberry_ios_status>1</waxberry_ios_status>
                <peach_and_status>1</peach_and_status>
                <peach_ios_status>1</peach_ios_status>
                <muskmelon_and_status>1</muskmelon_and_status>
                <muskmelon_ios_status>1</muskmelon_ios_status>
                <aliwx_dy_and_status>1</aliwx_dy_and_status>
                <fuwen_dy_and_status>1</fuwen_dy_and_status>
                <aliwx_ks_and_status>1</aliwx_ks_and_status>
                <fuwen_ks_and_status>1</fuwen_ks_and_status>
                <mini_program_status_json>{&quot;小程序1&quot;:&quot;正常上架&quot;,&quot;小程序2&quot;,&quot;下假不能阅读&quot;}</mini_program_status_json>
                <uc_harmony_status>1</uc_harmony_status>
                <sq_harmony_status>1</sq_harmony_status>
                <quark_harmony_status>1</quark_harmony_status>
            </book_search_biz_response>
        </list>
    </data>
    <state>200</state>
    <message>success</message>
    <status>200</status>
</alibaba_shuqi_content_backend_search_getbooklist_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部