Free Use Bible API
መመሪያ
ማጣቀሻ
SDKዎች
GitHub
ይለግሱ
  • English
  • Afrikaans
  • አማርኛ
  • العربية
  • বাংলা
  • Deutsch
  • Español
  • Français
  • Hausa
  • हिन्दी
  • Bahasa Indonesia
  • Italiano
  • 日本語
  • Português
  • Русский
  • Kiswahili
  • اردو
  • 简体中文
  • isiZulu
መመሪያ
ማጣቀሻ
SDKዎች
GitHub
ይለግሱ
  • English
  • Afrikaans
  • አማርኛ
  • العربية
  • বাংলা
  • Deutsch
  • Español
  • Français
  • Hausa
  • हिन्दी
  • Bahasa Indonesia
  • Italiano
  • 日本語
  • Português
  • Русский
  • Kiswahili
  • اردو
  • 简体中文
  • isiZulu
  • ማጣቀሻ

    • ኤፒአይ
    • ትርጉሞች፣ መጻሕፍት እና ምዕራፎች

      • ትርጉሞች፣ መጻሕፍት እና ምዕራፎች
      • መደበኛ ቅርጸት
      • ቀለል ያለ ቅርጸት
    • ማብራሪያዎች

      • አስተያየቶች
    • የውሂብ ስብስቦች

      • የውሂብ ስብስቦች
    • ክፍት ኤፒአይ

ትርጉሞች፣ መጻሕፍት እና ምዕራፎች

የትርጉም ማሰስ፣ መጽሐፎቻቸውን መዘርዘር እና የምዕራፍ ይዘትን ማምጣት የመጨረሻ ነጥቦች።

የምዕራፍ ይዘት፣ የተሟላ የትርጉም ውርዶች እና የቃላት ደረጃ ማብራሪያዎች እያንዳንዳቸው በሁለት ቅርጸቶች ይገኛሉ፡

  • መደበኛ ቅርጸት - የመጀመሪያው፣ የተዋቀረ ቅርጸት። የጥቅሱ ይዘት እርስዎ እራስዎ የሚያሰባስቡዋቸው የቁራጭ ዝርዝሮች (ግልጽ ጽሑፍ፣ የተቀረጸ ጽሑፍ፣ የግርጌ ማስታወሻ ማጣቀሻዎች፣ ወዘተ) ናቸው።
  • ቀለል ያለ ቅርጸት - የእያንዳንዱ ጥቅስ ይዘት አንድ ነጠላ ሕብረቁምፊ የሆነበት፣ የግርጌ ማስታወሻዎች፣ ግጥም እና ሌሎች ማርከሮች በዚያ ሕብረቁምፊ ውስጥ እንደ ማካካሻዎች የተገለጹበት ጠፍጣፋ ቅርጸት።

ጽሑፉን እንዴት እንደሚያቀርቡ ወይም እንደሚያስኬዱ በተሻለ ሁኔታ የሚስማማውን ቅርጸት ይጠቀሙ።

የሚገኙ ትርጉሞች

GET https://bible.helloao.org/api/available_translations.json

በኤፒአይ ውስጥ የሚገኙ የትርጉም ዝርዝሮችን ያገኛል።

የኮድ ምሳሌ

ጃቫስክሪፕት
fetch-translations.js
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

መዋቅር

available-translations.ts
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;
}

ለምሳሌ

/api/available_translations.json
{
    "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 )።

የኮድ ምሳሌ

ጃቫስክሪፕት
fetch-books.js
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

መዋቅር

books.ts
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;
}

ለምሳሌ

/api/BSB/books.json
{
    "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
        },
    ]
}
Next
መደበኛ ቅርጸት