The Bible API

接入教程

1. 访问官网注册获取API密钥
2. 查阅文档了解可用端点和参数
3. 使用GET请求调用经文接口
4. 解析返回的JSON数据
5. 集成到您的应用程序中
6. 测试并优化调用频率

使用Python获取圣经经文

python

import requests

url = "https://api.example.com/v1/bibles/"
headers = {
    "api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}

# 获取可用圣经译本列表
response = requests.get(url, headers=headers)
if response.status_code == 200:
    bibles = response.json()
    print(f"Available bibles: {[b['name'] for b in bibles['data']]}")
else:
    print(f"Error: {response.status_code}")

使用PHP搜索圣经章节

php

<?php

$apiKey = 'YOUR_API_KEY';
$baseUrl = 'https://api.example.com/v1/';

// 获取特定书卷的章节
$bookId = 'GEN';
$url = $baseUrl . 'bibles/ENGKJV/books/' . $bookId . '/chapters';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'api-key: ' . $apiKey,
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    $data = json_decode($response, true);
    echo "Chapters in Genesis: " . count($data['data']) . "\n";
} else {
    echo "Request failed with code: " . $httpCode . "\n";
}
?>

使用JavaScript获取经文内容

javascript

const apiKey = 'YOUR_API_KEY';
const baseUrl = 'https://api.example.com/v1';

// 获取约翰福音3:16的内容
const bibleId = 'ENGKJV';
const verseId = 'JHN.3.16';
const url = `${baseUrl}/bibles/${bibleId}/verses/${verseId}`;

fetch(url, {
    method: 'GET',
    headers: {
        'api-key': apiKey,
        'Content-Type': 'application/json'
    }
})
.then(response => {
    if (!response.ok) {
        throw new Error(`HTTP error! status: ${response.status}`);
    }
    return response.json();
})
.then(data => {
    console.log('Verse text:', data.data.content);
    console.log('Reference:', data.data.reference);
})
.catch(error => {
    console.error('Error fetching verse:', error);
});

常见问题

如何获取API密钥？

请访问官方网站 https://docs.api.bible 并注册账户。注册成功后，您可以在开发者控制台中创建和管理您的API密钥。

API有使用限制吗？

是的，该API有使用频率限制以保障服务的稳定性。具体限制取决于您的账户类型，详细信息可在官方文档的"Rate Limits"部分查看。

支持哪些圣经译本？

该API支持多种语言的圣经译本，包括中文和合本、英文KJV、NIV等。您可以通过调用/bibles端点获取完整的译本列表。