<?php

require_once 'curl.func.php';

$appkey = 'your_appkey_here';//你的appkey
$url = "https://api.jisuapi.com/shiji/chapter?appkey=$appkey";
$result = curlOpen($url, ['ssl'=>true]);
$jsonarr = json_decode($result, true);
//exit(var_dump($jsonarr));

if($jsonarr['status'] != 0)
{
    echo $jsonarr['msg'];
    exit();
}

$result = $jsonarr['result'];
foreach($result as $val)
{
    echo $val['chapterid'].' '.$val['chaptername'].' '.$val['parentid'].'
';
    if(is_array($val['list']))
    {
        foreach($val['list'] as $k=>$v)
        {
            echo $v['detailid'].' '.$v['name'].'
';
        }
    }        
}

#!/usr/bin/python
# encoding:utf-8

import urllib2, json, urllib



# 1、所有章节


data = {}
data["appkey"] = "your_appkey_here"

url_values = urllib.urlencode(data)
url = "https://api.jisuapi.com/shiji/chapter" + "?" + url_values
request = urllib2.Request(url)
result = urllib2.urlopen(request)
jsonarr = json.loads(result.read())

if jsonarr["status"] != u"0":
    print jsonarr["msg"]
    exit()
result = jsonarr["result"]
for val in result:
    print val["chapterid"],val["chaptername"],val["parentid"]
    if val["list"] :
        for v in val["list"] :
            print v["detailid"],v["name"]

package api.jisuapi.shiji;

import api.util.HttpUtil;
import net.sf.json.JSONArray;
import net.sf.json.JSONObject;

public class Chapter {

	public static final String APPKEY = "your_appkey_here";// 你的appkey
	public static final String URL = "https://api.jisuapi.com/shiji/chapter";

	public static void Get() {
		String result = null;
		String url = URL + "?appkey=" + APPKEY;

		try {
			result = HttpUtil.sendGet(url, "utf-8");
			JSONObject json = JSONObject.fromObject(result);
			if (json.getInt("status") != 0) {
				System.out.println(json.getString("msg"));
			} else {
				JSONArray resultarr = json.optJSONArray("result");
				for (int i = 0; i < resultarr.size(); i++) {
					JSONObject obj = (JSONObject) resultarr.opt(i);
					String chapterid = obj.getString("chapterid");
					String chaptername = obj.getString("chaptername");
					String parentid = obj.getString("parentid");
					System.out.println(chapterid + " " + chaptername + " " + parentid);
					JSONArray list = obj.optJSONArray("list");
					for (int j = 0; j < list.size(); j++) {
						JSONObject data = (JSONObject) list.opt(j);
						String detailid = data.getString("detailid");
						String name = data.getString("name");
						System.out.println(detailid + " " + name);
					}
				}
			}
		} catch (Exception e) {
			e.printStackTrace();
		}
	}
}

JSON返回示例 :

{
    "status": 0,
    "msg": "ok",
    "result": [
        {
            "chapterid": "1",
            "chaptername": "十二本纪",
            "parentid": "0",
            "list": [
                {
                    "detailid": "1",
                    "name": "五帝本纪"
                },
                {
                    "detailid": "2",
                    "name": "夏本纪"
                },
                {
                    "detailid": "3",
                    "name": "殷本纪"
                },
                {
                    "detailid": "4",
                    "name": "周本纪"
                },
                {
                    "detailid": "5",
                    "name": "秦本纪"
                },
                {
                    "detailid": "6",
                    "name": "秦始皇本纪"
                },
                {
                    "detailid": "7",
                    "name": "项羽本纪"
                }
            ]
        }
    ]
}

接口地址： https://api.jisuapi.com/shiji/detail

返回格式： JSON,JSONP

请求方法： GET POST

请求示例： https://api.jisuapi.com/shiji/detail?appkey=yourappkey&detailid=1&isdetailed=1

请求参数：

API在线测试

参数名称	类型	必填	说明
detailid	int	是	详情ID
isdetailed	int	是	是否返回详细

