淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	描述
emp_id	String	必须	285845	员工工号
emp_name	String	必须	张宗硕	员工名称
signs	String	可选	827ccb0eea8a706c4c34a16891f84e7b	签名
bid	Number	必须	8880205	书籍id
timestamps	Number	可选	1704411251	时间戳
account	String	可选	zongshuo.zzs	域账号

名称	类型	示例值	描述
data	Data []		data
└ vol_order Number 1 卷序号 chapter_list ChapterList [] chapterList └ vid Number 1 卷序号 └ mod_status Number 0 杂质修改状态，0：无修改，1：杂质已修改，2：无杂质 └ size Number 7 章节内容大小 └ zid Number 1 章在卷的序号 └ create_time Number 1703666204 创建时间 └ order_id Number 1 卷在书的序号 └ chapter_id Number 1758486 章节ID └ chapter_name String 第一章落魄皇子，开局签到混沌圣体！章节名称 └ status Number 1 章节状态，1：正常，0：锁章，2：隐藏 └ vol_id Number 201795 卷ID └ vol_name String 第一卷卷名称
state	Number	200	state
message	String	success	message

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaShuqiContentBackendChapterGetchapterlistRequest req = new AlibabaShuqiContentBackendChapterGetchapterlistRequest();
req.setEmpId("285845");
req.setEmpName("张宗硕");
req.setSigns("827ccb0eea8a706c4c34a16891f84e7b");
req.setBid(8880205L);
req.setTimestamps(1704411251L);
req.setAccount("zongshuo.zzs");
AlibabaShuqiContentBackendChapterGetchapterlistResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaShuqiContentBackendChapterGetchapterlistRequest req = new AlibabaShuqiContentBackendChapterGetchapterlistRequest();
req.EmpId = "285845";
req.EmpName = "张宗硕";
req.Signs = "827ccb0eea8a706c4c34a16891f84e7b";
req.Bid = 8880205L;
req.Timestamps = 1704411251L;
req.Account = "zongshuo.zzs";
AlibabaShuqiContentBackendChapterGetchapterlistResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaShuqiContentBackendChapterGetchapterlistRequest;
$req->setEmpId("285845");
$req->setEmpName("张宗硕");
$req->setSigns("827ccb0eea8a706c4c34a16891f84e7b");
$req->setBid("8880205");
$req->setTimestamps("1704411251");
$req->setAccount("zongshuo.zzs");
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=alibaba.shuqi.content.backend.chapter.getchapterlist' \
-d 'partner_id=apidoc' \
-d 'sign=DF954B330912E0135F8B06DC3F0445D6' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-07-18+02%3A55%3A47' \
-d 'v=2.0' \
-d 'account=zongshuo.zzs' \
-d 'bid=8880205' \
-d 'emp_id=285845' \
-d 'emp_name=%E5%BC%A0%E5%AE%97%E7%A1%95' \
-d 'signs=827ccb0eea8a706c4c34a16891f84e7b' \
-d 'timestamps=1704411251'

# -*- coding: utf-8 -*-
import top.api

req=top.api.AlibabaShuqiContentBackendChapterGetchapterlistRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.emp_id="285845"
req.emp_name="张宗硕"
req.signs="827ccb0eea8a706c4c34a16891f84e7b"
req.bid=8880205
req.timestamps=1704411251
req.account="zongshuo.zzs"
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"alibaba.shuqi.content.backend.chapter.getchapterlist");
add_param(pRequest,"emp_id","285845");
add_param(pRequest,"emp_name","张宗硕");
add_param(pRequest,"signs","827ccb0eea8a706c4c34a16891f84e7b");
add_param(pRequest,"bid","8880205");
add_param(pRequest,"timestamps","1704411251");
add_param(pRequest,"account","zongshuo.zzs");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alibaba.shuqi.content.backend.chapter.getchapterlist', {
	'emp_id':'285845',
	'emp_name':'张宗硕',
	'signs':'827ccb0eea8a706c4c34a16891f84e7b',
	'bid':'8880205',
	'timestamps':'1704411251',
	'account':'zongshuo.zzs'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_shuqi_content_backend_chapter_getchapterlist_response>
    <data>
        <data>
            <vol_order>1</vol_order>
            <chapter_list>
                <chapter_list>
                    <vid>1</vid>
                    <mod_status>0</mod_status>
                    <size>7</size>
                    <zid>1</zid>
                    <create_time>1703666204</create_time>
                    <order_id>1</order_id>
                    <chapter_id>1758486</chapter_id>
                    <chapter_name>第一章 落魄皇子，开局签到混沌圣体！</chapter_name>
                    <status>1</status>
                </chapter_list>
            </chapter_list>
            <vol_id>201795</vol_id>
            <vol_name>第一卷</vol_name>
        </data>
    </data>
    <state>200</state>
    <message>success</message>
</alibaba_shuqi_content_backend_chapter_getchapterlist_response>

{
    "alibaba_shuqi_content_backend_chapter_getchapterlist_response":{
        "data":{
            "data":[
                {
                    "vol_order":1,
                    "chapter_list":{
                        "chapter_list":[
                            {
                                "vid":1,
                                "mod_status":0,
                                "size":7,
                                "zid":1,
                                "create_time":1703666204,
                                "order_id":1,
                                "chapter_id":1758486,
                                "chapter_name":"第一章 落魄皇子，开局签到混沌圣体！",
                                "status":1
                            }
                        ]
                    },
                    "vol_id":201795,
                    "vol_name":"第一卷"
                }
            ]
        },
        "state":200,
        "message":"success"
    }
}

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>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

开放平台

书旗内容文巢

alibaba.shuqi.content.backend.chapter.getchapterlist (章节列表)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