API Bible Atlas
API này là công khai, miễn phí và không yêu cầu khóa API. Bản thân Bible Atlas sử dụng API này trên trang web của mình và như một phần mở rộng trên các nền tảng khác. Mục tiêu của API này là giúp các nhà phát triển dễ dàng kết nối người, địa điểm, sự kiện và hình ảnh trực quan với bất kỳ câu Kinh Thánh nào, và nhúng chúng vào ứng dụng của riêng họ. API được thiết kế đơn giản và trực quan, với các điểm cuối rõ ràng và phản hồi nhất quán, vì vậy bạn có thể xây dựng bất kỳ loại ứng dụng khách nào với dữ liệu bạn cần.
Một yêu cầu cho mỗi lựa chọn
Mã sách gồm ba chữ cái theo chuẩn USFM . Truyền nhiều số câu để nhận một kết quả gộp, đã loại bỏ trùng lặp, cho toàn bộ phần đã chọn.
GET /api/v1/verse-context?usfm=GEN&chapter=9&verses=8,9 Mỗi thực thể và hình ảnh trực quan đều đi kèm với liên kết trang riêng, hình ảnh cho thẻ và đường dẫn nhúng sẵn sàng cho iframe.
{
"reference": "Genesis 9:8-9",
"entities": [
{
"type": "event",
"name": "God makes a covenant with Noah",
"href": "/god-makes-a-covenant-with-noah",
"embed": { "path": "/embed/graph/god-makes-a-covenant-with-noah" }
},
{ "type": "person", "name": "God", "href": "/god" },
{ "type": "person", "name": "Noah", "href": "/noah" }
],
"visualizations": [
{ "label": "Cross references", "href": "/visualizations/cross-references?ref=Gen.9.8" },
{ "label": "The Noahic Covenant", "href": "/visualizations/covenants#covenant-noahic" }
]
} Hiển thị một thẻ
Mỗi thực thể và hình ảnh trực quan trong phản hồi đều có liên kết trang và hình ảnh minh họa, đó là tất cả những gì một thẻ cần có.
GET /api/v1/verse-context?usfm=GEN&chapter=9&verses=8,9 <a href="https://bible-atlas.com/noah">
<img src="https://bible-atlas.com/og/person.png" alt="" />
<span>Noah</span>
</a> 
Nhúng trực tiếp câu Kinh Thánh
Bạn có thể nhúng bất kỳ câu Kinh Thánh nào trực tiếp vào ứng dụng của mình bằng iframe. Chỉ cần trỏ iframe đến URL của câu Kinh Thánh, và Bible Atlas sẽ hiển thị phần nhúng phù hợp nhất cho câu Kinh Thánh đó. Phần nhúng sẽ tự động lấp đầy chiều rộng của vùng chứa và bao gồm tham chiếu câu Kinh Thánh, các thực thể liên quan và hình ảnh trực quan. Bạn cũng có thể tùy chỉnh phần nhúng bằng các tham số truy vấn, chẳng hạn như ?theme=dark cho chế độ tối hoặc ?height=500 để thiết lập chiều cao 500 pixel.
GET /vi/embed/verse/{book}/{chapter}/{verse} <iframe src="https://bible-atlas.com/vi/embed/verse/genesis/9/8"></iframe> Khung iframe đang hoạt động. Sáng-thế Ký 9:8 dẫn đến đồ thị giao ước của Đức Chúa Trời với Nô-ê.
Dòng lệnh
Gói bible-atlas bọc API để dùng trong tập lệnh và tác nhân. Gói xuất JSON, không cần khóa và chạy trên Node.js 20 trở lên. Lỗi được ghi vào stderr dưới dạng code: message, với mã thoát khác không.
npx bible-atlas verse GEN 9 8 Sử dụng từ Claude Code
Thêm Bible Atlas làm máy chủ MCP để tìm kiếm dữ liệu về Kinh Thánh, con người, địa điểm và lịch sử từ Claude Code.
claude mcp add --transport http bible-atlas https://bible-atlas.com/mcp