返回参数：

参数名称	类型	说明
name	string	名称
content	string	内容
commentary	string	注释
translation	string	翻译
appreciation	string	赏析
interpretation	string	解读

请求代码：

查看代码

<?php

require_once 'curl.func.php';

$appkey = 'your_appkey_here';//你的appkey
$detailid = 1;
$isdetailed = 1;
$url = "https://api.jisuapi.com/shiji/detail?appkey=$appkey&detailid=$detailid&isdetailed=$isdetailed";
$result = curlOpen($url, ['ssl'=>true]);
$jsonarr = json_decode($result, true);
//exit(var_dump($jsonarr));

if($jsonarr['status'] != 0)
{
    echo $jsonarr['msg'];
    exit();
}

$result = $jsonarr['result'];
echo $result['name'].' '.$result['content'].' '.$result['commentary'].' '.$result['translation'].' '.$result['appreciation'].' '.$result['interpretation'].'
';

#!/usr/bin/python
# encoding:utf-8

import urllib2, json, urllib



# 2、详情查询

data = {}
data["appkey"] = "your_appkey_here"
data["detailid"] = 1
data["isdetailid"] = 1

url_values = urllib.urlencode(data)
url = "https://api.jisuapi.com/shiji/detail" + "?" + url_values
request = urllib2.Request(url)
result = urllib2.urlopen(request)
jsonarr = json.loads(result.read())

if jsonarr["status"] != u"0":
    print jsonarr["msg"]
    exit()
result = jsonarr["result"]
print result["name"],result["content"],result["commentary"],result["translation"]

package api.jisuapi.shiji;

import api.util.HttpUtil;
import net.sf.json.JSONObject;

public class Detail {

	public static final String APPKEY = "your_appkey_here";// 你的appkey
	public static final String URL = "https://api.jisuapi.com/shiji/detail";
	public static final int detailid = 1;
	public static final int isdetailed = 1;

	public static void Get() {
		String result = null;
		String url = URL + "?appkey=" + APPKEY + "&detailid=" + detailid + "&isdetailed=" + isdetailed;

		try {
			result = HttpUtil.sendGet(url, "utf-8");
			JSONObject json = JSONObject.fromObject(result);
			if (json.getInt("status") != 0) {
				System.out.println(json.getString("msg"));
			} else {
				JSONObject resultarr = json.optJSONObject("result");
				String name = resultarr.getString("name");
				String content = resultarr.getString("content");
				String commentary = resultarr.getString("commentary");
				String translation = resultarr.getString("translation");
				String appreciation = resultarr.getString("appreciation");
				String interpretation = resultarr.getString("interpretation");
				System.out.println(name + " " + content + " " + commentary + " " + translation + " " + appreciation
						+ " " + interpretation);
			}
		} catch (Exception e) {
			e.printStackTrace();
		}
	}
}

JSON返回示例 :

