edgepedia

Edgepedia

Edgepedia API

دائرۃ المعارف کے 500,000 سے زیادہ مضامین، جن میں مسلسل اضافہ ہو رہا ہے، JSON کی صورت میں۔ مفت۔ نہ کلید درکار، نہ اندراج۔ ماخذ کا حوالہ دے کر تجارتی استعمال کی اجازت۔ AI کی تربیت سب کے لیے کھلی ہے۔

آزما کر دیکھیے

پڑھنے کے روٹس GET استعمال کرتے ہیں؛ منتقلی، بیچز، اور آپ کا بھیجا ہوا متن POST استعمال کرتے ہیں۔ ہر روٹ کسی بھی پروگرام یا ویب صفحے کو JSON میں جواب دیتا ہے (CORS ہر اوریجن کی اجازت دیتا ہے)۔ مشین کے لیے قابلِ مطالعہ وضاحت: /openapi.json، جس میں ہر روٹ کے لیے ایک مثالی جواب موجود ہے؛ یہی وضاحت OpenAPI 3.0 میں، ماڈلز کے لیے فنکشن کی تعریفیں، TypeScript ٹائپس، اور درخواستوں کے مجموعے نیچے «تیار کردہ فائلیں» کے تحت درج ہیں۔

حوالہ جاتی کارڈ

ظاہری انداز

منتخب: Cantor's diagonal argument

پیش منظر

آپ کی ویب سائٹ کے لیے ایک کارڈ میں مضمون کا عنوان، مکمل خلاصہ، اور Edgepedia کا حوالہ۔

/embed/{id}?theme=auto مضمون کی مستند آئی ڈی کے ذریعے اس کا کارڈ فراہم کرتا ہے۔ ظاہری انداز auto، light، یا dark ہو سکتا ہے۔ اختیاری اسکرپٹ /assets/edgepedia-embed.js فریم کو اس کے مندرجات کے مطابق ڈھال دیتا ہے؛ اس کے بغیر بھی فریم پڑھنے اور اسکرول کرنے کے قابل رہتا ہے۔

/embed/{slug} بھی کام کرتا ہے: یہ تھیم برقرار رکھتے ہوئے مضمون کی آئی ڈی پر موجود کارڈ کی طرف ری ڈائریکٹ کرتا ہے۔ Edgepedia ایک oEmbed فراہم کنندہ بھی ہے: GET /oembed?url={article or card URL}&format=json اوپر دیے گئے بلڈر ہی کا ایمبیڈ کوڈ html کی صورت میں لوٹاتا ہے، جس کے ساتھ عنوان، چوڑائی، اور اونچائی بھی ہوتی ہے؛ maxwidth اور maxheight کی پابندی کی جاتی ہے۔ General کے ہر مضمون کا صفحہ اپنے <head> میں اپنے oEmbed پتے کا لنک دیتا ہے، اس لیے WordPress، Discourse، اور oEmbed استعمال کرنے والے دوسرے نظام چسپاں کیے گئے Edgepedia لنک کو کارڈ میں بدل دیتے ہیں۔

روٹس

روٹجواب
/api/v1/search?q=wordsعنوانات اور دوسرے ناموں سے مطابقت رکھنے والے نتائج، بہترین نتیجہ پہلے۔ کسی موضوع کا نام تلاش کریں، سوال نہیں۔ ہر نتیجے میں: آئی ڈی، عنوان، اعلیٰ ترین سطح کا موضوع، پیش منظر کا متن، لنکس، اور مطابقت کی نوعیت (match، confidence)۔ کسی موضوع کا نام بتانے والے الفاظ، مثلاً "science fiction writers"، topics بھی لوٹاتے ہیں، جو اس کے مضامین کا لنک ہے۔ limit فی صفحہ نتائج کی تعداد ہے، 1 سے 30 تک (طے شدہ 10)؛ page سے صفحات بدلے جاتے ہیں، اور آخری صفحے سے آگے کا صفحہ خالی ہوتا ہے۔ دوسرے نام اور غلط املا بھی کام کرتے ہیں: "zhu yuanzhang" سے شہنشاہ ہونگ وو ملتا ہے، اور "siddartha" سے did_you_mean لوٹتا ہے۔ مزید اختیارات: نیچے «تلاش» دیکھیے۔
/api/v1/articles/{slug}مضمون Markdown کی صورت میں، موضوعاتی درخت میں اس کا راستہ، جغرافیائی درخت میں اس کے مقامات (geo)، اس کی آخری تازہ کاری کی تاریخ، اور دکھانے کے لیے ماخذ کے حوالے کی سطر۔ کوئی بھی نام کام کرتا ہے (Mount_Fuji، عنوان، مکمل پتہ)، اور اختیارات کے ذریعے کوئی حصہ، خاکہ، اقتباسات، یا دوسری صورتیں ملتی ہیں: نیچے «مضمون پڑھنا» دیکھیے۔
/api/v1/articles?id={id}یہی معلومات، آئی ڈی کے ذریعے۔ مجموعۂ متون کی منتقلی کے بعد بھی مضامین کی پرانی آئی ڈیز درست مضمون تک پہنچاتی رہتی ہیں؛ درخت پر نظرثانی کے وقت موضوعات کی آئی ڈیز بدل سکتی ہیں۔ پتہ بدل سکتا ہے؛ پرانا پتہ پھر بھی moved_from کے ساتھ جواب دیتا ہے۔ ids= ایک ساتھ 10 تک قبول کرتا ہے۔
/api/v1/leads?ids={id},{id}آئی ڈی کے ذریعے 50 تک مضامین، ہر ایک تلاش کے نتیجے کی صورت میں (آئی ڈی، عنوان، اعلیٰ ترین سطح کا موضوع، پیش منظر کا متن، لنکس)، کارڈز کا صفحہ بنانے کے لیے۔ منتقل یا ضم کی گئی آئی ڈیز کے جواب میں برقرار رہنے والا مضمون ملتا ہے، جس کی کلید درخواست میں دی گئی آئی ڈی ہوتی ہے؛ نتیجے کا id مستند ہوتا ہے۔ نامعلوم یا غیر دستیاب آئی ڈیز چھوڑ دی جاتی ہیں۔
/api/v1/randomایک بے ترتیب مضمون۔ new=1 تازہ ترین مضامین میں سے چنتا ہے؛ topic= یا geo= کسی نوڈ کے تحت چنتا ہے۔
/api/v1/related/{slug}ایک ہی کال میں مضمون کے پڑوسی مضامین: اس کے اپنے موضوع میں اس سے قریب ترین 10 تک، 8 تک پڑوسی موضوعات میں سے ہر ایک کے 3، اور ہر اس جغرافیائی نوڈ میں قریب ترین 10 تک مضامین جس میں وہ شامل ہے۔ ?id={id} بھی۔ by=links اس کے بجائے وہ مضامین دیتا ہے جن کا حوالہ اس کے ساتھ دیا گیا ہو۔
/api/v1/topicsموضوعاتی درخت کی بالائی سطح۔
/api/v1/topics/{id}کسی موضوع کا راستہ، مضامین کی تعداد کے ساتھ اس کے ذیلی موضوعات، اور اس کے تحت آنے والے تمام مضامین، فی صفحہ 30۔ format=mermaid اس کا ذیلی درخت بناتا ہے۔
/api/v1/geoجغرافیائی درخت: اس کے خطے، ہر ایک اپنے ادوار کے ساتھ۔
/api/v1/geo/{id}ایک جغرافیائی نوڈ، موضوع جیسی ساخت میں: اس کا راستہ، اس کے تحت زیادہ مخصوص نوڈز، اور مضامین، فی صفحہ 30۔ کسی خطے میں صرف اس کے ادوار درج ہوتے ہیں۔
POST /api/v1/ids/translateجب v1.5 کی منتقلی فعال ہو: {"ids":["old-id", "another-id"]} بھیجیں (500 تک الگ الگ آئی ڈیز)۔ جواب منتقل شدہ آئی ڈیز کو ان کے مستند، برقرار رہنے والے متبادل سے مربوط کرتا ہے؛ غیر تبدیل شدہ یا نامعلوم آئی ڈیز شامل نہیں کی جاتیں۔ مکمل شدہ بیچز کی پیش رفت محفوظ کریں اور Retry-After کی پابندی کریں۔

