Free Use Bible API
Jagora
Nassoshi
SDKs
GitHub
Tallafi
  • English
  • Afrikaans
  • አማርኛ
  • العربية
  • বাংলা
  • Deutsch
  • Español
  • Français
  • Hausa
  • हिन्दी
  • Bahasa Indonesia
  • Italiano
  • 日本語
  • Português
  • Русский
  • Kiswahili
  • اردو
  • 简体中文
  • isiZulu
Jagora
Nassoshi
SDKs
GitHub
Tallafi
  • English
  • Afrikaans
  • አማርኛ
  • العربية
  • বাংলা
  • Deutsch
  • Español
  • Français
  • Hausa
  • हिन्दी
  • Bahasa Indonesia
  • Italiano
  • 日本語
  • Português
  • Русский
  • Kiswahili
  • اردو
  • 简体中文
  • isiZulu
  • Nassoshi

    • API
    • Fassara, Littattafai, & Babi-babi
      • Tsarin Daidaitacce
      • Tsarin da aka Sauƙaƙa
    • Sharhi
    • Saitunan Bayanai
      • Yarjejeniyar Aya ta Rana
    • Buɗe API

Fassara, Littattafai, & Babi-babi

Maƙallan ƙarshe don bincika fassarorin, jera littattafansu, da kuma ɗaukar abubuwan da ke cikin babi.

Abubuwan da ke cikin babi, sauke cikakken fassarar, da kuma bayanin da ke cikin matakin kalmomi kowannensu yana samuwa a cikin tsari biyu:

  • Tsarin da aka saba - tsarin asali, tsari mai tsari. Abubuwan da ke cikin baiti jerin guntu ne (rubutu mai sauƙi, rubutu mai tsari, nassoshi na ƙasa, da sauransu) da kuka haɗa kanku.
  • Tsarin Sauƙi - tsari mai faɗi inda abubuwan da ke cikin kowace baiti suka kasance igiya ɗaya, tare da ƙananan bayanai, waƙoƙi, da sauran alamomi da aka bayyana a matsayin abubuwan da suka dace a cikin wannan zaren.

Yi amfani da duk wani tsari da ya fi dacewa da yadda kake shirin yin rubutu ko sarrafa shi.

Fassarorin da ake da su

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

Yana samun jerin fassarorin da ake da su a cikin API.

Misalin Lambar

cURL
curl https://bible.helloao.org/api/available_translations.json

Tsarin gini

available-translations.ts
export interface AvailableTranslations {
    /**
     * Jerin fassarorin.
     */
    translations: Translation[];
}

interface Translation {
    /**
     * ID na fassarar.
     */
    id: string;

    /**
     * Sunan fassarar.
     * Wannan yawanci shine sunan fassarar a cikin harshen fassarar.
     */
    name: string;

    /**
     * Sunan fassarar Turanci.
     */
    englishName: string;

    /**
     * Shafin yanar gizo na fassarar.
     */
    website: string;

    /**
     * Ana iya samun URL ɗin da lasisin fassarar zai iya samu.
     */
    licenseUrl: string;

    /**
     * Bayanan da aka ƙara ta API don lasisin.
     * Ba a fayyace ko ba a fayyace ba idan babu bayanin kula.
     */
    licenseNotes?: string | null;

    /**
     * Sanarwar da ya kamata a nuna yayin nuna abubuwan da ke cikin fassarar.
     * Ba a fayyace ko ba a fayyace ba idan fassarar ba ta da sanarwa.
     */
    licenseNotice?: string | null;

    /**
     * Sharuɗɗan lasisin da aka gano don fassarar.
     * Ba a tantance ko ba a fayyace ba idan ba za a iya tantance sharuɗɗan ba.
     * A wannan yanayin, duba shafin a licenseUrl don sharuɗɗan.
     */
    license?: License | null;

    /**
     * Gajeren sunan fassarar.
     */
    shortName: string;

