薄伽梵歌泰卢固语API

接入教程

1. 访问官网https://gita-api.vercel.app查看文档
2. 选择泰卢固语或奥迪亚语作为查询参数
3. 调用相应接口获取经文章节
4. 解析返回的JSON格式数据
5. 集成到您的应用程序中使用

Python请求示例：获取章节列表

python

import requests

base_url = 'https://gita-api.vercel.app'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY'
}

# 获取所有章节
response = requests.get(f'{base_url}/chapters', 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

$baseUrl = 'https://gita-api.vercel.app';
$apiKey = 'YOUR_API_KEY';

$options = [
    'http' => [
        'header' => "Authorization: Bearer $apiKey\r\n",
        'method' => 'GET'
    ]
];

$context = stream_context_create($options);

// 获取第2章第47节诗句
$response = file_get_contents($baseUrl . '/verses/2/47', false, $context);

if ($response !== false) {
    $verse = json_decode($response, true);
    echo 'Verse retrieved successfully';
    print_r($verse);
} else {
    echo 'Failed to retrieve verse';
}
?>

JavaScript请求示例：搜索经文内容

javascript

const baseUrl = 'https://gita-api.vercel.app';
const apiKey = 'YOUR_API_KEY';

async function searchVerses(query, language = 'telugu') {
    try {
        const response = await fetch(
            `${baseUrl}/search?q=${encodeURIComponent(query)}&lang=${language}`,
            {
                headers: {
                    'Authorization': `Bearer ${apiKey}`,
                    'Content-Type': 'application/json'
                }
            }
        );
        
        if (!response.ok) {
            throw new Error(`HTTP error! status: ${response.status}`);
        }
        
        const results = await response.json();
        console.log(`Found ${results.length} verses matching "${query}"`);
        return results;
    } catch (error) {
        console.error('Search failed:', error);
        return [];
    }
}

// 使用示例
searchVerses('karma', 'telugu').then(results => {
    console.log(results);
});

常见问题

如何获取API密钥？

请访问官方网站 https://gita-api.vercel.app 并注册账户，在个人仪表板中可以生成和管理您的API密钥。免费套餐提供有限的请求次数，高级套餐可增加限额。

API支持哪些语言版本？

本API主要提供泰卢固语和奥迪亚语版本的《薄伽梵歌》内容。部分功能可能支持英语元数据查询，但经文内容以指定的印度语言为主。

请求频率是否有限制？

是的，API设有请求频率限制以保障服务稳定。免费套餐通常为每分钟60次请求，具体限制请参考官方文档。建议在客户端实现适当的请求缓存和错误重试机制。