پیش منظر کے متن میں، جہاں دستیاب ہو، مجموعۂ متون کا مختصر اقتباس استعمال ہوتا ہے، ورنہ مضمون کا آغاز۔ جن ریکارڈز اور نتائج میں مختصر اقتباس ہوتا ہے، ان میں وہ snippet کے طور پر بھی شامل ہوتا ہے؛ markdown میں بدستور مضمون کا مکمل متن رہتا ہے۔ node، جب موجود ہو، تصوری درخت میں مضمون کا موجودہ نوڈ ہوتا ہے۔

ہر مضمون اپنے پتے پر Markdown کی صورت میں بھی دستیاب ہے۔ .md شامل کریں: www.edgepedia.org/koala.md۔

MCP سرور

https://www.edgepedia.org/mcp۔ اسے Claude میں حسبِ ضرورت کنیکٹر کے طور پر، ChatGPT میں Developer mode فعال کر کے، VS Code یا Cursor میں ایک کلک سے، یا کسی بھی دوسرے MCP کلائنٹ میں اس کے پتے کے ذریعے شامل کریں۔ نہ کلید درکار، نہ سائن اِن۔ صرف پڑھنے والے پانچ ٹولز: search (کسی موضوع کا نام دیجیے، مطابقت رکھنے والے مضامین حاصل کیجیے، اور اگر وہ الفاظ کسی موضوع کا نام ہوں تو وہ موضوع بھی)، fetch (ایک مضمون Markdown کی صورت میں، ماخذ کے حوالے کی سطر، موضوعاتی راستے، اور جغرافیے کے ساتھ؛ تقریباً ایک چوتھائی مختصر متن کے لیے citations: false؛ topic: آئی ڈی اس موضوع کا بالاتر موضوع، اس کے تحت زیادہ مخصوص موضوعات، اور مضامین درج کرتی ہے، ہر page پر 120؛ topic:root اور topic:geo بالترتیب موضوعاتی اور جغرافیائی درختوں کی بالائی سطحیں ہیں)، related (مضمون کے اپنے موضوع، قریبی موضوعات، اور جغرافیے میں اس کے پڑوسی مضامین؛ اس کے ساتھ حوالہ دیے گئے مضامین کے لیے by: "links")، connect (from، to: دو مضامین کے درمیان لنکس کی زنجیر، جیسا کہ /api/v1/path دیتا ہے)، اور resolve (name، اختیاری context اور type کے ساتھ: وہ مضمون جس کی طرف کسی نام کا غالباً اشارہ ہے، جیسا کہ /api/v1/resolve دیتا ہے)۔ جب کسی search سے کوئی عنوان مطابقت نہ رکھتا ہو، تو وہ مضامین جن کا متن مطابقت رکھتا ہو، عنوان سے مطابقت رکھنے والے نتائج کے بعد، match: fulltext کے نشان کے ساتھ آتے ہیں، limit کی حد کے اندر، اور pages میں گنے جاتے ہیں۔ ٹول کی خرابی وہ متن ہوتی ہے جسے ماڈل پڑھتا ہے (کسی بھی مضمون سے وابستہ نہ ہونے والی آئی ڈی کے لیے did_you_mean آئی ڈیز کے ساتھ)؛ اس کا کوڈ _meta["ai.edgechat/error"] میں آتا ہے، کبھی structuredContent میں نہیں۔ links: "in" کے ساتھ fetch، وہاں لنک کرنے والے اگلے 30 مضامین کے لیے links_page قبول کرتا ہے۔