{ "status": 0, "msg": "ok", "result": { "name": "五帝本纪", "content": "

　　黄帝者，少典之子，姓公孙，名曰轩辕。生而神灵，弱而能言，幼而徇齐，长而敦敏，成而聪明。轩辕之时，神农氏世衰。诸侯相侵伐，暴虐百姓，而神农氏弗能征。於是轩辕乃习用干戈，以征不享，诸侯咸来宾从。而蚩尤最为暴，莫能伐。炎帝欲侵陵诸侯，诸侯咸归轩辕。轩辕乃修德振兵，治五气，蓺五种，抚万民，度四方，教熊罴貔貅貙虎，以与炎帝战於阪泉之野。三战，然後得其志。蚩尤作乱，不用帝命。於是黄帝乃徵师诸侯，与蚩尤战於涿鹿之野，遂禽杀蚩尤。而诸侯咸尊轩辕为天子，代神农氏，是为黄帝。天下有不顺者，黄帝从而征之，平者去之，披山通道，未尝宁居。

", "commentary": "

①神灵：神异。
②能言：长于辩论；有独到的见解。
③徇齐：指敏慧。
④敦敏：笃实敏捷。
⑤干戈：指战争。
⑥不享：指不来朝者。
⑦宾从：服从，归顺。
⑧修德：修养德行。
⑨振兵：整顿部队。
⑩五气：五行之气，五方之气。
⑾五种：五种谷物。
⑿披山：开山。
⒀通道：开辟道路。
⒁宁居：安居。

", "translation": "

　　黄帝，是少典部族的子孙，姓公孙名叫轩辕。他一生下来，就很有灵性，在襁褓中就会说话，幼年时聪明机敏，长大后诚实勤奋，成年以后见闻广博，对事物看得透彻。
　　轩辕时代，神农氏的统治逐渐衰弱，诸侯之间互相侵伐，祸害百姓，而神农氏无力征讨。于是轩辕就动用武力去讨伐那些不守纪律，不来朝拜神农氏的人，因而诸侯都对他表示臣服与追随。而蚩尤最凶暴，没有人能够制服他。炎帝也好欺凌他人，因此诸侯们都拥护轩辕。于是轩辕修行德业，整顿军旅，研究四时节气变化，种植五谷，安抚民众，丈量四方的土地，训练熊、罴（pí，皮）、貔（pí，皮）貅（xiū，休）、躯（chū，初）、虎等猛兽，跟炎帝在阪泉的郊野交战，先后打了三仗，才征服炎帝，如愿得胜。蚩尤发动叛乱，不听从黄帝之命。于是黄帝征调诸侯的军队，在涿鹿郊野与蚩尤作战，终于擒获并杀死了他。这样，诸侯都尊奉轩辕做天子，取代了神农氏，这就是黄帝。天下有不归顺的，黄帝就前去征讨，平定一个地方之后就离去，一路上劈山开道，从来没有在哪儿安宁地居住过。", "appreciation": "

　　《五帝本纪》是《史记》全书一百三十篇中的第一篇。

　　《史记》是我国纪传体史书的创始之作。所谓纪传体的“纪”就是指本纪。《史纪》共有本纪十二篇，以历史上的帝王为中心，上自黄帝，下至司马迁当时的帝王汉武帝，依次记叙了他们的言行政迹，同时也记载了各个时代的政治、经济、军事、文化、外交等方面的重大事件。可以说，本纪就是一部按年代次序编写的帝王简史或系统的编年大事记。本纪排在全书的最前头，历来被视为全书的纲，它保存了许多历代相传的历史资料，对于后人了解历史年代发展顺序有着重要的价值。纵观本纪十二篇，就思想内容来说，处处反映了司马迁的唯物主义史学观和实事求是的严谨态度，往往是从客观史实出发总结出历史经验教训，而不以个人好恶评价英雄的成败和朝代的兴衰；就艺术特色来说，最为突出的是取材慎重，剪裁适当，布局合理，详略有致，抓住重点，渲染抒情，在多数篇目中都有精彩之笔，人物真实，场面生动，感情饱满，或敬慕，或憎恶，或惋惜，或悲壮……

", "interpretation": "" } }

接口地址： https://api.jisuapi.com/shiji/search

返回格式： JSON,JSONP

请求方法： GET POST

请求示例： https://api.jisuapi.com/shiji/search?appkey=yourappkey&keyword=黄帝者&isdetailed=1

请求参数：

API在线测试

参数名称	类型	必填	说明
keyword	string	是	关键词
isdetailed	int	是	是否返回详细

返回参数：

参数名称	类型	说明
total	string	总数
pagenum	int	当前页
pagesize	int	每页数量
detailid	int	详情ID
name	string	名称
content	string	内容
commentary	string	注释
translation	string	翻译
appreciation	string	赏析
interpretation	string	解读

请求代码：

查看代码

<?php

require_once 'curl.func.php';

$appkey = 'your_appkey_here';//你的appkey
$keyword = '黄帝者';//utf8
$pagesize = 1;
$pagenum = 1;
$url = "https://api.jisuapi.com/shiji/search?appkey=$appkey&keyword=$keyword&pagesize=$pagesize&pagenum=$pagenum";
$result = curlOpen($url, ['ssl'=>true]);
$jsonarr = json_decode($result, true);
//exit(var_dump($jsonarr));

if($jsonarr['status'] != 0)
{
    echo $jsonarr['msg'];
    exit();
}

$result = $jsonarr['result'];
echo $result['total'].' '.$result['pagesize'].' '.$result['pagenum'].'
';
foreach($result['list'] as $val)
{
    echo $val['detailid'].' '.$val['name'].' '.$val['content'].' '.$val['commentary'].' '.$val['translation'].' '.$val['appreciation'].' '.$val['interpretation'].'
';
}

#!/usr/bin/python
# encoding:utf-8

import urllib2, json, urllib


# 3、内容搜索

data = {}
data["appkey"] = "your_appkey_here"
data["keyword"] = "司马迁"
data["pagenum"] = 1
data["pagesize"] = 1

url_values = urllib.urlencode(data)
url = "https://api.jisuapi.com/shiji/search" + "?" + url_values
request = urllib2.Request(url)
result = urllib2.urlopen(request)
jsonarr = json.loads(result.read())

if jsonarr["status"] != u"0":
    print jsonarr["msg"]
    exit()
result = jsonarr["result"]
print result["total"],result["pagesize"],result["pagenum"]
for val in result["list"] :
    print val["detailid"],val["name"],val["content"],val["commentary"],val["translation"]

package api.jisuapi.shiji;

import java.net.URLEncoder;

import api.util.HttpUtil;
import net.sf.json.JSONArray;
import net.sf.json.JSONObject;

public class Search {

	public static final String APPKEY = "your_appkey_here";// 你的appkey
	public static final String URL = "https://api.jisuapi.com/shiji/search";
	public static final String keyword = "黄帝者";// utf-8
	public static final int isdetailed = 1;

	public static void Get() throws Exception {
		String result = null;
		String url = URL + "?appkey=" + APPKEY + "&keyword=" + URLEncoder.encode(keyword, "utf-8") + "&isdetailed="
				+ isdetailed;

		try {
			result = HttpUtil.sendGet(url, "utf-8");
			JSONObject json = JSONObject.fromObject(result);
			if (json.getInt("status") != 0) {
				System.out.println(json.getString("msg"));
			} else {
				JSONObject resultarr = json.optJSONObject("result");
				String total = resultarr.getString("total");
				String pagenum = resultarr.getString("pagenum");
				String pagesize = resultarr.getString("pagesize");
				System.out.println(total + " " + pagenum + " " + pagesize);
				JSONArray list = resultarr.optJSONArray("list");
				for (int i = 0; i < list.size(); i++) {
					JSONObject obj = (JSONObject) list.opt(i);
					String detailid = obj.getString("detailid");
					String name = obj.getString("name");
					String content = obj.getString("content");
					String commentary = obj.getString("commentary");
					String translation = obj.getString("translation");
					String appreciation = obj.getString("appreciation");
					String interpretation = obj.getString("interpretation");
					System.out.println(detailid + " " + name + " " + content + " " + commentary + " " + translation
							+ " " + appreciation + " " + interpretation);
				}
			}
		} catch (Exception e) {
			e.printStackTrace();
		}
	}
}

JSON返回示例 :

{ "status": 0, "msg": "ok", "result": { "name": "五帝本纪", "content": "

　　黄帝者，少典之子，姓公孙，名曰轩辕。生而神灵，弱而能言，幼而徇齐，长而敦敏，成而聪明。轩辕之时，神农氏世衰。诸侯相侵伐，暴虐百姓，而神农氏弗能征。於是轩辕乃习用干戈，以征不享，诸侯咸来宾从。而蚩尤最为暴，莫能伐。炎帝欲侵陵诸侯，诸侯咸归轩辕。轩辕乃修德振兵，治五气，蓺五种，抚万民，度四方，教熊罴貔貅貙虎，以与炎帝战於阪泉之野。三战，然後得其志。蚩尤作乱，不用帝命。於是黄帝乃徵师诸侯，与蚩尤战於涿鹿之野，遂禽杀蚩尤。而诸侯咸尊轩辕为天子，代神农氏，是为黄帝。天下有不顺者，黄帝从而征之，平者去之，披山通道，未尝宁居。

", "commentary": "

①神灵：神异。
②能言：长于辩论；有独到的见解。
③徇齐：指敏慧。
④敦敏：笃实敏捷。
⑤干戈：指战争。
⑥不享：指不来朝者。
⑦宾从：服从，归顺。
⑧修德：修养德行。
⑨振兵：整顿部队。
⑩五气：五行之气，五方之气。
⑾五种：五种谷物。
⑿披山：开山。
⒀通道：开辟道路。
⒁宁居：安居。

", "translation": "

　　黄帝，是少典部族的子孙，姓公孙名叫轩辕。他一生下来，就很有灵性，在襁褓中就会说话，幼年时聪明机敏，长大后诚实勤奋，成年以后见闻广博，对事物看得透彻。
　　轩辕时代，神农氏的统治逐渐衰弱，诸侯之间互相侵伐，祸害百姓，而神农氏无力征讨。于是轩辕就动用武力去讨伐那些不守纪律，不来朝拜神农氏的人，因而诸侯都对他表示臣服与追随。而蚩尤最凶暴，没有人能够制服他。炎帝也好欺凌他人，因此诸侯们都拥护轩辕。于是轩辕修行德业，整顿军旅，研究四时节气变化，种植五谷，安抚民众，丈量四方的土地，训练熊、罴（pí，皮）、貔（pí，皮）貅（xiū，休）、躯（chū，初）、虎等猛兽，跟炎帝在阪泉的郊野交战，先后打了三仗，才征服炎帝，如愿得胜。蚩尤发动叛乱，不听从黄帝之命。于是黄帝征调诸侯的军队，在涿鹿郊野与蚩尤作战，终于擒获并杀死了他。这样，诸侯都尊奉轩辕做天子，取代了神农氏，这就是黄帝。天下有不归顺的，黄帝就前去征讨，平定一个地方之后就离去，一路上劈山开道，从来没有在哪儿安宁地居住过。", "appreciation": "

　　《五帝本纪》是《史记》全书一百三十篇中的第一篇。

　　《史记》是我国纪传体史书的创始之作。所谓纪传体的“纪”就是指本纪。《史纪》共有本纪十二篇，以历史上的帝王为中心，上自黄帝，下至司马迁当时的帝王汉武帝，依次记叙了他们的言行政迹，同时也记载了各个时代的政治、经济、军事、文化、外交等方面的重大事件。可以说，本纪就是一部按年代次序编写的帝王简史或系统的编年大事记。本纪排在全书的最前头，历来被视为全书的纲，它保存了许多历代相传的历史资料，对于后人了解历史年代发展顺序有着重要的价值。纵观本纪十二篇，就思想内容来说，处处反映了司马迁的唯物主义史学观和实事求是的严谨态度，往往是从客观史实出发总结出历史经验教训，而不以个人好恶评价英雄的成败和朝代的兴衰；就艺术特色来说，最为突出的是取材慎重，剪裁适当，布局合理，详略有致，抓住重点，渲染抒情，在多数篇目中都有精彩之笔，人物真实，场面生动，感情饱满，或敬慕，或憎恶，或惋惜，或悲壮……

", "interpretation": "" } }

API错误码：

代号	说明
201	关键词为空
202	详情ID为空
203	没有信息

系统错误码：

代号	说明
101	APPKEY为空或不存在
102	APPKEY已过期
103	APPKEY无请求此数据权限
104	请求超过次数限制
105	IP被禁止
106	IP请求超过限制
107	接口维护中
108	接口已停用