简介

因为最近闲着没事，所以就开始挖掘圣经~当然也挖出了很多有趣的东西，详情还是请见以后的博客。不过竟然自己有用，那何不顺手开发api共享呢？所以就写了这些API！公开可能迟一个星期，双语版本和更多语言估计也要过一阵子。

调用文档

本API的根目录为：https://api.kaaass.net/bible

P.S.英语版本暂时不开放

篇目获取

调用/books即可，无需任何参数。返回示例如下：

[{
    ts: 1489292238,
    status: "OK",
    totalCount: 66,       // 总章节数
    data: [{
        id: 0,            // id，用于获取经文
        name: "创世记",   // 章节名
        shortName: "创",  // 章节简称
        part: "旧约",     // 属于“旧约”、“新约”
        numChapters: 50   // 章节数量
}, ...]

经文获取

API地址

/content

参数

本API允许的参数有：book、bid、chapter、period。

• book、bid：必须传入其中一个，book可以传入章节的中文名称简称，bid请参见books接口的返回。
• chapter：章节号，数字。最小为1，最大为/books返回的numChapters。
• period：小节号，不传入则返回整章。输入单个数字，或者将多个数字使用半角逗号“,”隔开。

返回示例

{
    ts: 1489292540,
    status: "OK",
    data: [{
        book: "诗篇",             // 篇目名称
        book_short: "诗",         // 篇目缩写
        chapter: "23",            // 章节号
        period: "1",              // 小节号
        num: "23:1",              // 经文索引
        content: "耶和华是我的牧者，我必不至缺乏。",       // 经文正文
        separate: "耶和华/nr,是/v,我/r,的/uj,牧者/n,，/x,我/r,必不至/d,缺乏/v,。/x"
                                                           // 经文语义分析结果
    }]
}

搜索经文

API地址

/search

参数

本API允许的参数有：bid、chapter、mode、keyword、page、page_size。

• bid：选填。若指定则在指定篇查询。
• chapter：选填，bid填写后有效。若指定则在指定篇指定章查询。
• mode：查询模式，选填。默认keyword模式，接受contain/keyword。前者为经文包含，后者为关键词查询。示例：查询“和华”，前者会返回包含“和华”的一切经文，而后者仅仅会返回“和华”成单个词的经文（且精确匹配）。
• keyword：查询关键字，必填。可以使用半角逗号或者空格分开多个关键词。
• page：页码，选填。若结果太多，则分页显示，此参数决定显示的页码。默认为1。
• page_size：单页最大数据条数，选填。默认为25。

返回示例

// 查询参数：?bid=18&keyword=耶和华
{
    ts: 1489294226,
    status: "OK",
    page: 1,             // 当前页码
    total: 666,          // 总条数
    total_page: 27,      // 总页数
    data: [{             // 查询结果，同经文内容API
        book: "诗篇",
        book_short: "诗",
        chapter: "1",
        period: "6",
        num: "1:6",
        content: "因为耶和华知道义人的道路，恶人的道路却必灭亡。",
        separate: "因为/c,耶和华/nr,知道/v,义人/n,的/uj,道路/n,，/x,恶人/n,的/uj,道路/n,却必/d,灭亡/v,。/x"
    },
    // ... ...
    ]
}

---

速度是硬伤。