古兰经API

接入教程

1. 访问官网注册获取API密钥
2. 查阅文档了解可用端点
3. 使用GET请求调用经文端点
4. 添加语言参数获取翻译
5. 处理返回的JSON数据

使用Python获取古兰经章节列表

python

import requests

url = 'https://api.example.com/v1/chapters'
headers = {'Authorization': 'Bearer YOUR_API_KEY'}

response = requests.get(url, headers=headers)
if response.status_code == 200:
    chapters = response.json()
    print(f'Found {len(chapters)} chapters')
else:
    print(f'Error: {response.status_code}')
    print(response.text)

使用PHP搜索古兰经经文

php

<?php

$url = 'https://api.example.com/v1/verses/search';
$query = ['query' => 'mercy', 'language' => 'en'];

$ch = curl_init($url . '?' . http_build_query($query));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

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

if ($httpCode === 200) {
    $data = json_decode($response, true);
    echo 'Verses found: ' . count($data['verses']) . "\n";
} else {
    echo 'Error: ' . $httpCode . "\n";
    echo $response;
}

curl_close($ch);
?>

使用JavaScript获取特定章节的经文

javascript

fetch('https://api.example.com/v1/chapters/1/verses?language=zh', {
    headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
    }
})
.then(response => {
    if (!response.ok) {
        throw new Error(`HTTP error! Status: ${response.status}`);
    }
    return response.json();
})
.then(data => {
    console.log(`Retrieved ${data.verses.length} verses from chapter ${data.chapter_number}`);
    // Process verses here
})
.catch(error => {
    console.error('Fetch error:', error);
});

常见问题

如何获取API密钥？

请访问API提供商的官方网站（https://quran.api-docs.io/）注册账户，并在开发者控制台中生成您的API密钥。

API支持哪些语言？

该API支持多种语言的古兰经翻译，包括阿拉伯语、英语、中文、法语等。具体支持的语言列表请查阅官方文档。

API请求频率有限制吗？

是的，API通常会有请求频率限制以保障服务稳定。具体的限制策略（如每分钟/每小时请求数）请参考官方文档的限速部分。