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
  • संदर्भ

    • एपीआई
    • अनुवाद, पुस्तकें और अध्याय

      • अनुवाद, पुस्तकें और अध्याय
      • मानक प्रारूप
      • सरलीकृत प्रारूप
    • टीकाएँ

      • कमेंट्री
    • डेटासेट

      • डेटासेट
    • ओपनएपीआई

ओपनएपीआई

फ्री यूज़ बाइबल एपीआई एक ओपनएपीआई 3.1 दस्तावेज़ प्रकाशित करता है जो इस संदर्भ में प्रत्येक एंडपॉइंट का वर्णन करता है, साथ ही इसके पैरामीटर और प्रतिक्रिया संरचनाओं का भी।

GET https://bible.helloao.org/openapi.json

आप इस दस्तावेज़ का उपयोग निम्न कार्यों के लिए कर सकते हैं:

  • एक ऐसी भाषा के लिए क्लाइंट लाइब्रेरी बनाएं जिसके लिए हमारे पास SDK उपलब्ध नहीं है।
  • API को Postman , Insomnia या Swagger UI जैसे टूल में इम्पोर्ट करें ताकि आप एंडपॉइंट्स का पता लगा सकें।
  • प्रकाशित स्कीमाओं के आधार पर API प्रतिक्रियाओं का सत्यापन करें।

ग्राहक उत्पन्न करना

किसी भी OpenAPI-संगत कोड जनरेटर का उपयोग क्लाइंट उत्पन्न करने के लिए किया जा सकता है। उदाहरण के लिए, OpenAPI जनरेटर दर्जनों भाषाओं का समर्थन करता है।

# पायथन
npx @openapitools/openapi-generator-cli generate \
    -i https://bible.helloao.org/openapi.json \
    -g python \
    -o ./free-use-bible-api-python

# सी#
npx @openapitools/openapi-generator-cli generate \
    -i https://bible.helloao.org/openapi.json \
    -g csharp \
    -o ./free-use-bible-api-csharp

टाइपस्क्रिप्ट के लिए, आप @hey-api/openapi-ts उपयोग कर सकते हैं:

npx @hey-api/openapi-ts \
    -i https://bible.helloao.org/openapi.json \
    -o ./src/client

Tips

यदि आप जावास्क्रिप्ट या टाइपस्क्रिप्ट का उपयोग कर रहे हैं, तो शायद आपको अपना क्लाइंट स्वयं बनाने की आवश्यकता नहीं है। इसके बजाय जावास्क्रिप्ट/टाइपस्क्रिप्ट एसडीके देखें।

संचालन

ओपनएपीआई दस्तावेज़ में प्रत्येक एंडपॉइंट में operationId होता है, जिसका उपयोग अधिकांश जनरेटर जनरेटेड क्लाइंट में मेथड नाम के रूप में करते हैं। उदाहरण के लिए:

ऑपरेशन आईडीendpoint
getAvailableTranslations/api/available_translations.json
getTranslationBooks/api/{translation}/books.json
getTranslationBookChapter/api/{translation}/{book}/{chapter}.json
getAvailableCommentaries/api/available_commentaries.json
getAvailableDatasets/api/available_datasets.json

सभी कार्यों की पूरी सूची के लिए ओपनएपीआई दस्तावेज़ देखें।