search میں limit (1 سے 30، طے شدہ 10)، page، first، topic، اور sort دیے جا سکتے ہیں، اور یہ جواب میں page اور pages دیتا ہے؛ fetch نیچے دیے گئے مضمون کے اختیارات قبول کرتا ہے، اور ایک ساتھ کئی مضامین کے لیے ids بھی۔ ہر نتیجے میں canonical_id، یعنی مضمون کی مستقل آئی ڈی، شامل ہوتی ہے: fetch اسے قبول کرتا ہے، اور جب آپ کی محفوظ کردہ آئی ڈی یا پتہ منتقل ہو چکا ہو، تو fetch مضمون لوٹاتا ہے اور moved_from میں وہی درج ہوتا ہے جو آپ نے مانگا تھا۔ نتائج میں _meta.corpus_version کے اندر مجموعۂ متون کی ریلیز کا نام دیا جاتا ہے۔ پروٹوکول 2025-06-18 یا اس کے بعد کے ورژن استعمال کرنے والے کلائنٹس کو ہر مضمون کے لیے ایک resource_link بھی ملتا ہے۔

وسائل: edgepedia://article/{slug} (مضمون Markdown کی صورت میں، وہی متن جو fetch دیتا ہے) اور edgepedia://topic/{id} (کسی موضوع کے تحت زیادہ مخصوص موضوعات اور مضامین)، دونوں کے لیے خودکار تکمیل کے ساتھ؛ خودکار تکمیل ہر اس آرگومنٹ کے لیے بھی مضامین کے عنوانات تجویز کرتی ہے جو کسی مضمون کا نام لیتا ہو۔ Agent Skill بھی MCP کے ذریعے (skills/list، skills/get)، skill://edgepedia/SKILL.md کے طور پر فراہم کیا جاتا ہے۔ /mcp پر GET سرور کارڈ JSON کی صورت میں لوٹاتا ہے۔ صرف text/event-stream قبول کرنے والے کلائنٹس کو ہر جواب ایک SSE message ایونٹ کی صورت میں ملتا ہے۔ ٹولز کی فہرست کا sha256 ہر جواب کے _meta (ai.edgechat/tools-sha256) میں آتا ہے، تاکہ کسی ٹول کی وضاحت میں تبدیلی نظر آ سکے۔

Windows (پیشگی آزمائشی ورژن، بلڈ 26220.7262 یا اس کے بعد): odr.exe mcp add --uri https://www.edgepedia.org/mcp۔ باقی ہر کلائنٹ کے لیے سیٹ اَپ کی سطریں، ایک Agent Skill، اور مثالیں: github.com/EdgePlat/edgepedia-mcp۔

MCP نہیں ہے، یا کلائنٹ صرف پرانا SSE ٹرانسپورٹ استعمال کرتا ہے؟ اپنے ماڈل کو دو فنکشن دیجیے جو /api/v1/search اور /api/v1/articles/{slug} کو کال کریں، یا انہیں /tools.json سے تیار حالت میں لے لیجیے۔ پرانے ٹرانسپورٹ کے پتے (/sse، /mcp/sse) 404 جواب دیتے ہیں، جس کے متن میں https://www.edgepedia.org/mcp درج ہوتا ہے۔

حدود

فی آئی پی پتہ ایک منٹ میں 600 اور ایک دن میں 100,000 درخواستیں، API اور MCP سرور دونوں کے لیے یکساں۔ ہر جواب RateLimit-Policy میں دونوں زمانی وقفے بتاتا ہے۔ ان حدوں سے تجاوز پر API، Retry-After اور RateLimit کے ساتھ 429 جواب دیتا ہے؛ MCP ٹول کال کے جواب میں ٹول کی خرابی آتی ہے، جس کا retry_after سیکنڈوں کی تعداد بتاتا ہے۔ گنتی ہر سرور انسٹینس پر الگ رکھی جاتی ہے، اس لیے یہ ایسی بالائی حدیں ہیں جن سے نیچے رہنا چاہیے، استعمال کا بالکل درست پیمانہ نہیں۔ براہِ کرم کیش استعمال کریں۔ آئی ڈیز کے ترجمے (/api/v1/ids/translate) میں ہر مطلوبہ آئی ڈی الگ گنی جاتی ہے؛ پرانی آئی ڈیز کی جانچ کرنے والے /leads بیچز میں بھی ہر پرانی آئی ڈی الگ شمار ہوتی ہے۔ دوسرے بیچز میں ہر آئی ڈی یا نام ایک درخواست شمار ہوتا ہے، اور annotate میں ہر 1,000 حروف پر ایک درخواست۔

لائسنس

Edgepedia کمیونٹی لائسنس 1.0: ماخذ کے حوالے کے ساتھ مفت، تجارتی استعمال بھی شامل۔ AI کی تربیت سب کے لیے کھلی ہے، اور ماڈل کے آؤٹ پٹ میں ماخذ کا حوالہ ضروری نہیں۔ دوسرے استعمالات کے لیے، 100 ملین امریکی ڈالر سے زیادہ آمدنی یا 100 ملین سے زیادہ ماہانہ صارفین رکھنے والے اداروں کو الگ لائسنس لینا ہوتا ہے۔

ماخذ کا حوالہ: جہاں بھی کسی مضمون کا متن دکھائیں، اس کی credit سطر اس کے لنک سمیت دکھائیں۔ مضمون کے جوابات میں یہ چسپاں کرنے کے لیے تیار صورت میں credit_md اور credit_html، اور license.spdx (LicenseRef-Edgepedia-Community-1.0) کے طور پر بھی شامل ہوتی ہے۔ API میں مضمون اور /leads کے جوابات میں Link: <https://www.edgepedia.org/edgepedia/license>; rel="license" اور X-License: LicenseRef-Edgepedia-Community-1.0 شامل ہوتے ہیں۔

