ڈویلپرز کے لیے قرآن API اور MCP سرور

قرآن گیلری کے ڈیٹا پر بنانے کے دو طریقے ہیں: ایک عوامی قرآن API اور AI اسسٹنٹس کے لیے MCP سرور۔ دونوں کا ڈیٹا الگ ہے اور قواعد بھی الگ، اس لیے یہ صفحہ انہیں الگ رکھتا ہے۔

قرآن API

قرآن API قرآن کا متن، تراجم، تفاسیر، تلاش اور آڈیو میٹا ڈیٹا ہمارے اپنے ڈیٹا بیس سے فراہم کرتی ہے۔ کوئی بھی مطالعے کا صفحہ کسی تیسرے فریق کی API پر منحصر نہیں۔ حوالہ ڈویلپرز کا صفحہ ہے۔

بنیادی پتہ https://qurangallery.com/quran/api/quran ہے۔ جوابات وہی v4 ساخت اپناتے ہیں جس کی زیادہ تر قرآنی ٹولز توقع رکھتے ہیں۔ ڈویلپرز کا صفحہ یہ اینڈ پوائنٹس دستاویزی بناتا ہے:

اینڈ پوائنٹ	کیا لوٹاتا ہے
/chapters	تمام 114 سورتیں ان کے میٹا ڈیٹا کے ساتھ
/verses/by_chapter/:id	ایک سورت کی آیات
/search	تراجم میں مکمل متن کی تلاش
/resources/recitations	دستیاب قاری اور آڈیو فائلیں
/resources/translations	دستیاب تراجم، تمام زبانوں میں

یہ معمول کے کوئری پیرامیٹرز لیتے ہیں: language، translations، words اور page۔ مثال کے طور پر https://qurangallery.com/quran/api/quran/chapters سورتوں کی فہرست دیتا ہے۔

ذخیرے میں چھ رسم الخط کی اقسام میں مکمل قرآن، 150 تراجم، 23 تفاسیر اور ہر مصحف میں ہر لفظ کا صفحہ اور سطر کا مقام شامل ہے۔

کلیدیں، حدود اور لائسنس

• تصدیق۔ قرآن API کا روٹ نہ کلید چیک کرتا ہے نہ سائن اِن۔ اسے کال کرنے کے لیے اکاؤنٹ درکار نہیں۔
• ریٹ کی حدود۔ ڈویلپرز کا صفحہ قرآن API کے لیے کوئی حد شائع نہیں کرتا۔ درخواستیں اعتدال میں رکھیں اور جو حاصل کریں اسے کیش کریں۔ ایک پوری سورت کا جواب کئی میگا بائٹ کا ہو سکتا ہے۔
• لائسنس۔ تمام ڈیٹا کے لیے ایک لائسنس نہیں ہے۔ ہر ماخذ اپنی شرائط درج کرتا ہے، اور ذرائع کا صفحہ انہیں دکھاتا ہے۔ جن ماخذ کی دوبارہ تقسیم جائز نہیں انہیں بالکل پیش نہیں کیا جاتا؛ ایپ اس کی جگہ حوالہ دکھاتی ہے۔ کسی ترجمے یا تفسیر کو دوبارہ استعمال کرنے سے پہلے اس کا ماخذ دیکھ لیں۔

MCP سرور

MCP سرور AI اسسٹنٹس کے لیے ہے۔ یہ کلاسیکی عربی کتابوں کی مکتبہ شاملہ میں تلاش کرتا ہے اور طبع، جلد اور صفحے کے ساتھ لفظ بہ لفظ اقتباسات لوٹاتا ہے۔

• پتہ: https://qurangallery.com/mcp/shamela۔
• شروع کرنے کے لیے کلید کی ضرورت نہیں۔ بغیر کلید کے آپ کو فی IP ایڈریس فی منٹ 10 اور روزانہ 200 ٹول کالز ملتی ہیں۔ مفت کلید فی منٹ 60 درخواستیں دیتی ہے۔ اسے اپنے اکاؤنٹ میں Developers صفحے پر بنائیں؛ دیکھیں API کلیدیں۔
• تمام ٹولز صرف پڑھنے کے لیے ہیں، اور کوئریز عربی میں ہونی چاہئیں۔

باقی MCP دستاویزات میں ہے: یہ کیا کرتا ہے، شروعات، ٹولز کی فہرست اور حدود اور غلطیاں۔

کیا دستیاب نہیں

• MCP کے ذریعے قرآن کا متن۔ MCP سرور کلاسیکی کتابوں میں تلاش کرتا ہے، قرآنی ذخیرے میں نہیں۔ قرآن کے متن کے لیے قرآن API استعمال کریں۔
• قرآن API کے ذریعے کتابیں۔ قرآن API مکتبہ شاملہ فراہم نہیں کرتی۔
• اکاؤنٹ کا ڈیٹا۔ بک مارکس، نوٹس اور پیش رفت سائن اِن صارفین کے لیے ایپس کے اپنے اینڈ پوائنٹس سے محفوظ ہوتے ہیں۔ ڈویلپرز کا صفحہ انہیں عوامی API کے طور پر دستاویزی نہیں بناتا۔
• تلاوت کی آڈیو فائلیں۔ ہم قاریوں اور فائلوں کے پتے درج کرتے ہیں۔ آڈیو خود QuranCDN سے چلتی ہے۔
• روکے گئے ماخذ۔ جن ماخذ پر دوبارہ تقسیم کے ناقابل ہونے کا نشان ہے ان کا متن کبھی نہیں لوٹایا جاتا۔
• کتابوں کی بڑے پیمانے پر برآمد اور حدیث کی درجہ بندی۔ MCP سرور صفحات ایک وقت میں ایک کال سے، ریٹ حد کے ساتھ لوٹاتا ہے، اور کسی حدیث کی درجہ بندی نہیں کرتا۔
• SDK یا OpenAPI فائل۔ ایسی کوئی چیز دستاویزی نہیں۔

رسائی کیسے مانگیں

قرآن API یا بغیر کلید والے MCP درجے کے لیے رسائی مانگنے کی ضرورت نہیں۔ MCP کی زیادہ حد کے لیے اوپر کی طرح مفت کلید بنائیں۔ باقی ہر بات کے لیے، جیسے زیادہ استعمال، کوئی غائب اینڈ پوائنٹ یا لائسنس کا سوال، support@qurangallery.com پر لکھیں یا رابطے کا صفحہ استعمال کریں۔