Data Center Doc

ixiaoshuo阅读器的服务端接口文档

获取文字小说的最新书籍列表

url:http://server.domain/list_bynewly/[PageNo]

参数:

int PageNo 需要获取书籍列表的页号

请求示例:

http://server.domain/list_bynewly/1

http://server.domain/list_bynewly/12

返回结果:

{
    "status": 200,
    "message": "",
    "data": {
        "curPageNo": 1,
        "totalPageCount": 10,
        "totalItemCount": 191,
        "list": [{
            "id": 383001,// 书籍ID
            "name": "仕途逍遥2:漂亮女领导",       // 书籍名称
            "coverUrl": "http://ixiaoshuo.vincestyling.com/detail/cover/cover_45045.jpg", // 书籍封面图片URL
            "summary": "面临绝境的萧混澹,在上级同级下级诸多的围攻之下,他......", // 书籍详情
            "lastUpdateTime": "2013-10-11 19:42:13",  // 最近一次更新时间
            "updateStatus": 2,// 书籍更新状态:1----连载  2----完结
            "capacity": 84643,// 书籍容量:字数
            "bothType" : true,//是否双版
        }, {
            "id": 384001,
            "name": "中南海保镖成长传奇:一号特卫",
            "summary": "从一个痞性十足的小青年,\n成长为震撼世界的中南海保镖",
            "lastUpdateTime": "2013-10-11 19:48:36",
            "updateStatus": 1,
            "capacity": 257189,
        }]
    }
}

获取文字小说的热门书籍列表

url:http://server.domain/list_byhottest/[PageNo]

参数:

int PageNo 需要获取书籍列表的页号

请求示例:

http://server.domain/list_byhottest/1

http://server.domain/list_byhottest/12

返回结果:

{
    "status": 200,
    "message": "",
    "data": {
        "curPageNo": 1,
        "totalPageCount": 10,
        "totalItemCount": 191,
        "list": [{
            "id": 383001,// 书籍ID
            "name": "仕途逍遥2:漂亮女领导",       // 书籍名称
            "coverUrl": "http://ixiaoshuo.vincestyling.com/detail/cover/cover_45045.jpg", // 书籍封面图片URL
            "summary": "面临绝境的萧混澹,在上级同级下级诸多的围攻之下,他......", // 书籍详情
            "updateStatus": 2,// 书籍更新状态:1----连载  2----完结
            "readerCount": 570,  // 书籍阅读人数
            "capacity": 84643,// 书籍容量:字数
            "bothType" : true,//是否双版
        }, {
            "id": 384001,
            "name": "中南海保镖成长传奇:一号特卫",
            "summary": "从一个痞性十足的小青年,\n成长为震撼世界的中南海保镖",
            "updateStatus": 1,
            "readerCount": 1,
            "capacity": 257189,
        }]
    }
}

根据状态获取文字小说列表数据

url:http://server.domain/list_bystatus/[UpdateStatus]/[PageNo]

参数:

int UpdateStatus 书籍状态(1----连载 2----完结)
int PageNo 需要获取书籍列表的页号

请求示例:

http://server.domain/list_bystatus/1/1:连载书籍列表第一页

http://server.domain/list_bystatus/2/13:完结书籍列表第十三页

返回结果:

{
    "status": 200,
    "message": "",
    "data": {
        "curPageNo": 1,
        "totalPageCount": 10,
        "totalItemCount": 191,
        "list": [{
            "id": 383001,// 书籍ID
            "name": "仕途逍遥2:漂亮女领导",       // 书籍名称
            "coverUrl": "http://ixiaoshuo.vincestyling.com/detail/cover/cover_45045.jpg", // 书籍封面图片URL
            "summary": "面临绝境的萧混澹,在上级同级下级诸多的围攻之下,他......", // 书籍详情
            "updateStatus": 2,// 书籍更新状态:1----连载  2----完结
            "catName": "历史军事", // 书籍类别名称
            "capacity": 84643,// 书籍容量:字数
            "bothType" : true,//是否双版
        }, {
            "id": 384001,
            "name": "中南海保镖成长传奇:一号特卫",
            "summary": "从一个痞性十足的小青年,\n成长为震撼世界的中南海保镖",
            "updateStatus": 1,
            "catName": "玄幻奇幻",
            "capacity": 257189,
        }]
    }
}

获取文字小说分类列表