EdgeChat ایپ، اس کی Edge Apps، اور ہمارا سافٹ ویئر بلا معاوضہ ہیں، مگر ملکیتی ہیں: سورس کوڈ فراہم نہیں کیا جاتا، اور ان کی نقل، ترمیم، یا دوبارہ تقسیم کی اجازت نہیں (EdgeChat لائسنس معاہدہ)۔

خرابیاں

JSON: { "error": { "code": "not_found", "message": "…" } }۔ 400: q موجود نہیں، 404: نہیں ملا، 410: ہٹا دیا گیا، 413: متن بہت طویل ہے، 429: درخواستیں حد سے زیادہ ہیں، 503: دوبارہ کوشش کریں۔ 404 اگلی کال بتاتا ہے: hint، next (ایک URL)، اور ایسے مضمون کے پتے کے لیے جہاں کچھ نہ ملے، قریب ترین تین عنوانات کے ساتھ did_you_mean۔ MCP کے fetch ٹول کی «نہیں ملا» خرابی میں بھی یہی did_you_mean شامل ہوتا ہے۔

تبدیلیاں

ورژن 1 کی ساخت برقرار رہتی ہے: فیلڈز شامل کیے جا سکتے ہیں، مگر ان کے نام کبھی نہیں بدلے جائیں گے اور نہ انہیں ہٹایا جائے گا۔ Edgepedia کی اپنی تبدیلیاں /edgepedia/updates پر ہیں۔ جب کوئی ریلیز موضوعاتی درخت کی ازسرِنو ترتیب کرتی ہے، جیسا کہ 1.8.0 نے کیا، تو منتقل ہونے والے موضوع کی آئی ڈی اپنے نئے آئی ڈی کے ساتھ 301 جواب دیتی ہے، اور /api/v1/changes?since=<release> اس ریلیز کے بعد شامل، تبدیل، منتقل، یا حذف کیے گئے ہر مضمون کی فہرست دیتا ہے۔

/api/v1، corpus_version، corpus_updated، اور release_notes کی اطلاع دیتا ہے۔ یہ General کے مجموعۂ متون کی شائع شدہ ریلیز اور اس کی تاریخِ اجرا کی شناخت کرتے ہیں، نہ کہ ہر مضمون کی آخری ترمیم کی تاریخ کی۔ یہی میٹا ڈیٹا MCP سرور کی ہدایات میں بھی آتا ہے۔ مجموعۂ متون کی ریلیز سے API یا MCP سافٹ ویئر کا ورژن نہیں بدلتا۔ وہاں id_policy بتاتا ہے کہ آئی ڈی کے بارے میں کیا ضمانت ہے: کسی ریلیز میں آئی ڈیز کے نمبر بدلے یا انہیں ضم کیا جا سکتا ہے، جیسا کہ 1.5 میں ہوا، اور پرانی آئی ڈیز 308 اور POST /api/v1/ids/translate کے ذریعے جواب دیتی رہتی ہیں۔

کچھ ٹھیک کام نہیں کر رہا؟ اطلاع دیجیے۔

حوالہ

اخذ کردہ ڈیٹا (اہمیت، مطالعے کی جماعتی سطحیں، لنکس، تاریخیں، دوسرے نام، اور مکمل متن کا اشاریہ) سے پڑھنے والے روٹس اور فیلڈز، جب تک وہ ڈیٹا اسٹور کے ساتھ شائع نہ ہو، Retry-After کے ساتھ 503 جواب دیتے ہیں، یا متعلقہ فیلڈ شامل نہیں کرتے۔

مضمون پڑھنا

/api/v1/articles/{slug} اور MCP fetch یہ اختیارات قبول کرتے ہیں؛ ان کے بغیر جواب میں پورا مضمون ملتا ہے۔

اختیارجواب
section={heading}سرخی یا اس کے کسی لفظ کے ذریعے ایک حصہ، اس کے ذیلی حصوں سمیت (section=etymology سے "نام اور اشتقاق" ملتا ہے؛ section=lead ابتدائی حصہ ہے)۔ نامعلوم سرخی پر مضمون کے sections کے ساتھ 404 جواب ملتا ہے۔
outline=1outline: ہر سرخی، ٹوکنز میں اس کے حجم کے ساتھ۔
max_tokens={n}متن کو کسی حصے یا پیراگراف کے اختتام پر تقریباً n ٹوکنز تک محدود کر کے، tokens_estimate، truncated، اور next_cursor کے ساتھ؛ باقی متن کے لیے اسے اسی max_tokens کے ساتھ cursor کے طور پر بھیجیں۔
length=snippet، length=leadپورے متن کے بجائے مختصر اقتباس، یا عنوان اور ابتدائی پیراگراف۔
format=text، html، jsonld، turtle، tablesجواب سادہ متن، رینڈر شدہ متن، یا اس کی عوامی فیلڈز کے JSON-LD یا Turtle کی صورت میں؛ tables ہر جدول کو columns اور rows، اور csv کے طور پر دیتا ہے، اور اس کے حوالہ جات کو cites اور sources میں منتقل کر دیتا ہے۔
chunks=1chunks: مضمون پیراگرافوں کی صورت میں، ہر ایک کے ساتھ اس کی سرخیوں کے راستے سے حاصل کردہ ایک مستحکم آئی ڈی (geology-2) اور ایک cite_url۔
q={words}&k={1–10}passages: الفاظ سے بہترین مطابقت رکھنے والے k پیراگراف (طے شدہ 3)، ہر ایک کے ساتھ ایک cite_url۔
quote={sentence or chunk id}cite_url: مضمون کا پتہ، ایک متنی فریگمنٹ کے ساتھ جو صفحہ اسی اقتباس پر کھولتا ہے؛ quote_found بتاتا ہے کہ آیا وہ مضمون میں موجود ہے۔
cite={format}cite: مضمون کا کتابیاتی حوالہ، جیسا کہ /api/v1/cite دیتا ہے۔