    /**
     * Alamar harshen ISO 639 mai haruffa 3 da fassarar ta fi yawa.
     */
    language: string;

    /**
     * Yana samun sunan harshen da fassarar take ciki.
     * Ba a san ko an bayyana sunan harshen ba.
     */
    languageName?: string;

    /**
     * Yana samun sunan harshen a cikin Turanci.
     * Ba a fayyace ko ba a fayyace ba idan harshen ba shi da sunan Turanci.
     */
    languageEnglishName?: string;

    /**
     * Alkiblar da aka rubuta harshen a ciki.
     * "ltr" yana nuna cewa an rubuta rubutun daga gefen hagu na shafin zuwa dama.
     * "rtl" yana nuna cewa an rubuta rubutun daga gefen dama na shafin zuwa hagu.
     */
    textDirection: 'ltr' | 'rtl';

    /**
     * Jerin tsare-tsare da ake da su.
     */
    availableFormats: ('json' | 'usfm')[];

    /**
     * Hanyar API don jerin littattafan da ake da su don wannan fassarar.
     */
    listOfBooksApiLink: string;

    /**
     * Adadin littattafan da ke cikin wannan fassarar.
     *
     * Cikakkun fassarori ya kamata su kasance daidai da adadin littattafai na Littafi Mai Tsarki (66).
     */
    numberOfBooks: number;

    /**
     * Jimillar surori da ke cikin wannan fassarar.
     *
     * Cikakkun fassarori ya kamata su kasance daidai da adadin surori na Littafi Mai Tsarki (1,189).
     */
    totalNumberOfChapters: number;

    /**
     * Jimillar ayoyin da ke cikin wannan fassarar.
     *
     * Cikakkun fassarori yakamata su kasance daidai da adadin ayoyi kamar na Littafi Mai Tsarki (kusan 31,102 - wasu fassarori ba su haɗa da ayoyi bisa ga yuwuwar kasancewarsu a cikin rubutun asali ba).
     */
    totalNumberOfVerses: number;

    /**
     * Jimillar littattafan apocrypha da ke cikin wannan fassarar.
     * An yi watsi da fassarar idan fassarar ba ta haɗa da apocrypha ba.
     */
    numberOfApocryphalBooks?: number;

    /**
     * Jimillar surori na apocrypha da ke cikin wannan fassarar.
     * An yi watsi da fassarar idan fassarar ba ta haɗa da apocrypha ba.
     */
    totalNumberOfApocryphalChapters?: number;

    /**
     * jimillar ayoyin apokrifa da ke cikin wannan fassarar.
     * An yi watsi da fassarar idan fassarar ba ta haɗa da apocrypha ba.
     */
    totalNumberOfApocryphalVerses?: number;
}

/**
 * Yana bayyana sharuɗɗan lasisin da aka tsara waɗanda aka gano don fassarar.
 */
interface License {
    /**
     * Ko ana buƙatar danganta asalin tushen yayin amfani da fassarar.
     */
    attribution: 'required' | 'not-required';

    /**
     * Ko an yarda a yi amfani da fassarar ta kasuwanci.
     */
    commercialUse: 'allowed' | 'not-allowed';

    /**
     * Ko an yarda a ƙirƙiri da kuma rarraba ayyukan fassarar da aka samo asali.
     */
    derivatives: 'allowed' | 'not-allowed';

    /**
     * Ko ayyukan da aka samo asali dole ne a rarraba su a ƙarƙashin lasisi ɗaya (watau buƙatar "daidai-dai-dai").
     */
    copyleft: boolean;

    /**
     * Ko an sadaukar da fassarar ga jama'a.
     */
    publicDomain: boolean;
}

Lasisi