url:http://server.domain/categories

返回结果:

{
    "status": 200,
    "message": "",
    "data":[{
        "id": 1,            // 书籍种类ID
        "name": "玄幻奇幻",  // 书籍种类名称
        "bookCount": 7914  // 书籍种类数目
    }, {
        "id": 2,
        "name": "武侠仙侠",
        "bookCount": 3456
    }]
}

根据文字小说分类获取小说列表

url:http://server.domain/list_bycategory/[CatId]/[PageNo]

参数:

int CatId 文字小说的分类
int PageNo 需要获取书籍列表的页号

请求示例:

http://server.domain/list_bycategory/1/1

http://server.domain/list_bycategory/2/13

返回结果:

{
    "status": 200,
    "message": "",
    "data": {
        "curPageNo": 1,
        "totalPageCount": 10,
        "totalItemCount": 191,
        "list": [{
            "id": 383001,// 书籍ID
            "name": "仕途逍遥2:漂亮女领导",       // 书籍名称
            "coverUrl": "http://ixiaoshuo.vincestyling.com/detail/cover/cover_45045.jpg", // 书籍封面图片URL
            "summary": "面临绝境的萧混澹,在上级同级下级诸多的围攻之下,他......", // 书籍详情
            "updateStatus": 2,// 书籍更新状态:1----连载  2----完结
            "readerCount": 570,  // 书籍阅读人数
            "capacity": 84643,// 书籍容量:字数
            "bothType" : true,//是否双版
        }, {
            "id": 384001,
            "name": "中南海保镖成长传奇:一号特卫",
            "summary": "从一个痞性十足的小青年,\n成长为震撼世界的中南海保镖",
            "updateStatus": 1,
            "catName": "玄幻奇幻",
            "readerCount": 11,
            "capacity": 257189,
        }]
    }
}

获取文字书籍的书籍详情

url:http://server.domain/detail/[BookId]

参数:

int BookId 书籍ID

请求示例:

http://server.domain/detail/19945

http://server.domain/detail/94211

返回结果:

{
    "status": 200,
    "message": "",
    "data":{
        "id": 383001, // 书籍ID
        "name": "仕途逍遥2:漂亮女领导",       // 书籍名称
        "author": "常书欣", // 书籍的作者
        "coverUrl": "http://ixiaoshuo.vincestyling.com/detail/cover/cover_45045.jpg", // 书籍封面图片URL
        "summary": "面临绝境的萧混澹,在上级同级下级诸多的围攻之下,他......", // 书籍详情
        "lastUpdateTime": "2013-10-11 19:42:13",  // 最近一次更新时间
        "updateStatus": 2, // 书籍更新状态:1----连载  2----完结
        "catId": 3 // 书籍的种类ID
        "catName": "历史军事", // 书籍类别名称
        "capacity": 84643, // 书籍容量:字数
    }
}

获取文字书籍章节列表

url:http://server.domain/chapter/list/[BookId]/[PageNo]

参数:

int BookId 书籍ID
int PageNo 列表的页号

请求示例:

http://server.domain/chapter/list/195532/1

http://server.domain/chapter/list/874517/2

返回结果:

{
    "status": 200,
    "message": "",
    "data": {
        "curPageNo": 1,
        "totalPageCount": 10,
        "totalItemCount": 191,
        "list": [{
            "id": 18282105,      // 章节ID
            "capacity": 3195,    // 章节容量(字数)
            "title": "第一章"     // 章节名称
        }, {
            "id": 18282106,
            "capacity": 4210,
            "title": "第二章"
        }]
    }
}

获取文字小说的章节内容

url:http://server.domain/chapter/content/[BookId]/[ChapterId]

参数:

int BookId 书籍ID
int ChapterId 章节ID

请求示例:

http://server.domain/chapter/content/194782/2111

http://server.domain/chapter/content/194782/2142

返回结果:

第十七章 胡惟庸案件