مضمون کے ہر جواب میں speakable بھی شامل ہوتا ہے (مختصر اقتباس اس صورت میں جسے صوتی معاون پڑھ سکے)۔ importance اور rank (مضامین کے باہمی لنکس پر PageRank؛ 1 سب سے مرکزی ہے؛ یہ لنکس کی گنتی ہے، موضوع کی قدر و قیمت کا فیصلہ نہیں)، words، reading_grade (Flesch-Kincaid)، اور reading_minutes صرف تب آتے ہیں جب fields= میں ان کے نام دیے جائیں (?fields=title,importance,rank)؛ MCP کے fetch میں یہ ہمیشہ شامل ہوتے ہیں۔ next=1 اگلے مطالعے کے لیے 5 تک مضامین شامل کرتا ہے۔ citations=false، markdown، chunks، اور passages میں متن کے اندر ماخذ کے لنکس کی جگہ [n] کے نشان دیتا ہے، جیسے MCP کا citations: false کرتا ہے۔ ایسا پتہ جو کسی مضمون کا نہ ہو، مضمون کی آئی ڈی (/api/v1/articles/ep7rbwcy0a) یا اس کے عنوان کے طور پر پڑھا جاتا ہے، بڑے چھوٹے حروف اور اعرابی علامتوں کے فرق کو نظرانداز کرتے ہوئے (/api/v1/articles/paris)؛ چھوٹے حروف اور ہائفن والا کوئی پتہ اگر اس سے بھی کم مطابقت رکھتا ہو تو جواب 404 ہوتا ہے، الا یہ کہ آپ ?suggest=1 شامل کریں، جبکہ بڑے حروف، خالی جگہوں، یا انڈراسکور والے پتے (/api/v1/articles/Albert_Einstein) کو نام سمجھا جاتا ہے، اس لیے معمولی فرق ہونے پر تلاش کا بہترین نتیجہ resolved_by: search کے ساتھ لوٹتا ہے۔ جب آپ کا دیا ہوا نام مضمون کا پتہ نہ ہو، تو جواب بتاتا ہے کہ اسے کیسے پڑھا گیا (resolved_from، resolved_by: پتہ، عنوان، یا تلاش)، اور 3 دوسرے nearest مضامین کی فہرست دیتا ہے۔ /api/v1/articles?ids={slug or id},{name}، 10 تک مضامین articles کے طور پر لوٹاتا ہے (ہر ایک کے ساتھ وہ نام بھی asked کے طور پر ہوتا ہے جس کے جواب میں وہ ملا ہے)، اور missing بھی؛ ہر اختیار ان سب پر لاگو ہوتا ہے۔

مضمون کا حوالہ دینا

/api/v1/cite/{slug}?format=، csl (CSL-JSON، طے شدہ)، bibtex، ris، apa، mla، chicago، یا harvard میں حوالہ دیتا ہے، اور ساتھ ماخذ کے حوالے کی سطر متن، Markdown، اور HTML کی صورت میں؛ /api/v1/cite?ids={id},{slug} یہی کام 50 تک مضامین کے لیے کرتا ہے۔ مصنف Edgepedia (EdgeChat) ہے؛ APA، MLA، Chicago، اور Harvard ترچھے حروف والے عنوان کو ستاروں سے نشان زد کرتے ہیں، جیسے Markdown کرتا ہے۔ حوالہ جاتی کارڈ میں حوالہ جاتی مواد کے منتظم پروگراموں کے لیے یہی حوالہ COinS اور JSON-LD کی صورت میں پوشیدہ طور پر بھی موجود ہوتا ہے۔

تلاش

matchکبconfidence
exactعنوان عین تلاش کی عبارت ہے۔ایسے پہلے نتیجے کے لیے 1.0، بعد کے کسی نتیجے کے لیے 0.9
aliasکوئی دوسرا نام، یا عنوان کے ابتدائی حروف ("mlk")، مطابقت رکھتے ہوں۔0.8؛ ایسے پہلے نتیجے کے لیے 0.7 جس میں تلاش کی عبارت کا کوئی لفظ نہ ہو؛ حرف گردانی سے لکھی گئی تلاش کی عبارت کے لیے 0.6
misspellingتلاش نے عبارت درست کی ہو (did_you_mean)۔0.5 × لکھی گئی عبارت کا وہ تناسب جو تصحیح میں برقرار رہا
partialتلاش کی عبارت کے کچھ الفاظ عنوان میں ہوں، یا صرف متن میں ہوں۔0.2 + 0.5 × تلاش کی عبارت کے ان الفاظ کا تناسب جو عنوان میں ہوں؛ صرف متن میں ہونے پر 0.2
fulltextکوئی عنوان یا دوسرا نام مطابقت نہ رکھتا ہو، اس لیے مضامین کے متن میں تلاش کی گئی ہو (BM25): یوں کسی چیز کی وضاحت سے وہ مضمون مل جاتا ہے جس کا نام آپ نہیں جانتے۔کم از کم 0.2
noneکچھ بھی مطابقت نہ رکھتا ہو۔ جواب خالی ہوتا ہے۔0

