ትርጉሞች፣ መጻሕፍት እና ምዕራፎች
የትርጉም ማሰስ፣ መጽሐፎቻቸውን መዘርዘር እና የምዕራፍ ይዘትን ማምጣት የመጨረሻ ነጥቦች።
የምዕራፍ ይዘት፣ የተሟላ የትርጉም ውርዶች እና የቃላት ደረጃ ማብራሪያዎች እያንዳንዳቸው በሁለት ቅርጸቶች ይገኛሉ፡
- መደበኛ ቅርጸት - የመጀመሪያው፣ የተዋቀረ ቅርጸት። የጥቅሱ ይዘት እርስዎ እራስዎ የሚያሰባስቡዋቸው የቁራጭ ዝርዝሮች (ግልጽ ጽሑፍ፣ የተቀረጸ ጽሑፍ፣ የግርጌ ማስታወሻ ማጣቀሻዎች፣ ወዘተ) ናቸው።
- ቀለል ያለ ቅርጸት - የእያንዳንዱ ጥቅስ ይዘት አንድ ነጠላ ሕብረቁምፊ የሆነበት፣ የግርጌ ማስታወሻዎች፣ ግጥም እና ሌሎች ማርከሮች በዚያ ሕብረቁምፊ ውስጥ እንደ ማካካሻዎች የተገለጹበት ጠፍጣፋ ቅርጸት።
ጽሑፉን እንዴት እንደሚያቀርቡ ወይም እንደሚያስኬዱ በተሻለ ሁኔታ የሚስማማውን ቅርጸት ይጠቀሙ።
የሚገኙ ትርጉሞች
GET https://bible.helloao.org/api/available_translations.json
በኤፒአይ ውስጥ የሚገኙ የትርጉም ዝርዝሮችን ያገኛል።
የኮድ ምሳሌ
ጃቫስክሪፕት
fetch(`https://bible.helloao.org/api/available_translations.json`)
.then(request => request.json())
.then(availableTranslations => {
console.log('The API has the following translations:', availableTranslations);
});cURL
curl https://bible.helloao.org/api/available_translations.jsonመዋቅር
export interface AvailableTranslations {
/**
* የትርጉም ዝርዝር።
*/
translations: Translation[];
}
interface Translation {
/**
* የትርጉሙ መታወቂያ።
*/
id: string;
/**
* የትርጉሙ ስም።
* ይህ አብዛኛውን ጊዜ በትርጉሙ ቋንቋ የትርጉሙ ስም ነው።
*/
name: string;
/**
* የትርጉሙ የእንግሊዝኛ ስም።
*/
englishName: string;
/**
* የትርጉም ድረ-ገጽ።
*/
website: string;
/**
* የትርጉሙ ፈቃድ የሚገኝበት ዩአርኤል።
*/
licenseUrl: string;
/**
* የትርጉሙ አጭር ስም።
*/
shortName: string;
/**
* ትርጉሙ በዋናነት የተካተተበት የISO 639 ባለ 3-ፊደል ቋንቋ መለያ።
*/
language: string;
/**
* ትርጉሙ የተጻፈበትን ቋንቋ ስም ያገኛል።
* የቋንቋው ስም የማይታወቅ ከሆነ ባዶ ወይም ያልተገለጸ።
*/
languageName?: string;
/**
* የቋንቋውን ስም በእንግሊዝኛ ያገኛል።
* ቋንቋው የእንግሊዝኛ ስም ከሌለው ባዶ ወይም ያልተገለጸ።
*/
languageEnglishName?: string;
/**
* ቋንቋው የተጻፈበት አቅጣጫ።
* "ltr" የሚለው ጽሑፍ የተጻፈው ከገጹ ግራ በኩል ወደ ቀኝ መሆኑን ያመለክታል።
* "rtl" የሚለው ጽሑፍ የተጻፈው ከገጹ ቀኝ በኩል ወደ ግራ መሆኑን ያመለክታል።
*/
textDirection: 'ltr' | 'rtl';
/**
* የሚገኙ የቅርጸቶች ዝርዝር።
*/
availableFormats: ('json' | 'usfm')[];
/**
* ለዚህ ትርጉም የሚገኙ መጽሐፍት ዝርዝር የኤፒአይ ሊንክ።
*/
listOfBooksApiLink: string;
/**
* በዚህ ትርጉም ውስጥ የተካተቱት መጻሕፍት ብዛት።
*
* የተሟሉ ትርጉሞች ከመጽሐፍ ቅዱስ ጋር ተመሳሳይ የመጻሕፍት ብዛት ሊኖራቸው ይገባል (66)።
*/
numberOfBooks: number;
/**
* በዚህ ትርጉም ውስጥ የተካተቱት ጠቅላላ የምዕራፎች ብዛት።
*
* የተሟሉ ትርጉሞች ከመጽሐፍ ቅዱስ ጋር ተመሳሳይ የምዕራፎች ብዛት ሊኖራቸው ይገባል (1,189)።
*/
totalNumberOfChapters: number;
/**
* በዚህ ትርጉም ውስጥ የተካተቱት ጠቅላላ የጥቅሶች ብዛት።
*
* የተሟሉ ትርጉሞች ከመጽሐፍ ቅዱስ ጋር ተመሳሳይ የሆኑ የጥቅሶች ብዛት ሊኖራቸው ይገባል (ወደ 31,102 አካባቢ - አንዳንድ ትርጉሞች በዋናው ምንጭ ጽሑፎች ውስጥ ሊኖር በሚችለው ግልጽ ዕድል ላይ የተመሰረቱትን ጥቅሶችን አያካትቱም)።
*/
totalNumberOfVerses: number;
/**
* በዚህ ትርጉም ውስጥ የተካተቱት የአዋልድ መጻሕፍት ጠቅላላ ብዛት።
* ትርጉሙ አፖክሪፋን የማያካትት ከሆነ ተትቷል።
*/
numberOfApocryphalBooks?: number;
/**
* በዚህ ትርጉም ውስጥ የተካተቱት የአዋልድ ምዕራፎች ጠቅላላ ብዛት።
* ትርጉሙ አፖክሪፋን የማያካትት ከሆነ ተትቷል።
*/
totalNumberOfApocryphalChapters?: number;
/**
* በዚህ ትርጉም ውስጥ የተካተቱት የአዋልድ ጥቅሶች ጠቅላላ ብዛት።
* ትርጉሙ አፖክሪፋን የማያካትት ከሆነ ተትቷል።
*/
totalNumberOfApocryphalVerses?: number;
}ለምሳሌ
{
"translations": [
{
"id": "BSB",
"name": "Berean Standard Bible",
"website": "https://berean.bible/",
"licenseUrl": "https://berean.bible/",
"shortName": "BSB",
"englishName": "Berean Standard Bible",
"language": "eng",
"textDirection": "ltr",
"availableFormats": [
"json"
],
"listOfBooksApiLink": "/api/BSB/books.json",
"numberOfBooks": 66,
"totalNumberOfChapters": 1189,
"totalNumberOfVerses": 31086,
"languageName": "English",
"languageEnglishName": "English"
}
]
}በትርጉም ውስጥ መጽሐፍትን ዘርዝር
GET https://bible.helloao.org/api/{translation}/books.json
ለተሰጠው ትርጉም የሚገኙ መጻሕፍትን ዝርዝር ያገኛል።
translationየትርጉሙ መለያ ነው (ለምሳሌBSB)።
የኮድ ምሳሌ
ጃቫስክሪፕት
const translation = 'BSB';
// የቢኤስቢ ትርጉም የመጽሐፍት ዝርዝር ያግኙ
fetch(`https://bible.helloao.org/api/${translation}/books.json`)
.then(request => request.json())
.then(books => {
console.log('The BSB has the following books:', books);
});cURL
curl https://bible.helloao.org/api/BSB/books.jsonመዋቅር
export interface TranslationBooks {
/**
* የመጽሐፉ የትርጉም መረጃ።
*/
translation: Translation;
/**
* ለትርጉም ሊገኙ የሚችሉ መጻሕፍት ዝርዝር።
*/
books: TranslationBook[];
}
interface TranslationBook {
/**
* የመጽሐፉ መታወቂያ።
*/
id: string;
/**
* ትርጉሙ ለመጽሐፉ የሰጠው ስም።
*/
name: string;
/**
* የመጽሐፉ የተለመደ ስም።
*/
commonName: string;
/**
* የመጽሐፉ ርዕስ።
* ይህ ብዙውን ጊዜ የመጽሐፉን ስም የበለጠ ገላጭ ስሪት ነው።
* የማይገኝ ከሆነ፣ በትርጉሙ አንድ አልቀረበም።
*/
title: string | null;
/**
* በትርጉሙ ውስጥ የመጽሐፉ የቁጥር ቅደም ተከተል።
*/
order: number;
/**
* መጽሐፉ የያዘው የምዕራፍ ብዛት።
*/
numberOfChapters: number;
/**
* በመጽሐፉ ውስጥ የመጀመሪያው ምዕራፍ ቁጥር።
*/
firstChapterNumber: number;
/**
* ወደ መጽሐፉ የመጀመሪያ ምዕራፍ የሚወስድ አገናኝ።
*/
firstChapterApiLink: string;
/**
* በመጽሐፉ ውስጥ የመጨረሻው ምዕራፍ ቁጥር።
*/
lastChapterNumber: number;
/**
* ወደ መጽሐፉ የመጨረሻ ምዕራፍ የሚወስድ አገናኝ።
*/
lastChapterApiLink: string;
/**
* መጽሐፉ የያዘው የቁጥሮች ብዛት።
*/
totalNumberOfVerses: number;
/**
* መጽሐፉ የአዋልድ መጽሐፍ ይሁን።
* ትርጉሙ ቀኖናዊ ከሆነ ተትቷል።
*/
isApocryphal?: boolean;
}ለምሳሌ
{
"translation": {
"id": "BSB",
"name": "Berean Standard Bible",
"website": "https://berean.bible/",
"licenseUrl": "https://berean.bible/",
"shortName": "BSB",
"englishName": "Berean Standard Bible",
"language": "eng",
"textDirection": "ltr",
"availableFormats": [
"json"
],
"listOfBooksApiLink": "/api/BSB/books.json",
"numberOfBooks": 66,
"totalNumberOfChapters": 1189,
"totalNumberOfVerses": 31086,
"languageName": "English",
"languageEnglishName": "English"
},
"books": [
{
"id": "GEN",
"translationId": "BSB",
"name": "Genesis",
"commonName": "Genesis",
"title": "Genesis",
"order": 1,
"numberOfChapters": 50,
"firstChapterNumber": 1,
"firstChapterApiLink": "/api/BSB/GEN/1.json",
"lastChapterNumber": 50,
"lastChapterApiLink": "/api/BSB/GEN/50.json",
"totalNumberOfVerses": 1533
},
]
}