Kowace fassara ana buga ta ne a ƙarƙashin lasisin ta, don haka duba sharuɗɗan fassarar kafin ka yi amfani da ita.

  • licenseUrl koyaushe yana haɗi zuwa cikakkun sharuɗɗan lasisi.
  • licenseNotice , idan akwai, shine sanarwar haƙƙin mallaka ko bayanin martaba da za a nuna tare da abubuwan da ke cikin fassarar.
  • licenseNotes ya ƙunshi bayanan da API ya ƙara, kamar canje-canje da aka yi wa rubutun tushe.
  • license , idan akwai, yana taƙaita sharuɗɗan a cikin hanyar da lambar ku za ta iya dubawa. Misali, zaku iya tace jerin zuwa fassarorin da ke ba da damar amfani da kasuwanci:
commercial-translations.js
fetch(`https://bible.helloao.org/api/available_translations.json`)
    .then(request => request.json())
    .then(({ translations }) => {
        const commercial = translations.filter(
            t => t.license?.commercialUse === 'allowed'
        );
        console.log('Translations that allow commercial use:', commercial);
    });

Ana saita license ne kawai lokacin da za a iya gano sharuɗɗan ta atomatik. Fassarar da ba ta da ita na iya ba da damar amfani da ita, don haka karanta shafin da ke licenseUrl don waɗannan.

Misali

/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"
        }
    ]
}

Jera Littattafai a Fassara

GET https://bible.helloao.org/api/{translation}/books.json

Yana samun jerin littattafan da ake da su don fassarar da aka bayar.

  • translation shine ID na fassarar (misali BSB ).

Misalin Lambar

cURL
curl https://bible.helloao.org/api/BSB/books.json

Tsarin gini

books.ts
export interface TranslationBooks {
    /**
     * Bayanin fassara ga littattafan.
     */
    translation: Translation;

    /**
     * Jerin littattafan da ake da su don fassara.
     */
    books: TranslationBook[];
}

interface TranslationBook {
    /**
     * ID na littafin.
     */
    id: string;

    /**
     * Sunan da fassarar ta bayar ga littafin.
     */
    name: string;

    /**
     * Sunan da aka saba amfani da shi a littafin.
     */
    commonName: string;

    /**
     * Gajeren suna (gajarta) da fassarar ta tanadar wa littafin.
     * Idan babu, to fassarar ba ta bayar da ɗaya ba.
     */
    shortName?: string;

    /**
     * Sunan littafin.
     * Wannan yawanci sigar da ta fi bayyana sunan littafin ce.
     * Idan babu, to fassarar ba ta bayar da ɗaya ba.
     */
    title: string | null;

    /**
     * Tsarin lambobi na littafin a cikin fassarar.
     */
    order: number;

    /**
     * Adadin surori da littafin ya ƙunsa.
     */
    numberOfChapters: number;

    /**
     * Adadin babi na farko a cikin littafin.
     */
    firstChapterNumber: number;

    /**
     * Hanyar haɗi zuwa babi na farko na littafin.
     */
    firstChapterApiLink: string;

    /**
     * Adadin babi na ƙarshe a cikin littafin.
     */
    lastChapterNumber: number;

    /**
     * Hanyar haɗi zuwa babi na ƙarshe na littafin.
     */
    lastChapterApiLink: string;

    /**
     * Adadin ayoyin da littafin ya kunsa.
     */
    totalNumberOfVerses: number;

    /**
     * Ko littafin littafin apokrifa ne?
     * An yi watsi da fassarar idan fassarar ta kasance ta canonical.
     */
    isApocryphal?: boolean;
}

Misali

/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",
            "shortName": "Gen",
            "title": "Genesis",
            "order": 1,
            "numberOfChapters": 50,
            "firstChapterNumber": 1,
            "firstChapterApiLink": "/api/BSB/GEN/1.json",
            "lastChapterNumber": 50,
            "lastChapterApiLink": "/api/BSB/GEN/50.json",
            "totalNumberOfVerses": 1533
        },
    ]
}
Prev
API
Next
Sharhi