اعتماد کا اسکور ایک مقررہ قاعدے پر مبنی ہے، پیمانہ بند احتمال نہیں؛ جس جواب کے بہترین نتیجے کا اسکور 0.2 سے کم ہو، وہ خالی لوٹتا ہے۔ ہر نتیجے میں highlight شامل ہوتا ہے، یعنی اس کے خلاصے کا وہ جملہ جس میں تلاش کی عبارت کے سب سے زیادہ الفاظ ہوں۔ جس تلاش میں کچھ نہ ملے، اسے لاطینی حروف میں ایک بار پھر آزمایا جاتا ہے (سیریلیک، یونانی، کانا، اور ہانگول کی حرف گردانی کی جاتی ہے، پن یِن میں آہنگ بتانے والے اعداد ہٹا دیے جاتے ہیں، اور روماجی میں دہرے مصوتے مختصر کر دیے جاتے ہیں)، اور جواب میں اسے searched_as کے طور پر درج کیا جاتا ہے۔ چینی حروف کی حرف گردانی نہیں کی جاتی۔

اختیاراس کا کام
first=trueصرف بہترین مطابقت رکھنے والا نتیجہ، یا کوئی نہیں۔
topic={id}، geo={id}صرف اس موضوع یا جغرافیائی نوڈ کے تحت آنے والے مضامین؛ geo، 1,000 تک کے تمام مطابقت رکھنے والے نتائج کو چھانٹتا ہے، اور scope بتاتا ہے کہ جواب کہاں تک کا احاطہ کرتا ہے۔
sort=central1,000 تک کے تمام مطابقت رکھنے والے نتائج میں، وہ موضوعات پہلے جن کی طرف سب سے زیادہ لنکس ہوں۔
max_grade={grade}صرف وہ مضامین جن کی مطالعے کی جماعتی سطح دی گئی سطح کے برابر یا اس سے کم ہو۔
facets=11,000 تک کے تمام مطابقت رکھنے والے نتائج کی، اعلیٰ ترین سطح کے موضوع اور جغرافیائی خطے کے لحاظ سے تعداد (facets.counted)۔

ہر جواب

fields=a,b ہر نتیجے کی صرف وہی کلیدیں برقرار رکھتا ہے (یا جب نتائج نہ ہوں تو خود جواب کی)؛ بیرونی ساخت (total، page، next، license) برقرار رہتی ہے۔ کیش کیے جا سکنے والے 200 جواب میں ایک ETag شامل ہوتا ہے: اسے If-None-Match کے طور پر واپس بھیجیں، تو جواب میں کوئی تبدیلی نہ ہونے پر بغیر متن کے 304 ملتا ہے۔ Last-Modified مجموعۂ متون کی ریلیز کی تاریخ ہے اور صرف اطلاع کے لیے ہے۔ Edgepedia-Corpus-Version مجموعۂ متون کی ریلیز کا نام بتاتا ہے، اور Content-Digest متن کا SHA-256 ہے (RFC 9530)؛ مضمون کے .md میں بھی یہ دونوں شامل ہوتے ہیں۔

مزید روٹس

روٹجواب
/api/v1/articles?after={id}&limit={1..1000}General کا ہر مضمون، ایک مقررہ ترتیب سے: {id, slug, title, api_url} اور next (اختتام پر null)۔ after= خالی ہو تو سلسلہ ابتدا سے شروع ہوتا ہے، اور کسی بھی آئی ڈی کے بعد سے دوبارہ جاری کیا جا سکتا ہے، چاہے وہ ہٹا دی گئی ہو۔
/api/v1/trees، /api/v1/trees/topic، /api/v1/trees/geoمکمل موضوعاتی اور جغرافیائی درخت: nodes: [[id, label, parent index, own articles]]؛ نقطے سے شروع ہونے والی آئی ڈی اپنے بالاتر نوڈ کی آئی ڈی کا تسلسل ہوتی ہے۔
/api/v1/releasesمجموعۂ متون کی ریلیزیں، تازہ ترین پہلے، اور current۔
/api/v1/healthapplication/health+json: pass، warn، یا fail (503)۔
/api/v1/manifestایک gzip JSONL فائل کی طرف ری ڈائریکٹ، ہر مضمون کے لیے ایک سطر: { id, slug, title, updated, sha256, topic } (مضمون کے .md کا sha256)۔ Edgepedia کا مرر بنانے کے لیے اسے ایک بار حاصل کر لیں۔ چیک سم شائع شدہ متن کا ہوتا ہے، قارئین کی بتائی ہوئی تصحیحات سے پہلے کا: ریلیز کے بعد اگر کسی قاری کی اطلاع پر مضمون میں تصحیح ہوئی ہو، تو اگلی ریلیز تک وہ اس چیک سم سے مطابقت نہیں رکھے گا۔
/api/v1/changes?since={release}اس ریلیز سے موجودہ ریلیز تک کی تبدیلیوں کی فائلیں، ترتیب سے (فیڈ 1.5 سے شروع ہوتی ہے: since=1.5 قدیم ترین ہے)؛ ہر سطر { op, id, … } ہوتی ہے، اور op ان میں سے ایک ہوتا ہے: added، changed، moved (from_slug پرانا پتہ ہے)، یا removed۔
/api/v1/events/{slug}مضمون کے وہ جملے جن میں کوئی تاریخ بیان ہوئی ہو: { date, precision, text, para }، date بطور YYYY، YYYY-MM، یا YYYY-MM-DD (قبل مسیح کے لیے منفی: -0044-03-15)۔ قبل مسیح کی تاریخیں تاریخی روایت کے مطابق ہیں، فلکیاتی سالوں کے مطابق نہیں: -0044 سے مراد 44 قبل مسیح ہے (ISO 8601 کا معیاری پارسر اسے 45 قبل مسیح پڑھے گا)۔ ثبوت وہ جملہ ہے: تاریخ کو حقیقت ماننے سے پہلے اسے پڑھیں۔
/api/v1/aliases/{id}مضمون کے دوسرے نام، ان مخففات سمیت جو مضامین میں بیان ہوئے ہیں ("NASA")؛ غلط املا اور صرف بڑے چھوٹے حروف کا فرق رکھنے والی صورتیں شامل نہیں ہوتیں، اور ایک نام کے دو املا ہوں تو بغیر نقطوں والا رکھا جاتا ہے ("WHO"، نہ کہ "W.H.O.")۔