胡惟庸胜利了,他在朱元璋的帮助下打败了浙东集团,除掉了天下第一谋士刘基,现在他大权在握,李善长也要给他几分面子。
但他真的是最后的胜利者吗?
他并不明白自己胜利的真正原因,不是他比刘基更强,而是因为朱元璋站在他的一边。朱元璋对于两大集团的斗争情况是很清楚的,他之所以没有出来调解,是因为无论这场斗争谁胜谁负,最后的胜利者都是他。无论是姓胡的地主胜利还是姓刘的地主胜利,只要保证朱地主的最高地位就行了。
朱元璋之所以选择胡惟庸,并不是因为他很强,相反,正是因为胡惟庸对朱元璋的威胁小,所以朱元璋才让胡惟庸成为了胜利者。而愚蠢的胡惟庸并不了解这一点。
于是,在打垮刘基后,胡惟庸越发猖狂,他贪污受贿,排挤任何不服从他的人,甚至敢于挑战朱元璋的权力,私自截留下属的奏章,官员升降,处决犯人,都不经过朱元璋的批准。
洪武六年(1373),胡惟庸挤走了另一个丞相汪广洋,独揽丞相大权,并掌权七年之久。
但让人费解的是,朱元璋却对胡惟庸的犯上行为无任何表示,这是很不寻常的。
朱元璋是一个权力欲望极强的人,他自血火之中奋战而出,是那个时代最杰出的人才,李善长仅仅是稍微独断专行了些,就被他勒令退休,胡惟庸何许人也?即无军功,也无政绩,居然敢如此放肆!
这就实在让人不解了,很多的历史资料上记载了种种胡惟庸不法及朱元璋置之不理的故事,并由此推断出胡惟庸罪有应得,朱元璋正当防卫的结论。
当我们揭开事实的表象,分析其中的本质时,就会发现大有文章。
历史上著名的郑庄公,一直不为其母亲所喜爱,他的弟弟也仗着母亲的溺爱,向他提出种种不合理的要求,而郑庄公总是满足他,直到最后,他的弟弟企图谋反,郑庄公才出兵灭掉了他的弟弟。
后人往往以为郑庄公仁至义尽,传为美谈,可是也有人指出,郑庄公是真正的伪君子,是想要他弟弟的命,才纵容他的不法。

获取搜索热词

url:http://server.domain/hot_keywords

返回结果:

{
    "status": 200,
    "message": "",
    "data":{
        "keywords": "异界,网游,天才,穿越,全能,校园"
    }
}

通过关键词搜索书籍

url:http://server.domain/search/[Keyword]/[PageNo]

参数:

String Keyword 关键字,UTF8 url encoded string
int PageNo 列表的页号

请求示例:

http://server.domain/search/%E6%A0%A1%E5%9B%AD/1 : 搜索“校园”关键词

http://server.domain/search/%E5%8E%86%E5%8F%B2/2 : 搜索“历史”关键词

返回结果:

{
    "status": 200,
    "message": "",
    "data":
        "curPageNo": 1,
        "totalPageCount": 10,
        "totalItemCount": 191,
        "list": [{
            "id": 383001, // 书籍ID
            "name": "仕途逍遥2:漂亮女领导",       // 书籍名称
            "author": "常书欣", // 书籍的作者
            "summary": "面临绝境的萧混澹,在上级同级下级诸多的围攻之下,他......", // 书籍详情
            "updateStatus": 2, // 书籍更新状态:1----连载  2----完结
            "catName": "历史军事", // 书籍类别名称
            "capacity": 84643, // 书籍容量:字数
            "bothType" : true,//是否双版
        }, {
            "id": 384001,
            "name": "中南海保镖成长传奇:一号特卫",
            "author": "曾经一梦",
            "summary": "从一个痞性十足的小青年,\n成长为震撼世界的中南海保镖",
            "updateStatus": 1,
            "catName": "玄幻奇幻",
            "capacity": 257189,
        }]
}

雷达扫描接口

url:http://server.domain/list_bylocation/[PageNo]

int PageNo 列表的页号

请求示例:

http://server.domain/list_bylocation/1

http://server.domain/list_bylocation/2

返回结果:

{
    "status": 200,
    "message": "",
    "data":
        "curPageNo": 1,
        "totalPageCount": 10,
        "totalItemCount": 191,
        "list": [{
            "id": 383001, // 书籍ID
            "name": "仕途逍遥2:漂亮女领导",       // 书籍名称
            "updateStatus": 2, // 书籍更新状态:1----连载  2----完结
            "distance": 300,      // 距离(单位:米)
            "memberId": 2058,    // 用户成员ID
        }, {
            "id": 384001,
            "name": "中南海保镖成长传奇:一号特卫",
            "updateStatus": 1,
            "distance": 300,
            "memberId": 2058,
        }]
}