Bible Atlas এপিআই

এই এপিআইটি পাবলিক, বিনামূল্যে এবং এর জন্য কোনো এপিআই কী-এর প্রয়োজন নেই। Bible Atlas নিজেই এই ওয়েবসাইটে এবং অন্যান্য প্ল্যাটফর্মে একটি এক্সটেনশন হিসেবে এই এপিআইটি ব্যবহার করে। এই এপিআই-এর লক্ষ্য হলো ডেভেলপারদের জন্য যেকোনো বাইবেলের পদের সাথে সংযুক্ত ব্যক্তি, স্থান, ঘটনা এবং ভিজ্যুয়ালাইজেশন সহজে সংগ্রহ করা এবং সেগুলোকে তাদের নিজস্ব অ্যাপে এম্বেড করা সম্ভব করে তোলা। এপিআইটি সহজ এবং স্বজ্ঞাতভাবে ডিজাইন করা হয়েছে, যেখানে সুস্পষ্ট এন্ডপয়েন্ট এবং সামঞ্জস্যপূর্ণ প্রতিক্রিয়া রয়েছে, যাতে আপনি আপনার প্রয়োজনীয় ডেটা দিয়ে যেকোনো ধরনের ক্লায়েন্ট অ্যাপ্লিকেশন তৈরি করতে পারেন।

প্রতিটি নির্বাচনের জন্য একটি অনুরোধ

বইয়ের কোড হলো তিন অক্ষরের USFM কোড। পুরো নির্বাচনের জন্য একটি একীভূত, পুনরাবৃত্তিহীন উত্তর পেতে একাধিক পদ নম্বর দিন।

GET /api/v1/verse-context?usfm=GEN&chapter=9&verses=8,9

প্রতিটি সত্তা এবং ভিজ্যুয়ালাইজেশনের সাথে তার নিজস্ব পেজ লিঙ্ক, কার্ডের জন্য একটি ছবি এবং আইফ্রেমের জন্য প্রস্তুত একটি এমবেড পাথ থাকে।

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

একটি কার্ড তৈরি করুন

প্রতিক্রিয়ার প্রতিটি সত্তা এবং ভিজ্যুয়ালাইজেশনে একটি পেজ লিঙ্ক ও একটি ছবি থাকে, যা একটি কার্ডের জন্য প্রয়োজনীয় সবকিছু।

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>

পদটি সরাসরি এমবেড করুন

আপনি একটি আইফ্রেমের মাধ্যমে যেকোনো পদ সরাসরি আপনার অ্যাপে এম্বেড করতে পারেন। শুধু আইফ্রেমটিকে পদটির ইউআরএল-এর দিকে নির্দেশ করুন, এবং Bible Atlas সেই পদটির জন্য উপলব্ধ সেরা এম্বেডটি প্রদর্শন করবে। এম্বেডটি স্বয়ংক্রিয়ভাবে তার কন্টেইনারের প্রস্থ পূরণ করে এবং এতে পদের রেফারেন্স, সম্পর্কিত সত্তা এবং ভিজ্যুয়ালাইজেশন অন্তর্ভুক্ত থাকে। এছাড়াও আপনি কোয়েরি প্যারামিটার ব্যবহার করে এম্বেডটি কাস্টমাইজ করতে পারেন, যেমন— ?theme=dark ডার্ক মোডের জন্য অথবা ?height=500 ৫০০ পিক্সেল উচ্চতা নির্ধারণ করতে।

GET /embed/verse/{book}/{chapter}/{verse}
<iframe src="https://bible-atlas.com/embed/verse/genesis/9/8"></iframe>
yourapp.com/read/genesis/9

ঐ আইফ্রেমটি সরাসরি সম্প্রচারিত হচ্ছে। আদিপুস্তক ৯:৮ পদটি নোহের সঙ্গে ঈশ্বরের নিয়ম লেখচিত্রে গিয়ে শেষ হয়।

কমান্ড লাইন

প্যাকেজ bible-atlas স্ক্রিপ্ট ও এজেন্টের জন্য API-কে সহজে ব্যবহারযোগ্য করে। এটি JSON প্রিন্ট করে, কোনো কী লাগে না এবং Node.js 20 বা তার নতুন সংস্করণে চলে। ত্রুটিগুলো stderr-এ এই আকারে যায় code: message, আর প্রস্থান কোড শূন্য থাকে না।

npx bible-atlas verse GEN 9 8

আপনি কী মনে করেন?

অনুগ্রহ করে Bible Atlas উন্নত করতে আমাদের সাহায্য করুন: যেকোনো সমস্যা বা অনুপস্থিত সুবিধার কথা আমাদের জানান। আমরা প্রতিটি বার্তা পড়ি এবং আপনার সময়ের জন্য কৃতজ্ঞ!