نام سے مضمون کا تعین، متن پر نشان دہی، اور ریکارڈ کی مطابقت

آزاد متن دیجیے، مضامین کی آئی ڈیز حاصل کیجیے، کسی ماڈل یا ایمبیڈنگز کے بغیر۔ annotate، classify، اور geoparse کو بھیجا گیا متن کبھی لاگ میں درج یا محفوظ نہیں کیا جاتا۔

روٹجواب
/api/v1/resolve?name=Mercury&context=planetوہ مضمون جس کی طرف کسی نام کا غالباً اشارہ ہے: result، confidence، ambiguous، match (exact، alias، anchor، partial، یا none)، اور alternatives۔ type= ممکنہ نتائج کو ایک موضوع کی آئی ڈی کے تحت محدود رکھتا ہے (جب نام سے مطابقت رکھنے والے پہلے 30 نتائج میں سے کوئی وہاں نہ ہو، تو ایک اکیلے نام کے لیے اگلے 60 نتائج بھی دیکھے جاتے ہیں)؛ limit=، 1 سے 10 تک۔ POST، 50 تک قبول کرتا ہے: { "names": ["Paris", "Koala"] } یا { "queries": [{ "name": "Mercury", "context": "planet" }] }۔ اگر اکیلے نام سے کسی ایک مضمون کا تعین نہ ہو سکے، تو جواب ambiguous: true ہوتا ہے، اور بہترین اندازہ result کے طور پر دیا جاتا ہے؛ انتخاب کے لیے context بھیجیں۔
/api/v1/surface?form=mercuryہر وہ مضمون جس کی طرف مجموعۂ متون کے اپنے لنکس میں اس بعینہٖ عبارت سے اشارہ کیا گیا ہو، لنکس کی تعداد اور ہر مضمون کے حصے کے ساتھ (commonness)۔
/api/v1/suggest?prefix=koaپہلے وہ مضمون جس کا عنوان بعینہٖ یہی ہو، پھر وہ جس کا کوئی دوسرا نام بعینہٖ یہی ہو، پھر اس ابتدائی عبارت سے شروع ہونے والے عنوانات، اور پھر اس سے شروع ہونے والے دوسرے نام (matched وہ نام بتاتا ہے)، تلاش کے خانوں اور صوتی انٹرفیس کے لیے۔
POST /api/v1/annotate{ "text": "…" } (زیادہ سے زیادہ 20,000 حروف): ہر لنک شدہ عبارت، متن میں اس کے مقامات (start، end، UTF-16 کوڈ یونٹس میں، جیسے JavaScript میں اسٹرنگ کے اشاریے ہوتے ہیں: Python میں Basic Multilingual Plane سے باہر کا کوئی حرف، مثلاً ایموجی، دو شمار ہوتا ہے)، مضمون، اور اعتماد کے اسکور کے ساتھ۔ ?format=html متن بھی لوٹاتا ہے، جس میں HTML کے خاص حروف محفوظ صورت میں ہوتے ہیں اور ہر عبارت کے ساتھ لنک لگا ہوتا ہے۔
POST /api/v1/classify{ "text": "…" }: وہ موضوعات جن کے بارے میں متن ہے، اس میں مذکور مضامین کے موضوعاتی راستوں کی بنیاد پر اسکور کے ساتھ، اور اعلیٰ ترین سطح کے موضوعات کے حصے۔
POST /api/v1/geoparse{ "text": "…" }: اس میں مذکور مقامات اور ادوار، جغرافیائی درخت پر (nodes، regions، places، periods)؛ درخت کی غیر جغرافیائی شاخ (geo.nongeo) کبھی مقام نہیں سمجھی جاتی۔
/api/v1/mentions?term=CRISPRوہ مضامین جو کسی موضوع کا ذکر کرتے ہیں مگر اس کے مضمون کا لنک نہیں دیتے؛ complete: false کا مطلب ہے کہ لنک دینے والے مضامین کی فہرست محدود کر دی گئی تھی۔
/api/v1/reconcileReconciliation Service API 0.2 کا ایک اینڈپوائنٹ: مینی فیسٹ، بیچ queries (GET یا POST)، اکائی، نوع، اور خاصیت کی تجاویز، پیش منظر، اور ڈیٹا کی توسیع (title، url، excerpt، topic، topic_path، importance_rank)۔ callback= کے ساتھ JSONP۔ OpenRefine میں: Reconcile › Start reconciling › Add standard service، اور https://www.edgepedia.org/api/v1/reconcile چسپاں کریں۔

لنکس کا گراف، تاریخیں، اور فہرستیں

خاکے (format=mermaid) Mermaid متن کی صورت میں ہوتے ہیں، ایسے میزبان نظام کے لیے جو اسے رینڈر کر سکے۔

روٹجواب
/api/v1/links/{slug}مضمون سے دوسرے مضامین کی طرف جانے والے لنکس، پڑھنے کی ترتیب میں، ہر ایک اپنے لنک کے متن اور جملے کے ساتھ۔
/api/v1/backlinks/{slug}?page=اس کی طرف لنک کرنے والے مضامین، فی صفحہ 30، سب سے اہم پہلے، اپنے لنک کے متن کے ساتھ۔
/api/v1/path?from=&to=دو مضامین کے درمیان لنکس کی مختصر ترین زنجیر (زیادہ سے زیادہ 6 مرحلے، جہاں ممکن ہو کثیر روابط والے مراکز سے گریز کرتے ہوئے)، ہر مرحلے کا ربط قائم کرنے والے جملے کے ساتھ۔ MCP سرور اسے connect کہتا ہے۔
/api/v1/compare?a=&b=دو مضامین پہلو بہ پہلو: ابتدائی حصے، موضوعاتی راستے، ان کا سب سے مخصوص مشترک موضوع، ان کے درمیان زنجیر، مشترک اور الگ الگ لنکس، اور ہر ایک کا اہم حقائق کا جدول۔
/api/v1/graph/{slug}?depth=1|2&limit=اس کے اہم ترین پڑوسی مضامین میں سے limit تک (طے شدہ 50، زیادہ سے زیادہ 200)، اور ان کے درمیان ہر لنک۔ complete: false کا مطلب (یہاں، backlinks پر، اور rank/top پر) یہ ہے کہ روٹ کے لیے مختص تقریباً ایک سیکنڈ کا وقت ختم ہونے سے جواب مختصر رہ گیا؛ ایسا جواب صرف ایک منٹ کے لیے کیش کیا جاتا ہے۔
POST /api/v1/context{ "ids": [...] }، 50 تک آئی ڈیز یا پتے (جیسے /rank?ids= اور /leads?ids= بھی قبول کرتے ہیں): ان کے باہمی لنکس، وہ مضامین جن کے ساتھ ان میں سے بیشتر کا لنک ہو، ان کا سب سے مخصوص مشترک موضوع اور مقام، اور ہر ایک کا ابتدائی حصہ۔
/api/v1/rank?ids=، /api/v1/rank/top?topic=&limit=PageRank کے لحاظ سے اہمیت: پورے مجموعۂ متون میں pr کا مجموعہ 1 ہوتا ہے، درجہ 1 سب سے مرکزی ہے۔ ناموں پر توجہ دیں: /search اور مضامین میں importance یہی درجہ 0 سے 1 تک کی صدکی صورت میں ہوتا ہے؛ /resolve کا importance خام pr ہے، اور /leads کا { pr, rank } ہے۔
/api/v1/timeline?topic=|geo=&from=&to=کسی موضوع یا مقام کے مضامین سے تاریخ والے جملے، قدیم ترین پہلے، فی صفحہ 50؛ قبل مسیح کے سال منفی ہوتے ہیں۔ ایک نوڈ اپنے زمانی پھیلاؤ سے زیادہ سے زیادہ 200 واقعات کا نمونہ رکھتا ہے، اور from اور to اسی نمونے کو چھانٹتے ہیں؛ پورے بھرے ہوئے نمونے سے لیے گئے جواب میں sampled: true اور اس کا cap درج ہوتا ہے، اور اس کا total نمونے کی گنتی بتاتا ہے۔
/api/v1/onthisday?date=MM-DD، /api/v1/year/{year}سال کے کسی دن کے واقعات (طے شدہ طور پر UTC کے مطابق آج)، یا کسی ایک سال کے واقعات (-9999 سے 2100 تک)۔ ایک دن میں زیادہ سے زیادہ 500 اور ایک سال میں 2,000 واقعات ہوتے ہیں؛ یہ حد پوری ہونے پر sampled: true درج ہوتا ہے۔
/api/v1/featured?date=، /api/v1/featured.xmlدن کا منتخب مضمون (ابتدائی صفحے کا آج کی حقیقت)، اور گزشتہ دس دنوں کی Atom فیڈ۔
/api/v1/list?topic=|geo=&period=&type=personکسی موضوع کے مضامین، یا کسی مقام اور دور کے مضامین (TBC، T500، T1000، T1800، T1946، T2001، T2021، NODATE)، فی صفحہ 30؛ type=person صرف اشخاص کو برقرار رکھتا ہے۔ جغرافیائی فہرست کی سطروں میں geo ہوتا ہے اور id نہیں ہوتا (اس کے لیے مضمون حاصل کریں)۔
/api/v1/keyterms?topic=|geo=&limit=کسی ذیلی درخت کے عنوانات اور دوسرے نام، گفتار شناس نظام کو پہلے سے تیار کرنے کے لیے۔
/api/v1/stats?topic=|geo=&by=periodصرف تعداد: مجموعۂ متون، یا کسی نوڈ اور اس کے ذیلی نوڈز کے مضامین، لنکس، اور دوسرے نام۔ یہاں articles الگ الگ مضامین شمار کرتا ہے؛ /geo اور /trees/geo پر یہ شمولیتیں گنتا ہے، اس لیے کسی خطے کے دو ادوار میں شامل مضمون وہاں دو بار شمار ہوتا ہے۔

دریافت اور دوسرے پروٹوکول

تیار کردہ فائلیں

یہ /openapi.json سے بنائی جاتی ہیں، اس لیے کبھی اس سے مختلف نہیں ہوتیں۔

فائلاس میں کیا ہے
/openapi-3.0.jsonیہی تفصیل OpenAPI 3.0.3 میں، ان ٹولز کے لیے جو 3.1 نہیں پڑھ سکتے۔
/arazzo.jsonArazzo 1.0 کا ایک طریقۂ کار: تلاش کریں، سب سے زیادہ مطابقت رکھنے والا مضمون حاصل کریں، پھر اس کے متعلقہ مضامین۔
/tools.jsonہر JSON روٹ ایک ایسے فنکشن کی صورت میں جسے ماڈل کال کر سکے، OpenAI، Anthropic، اور Gemini کی صورتوں میں، اور اپنے روٹ کے ساتھ JSON Schema کی صورت میں بھی۔
/edgepedia.d.tsہر جواب اور ہر روٹ کے پیرامیٹرز کے لیے TypeScript کی ٹائپس۔
/edgepedia.postman_collection.json، /edgepedia.bruno.json، /edgepedia.insomnia.json، /edgepedia.httpPostman، Bruno، Insomnia، اور VS Code یا JetBrains کے لیے ہر روٹ کی ایک مثالی درخواست۔

براہِ کرم ایسا User-Agent بھیجیں جس میں آپ کے پروگرام کا نام ہو، جیسے ان مجموعوں میں ہے (edgepedia-collection/1)۔