edgepedia

Edgepedia

واجهة برمجة تطبيقات Edgepedia

أكثر من 500,000 مقالة موسوعية، والعدد في ازدياد مستمر، بصيغة JSON. مجانًا. بلا مفتاح ولا تسجيل. الاستخدام التجاري متاح مع ذكر المصدر. وتدريب نماذج الذكاء الاصطناعي عليها متاح للجميع.

جرّبها

تستخدم مسارات القراءة 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. وتضع كل صفحة مقالة في المتن العام رابطًا إلى عنوان oEmbed الخاص بها في <head>، فتُحوِّل WordPress وDiscourse وغيرها من الأدوات المستهلكة لـ oEmbed رابط Edgepedia الملصق إلى بطاقة.

المسارات

المسارما يعيده
/api/v1/search?q=wordsيطابق العناوين والأسماء الأخرى، ويعرض أفضل المطابقات أولًا. ابحث عن اسم موضوع البحث، لا عن سؤال. تتضمن كل نتيجة: المعرّف، والعنوان، والموضوع في المستوى الأعلى، ونص المعاينة، والروابط، وطريقة المطابقة (match، confidence). والكلمات التي تسمّي موضوعًا، مثل «كتّاب الخيال العلمي»، تعيد أيضًا 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 مقالات إليها في موضوعها نفسه، و3 مقالات من كل موضوع من 8 موضوعات مجاورة كحد أقصى، وما يصل إلى أقرب 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 بعد تفعيل وضع المطوّر، أو إلى VS Code أو Cursor بنقرة واحدة، أو إلى أي عميل MCP آخر باستخدام عنوانه. بلا مفتاح ولا تسجيل دخول. خمس أدوات للقراءة فقط: search (تُدخل اسم موضوع البحث، فتحصل على المقالات المطابقة، وعلى موضوع أيضًا إذا كانت الكلمات تسمّي موضوعًا)، وfetch (مقالة واحدة بصيغة Markdown، مع سطر نسبة محتواها ومسار موضوعها وجغرافيتها؛ استخدم citations: false للحصول على نص أقصر بنحو الربع؛ ويسرد معرّف من نوع topic: الموضوع الأب لذلك الموضوع، وموضوعاته الأخصّ، ومقالاته، بواقع 120 لكل page؛ و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 أبدًا. ويقبل fetch مع links: "in" القيمة 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} (الموضوعات الأخصّ من موضوع ما ومقالاته)، مع الإكمال لكليهما؛ ويقترح الإكمال أيضًا عناوين مقالات لأي وسيط يسمّي مقالة. وتُقدَّم مهارة الوكيل عبر MCP أيضًا (skills/list، skills/get)، في صورة skill://edgepedia/SKILL.md. ويعيد طلب GET إلى /mcp بطاقة الخادم بصيغة 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. أوامر الإعداد لكل عميل آخر، ومهارة وكيل، وأمثلة: 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 طلب في اليوم لكل عنوان IP، سواء لواجهة برمجة التطبيقات أو لخادم MCP. تحدد كل استجابة النافذتين الزمنيتين في RateLimit-Policy. وعند تجاوزهما، تعيد واجهة برمجة التطبيقات الحالة 429 مع Retry-After وRateLimit؛ أما استدعاء أداة MCP فيعيد خطأ أداة يحدد retry_after فيه عدد الثواني. وتُحفَظ الأعداد لكل نسخة خادم على حدة، لذا فهي سقف ينبغي البقاء دونه، لا عدّاد دقيق. يُرجى استخدام التخزين المؤقت. في ids/translate، يُحتسَب كل معرّف مطلوب على حدة؛ كما تُحتسَب دفعات /leads التي تتحقق من المعرّفات القديمة لكل معرّف قديم. وفي الدفعات الأخرى، يُحتسَب كل معرّف أو اسم طلبًا واحدًا، وفي annotate يُحتسَب طلب واحد لكل 1,000 محرف.

الترخيص

رخصة مجتمع Edgepedia 1.0: مجانية مع ذكر المصدر، بما في ذلك الاستخدام التجاري. ويحق للجميع تدريب نماذج الذكاء الاصطناعي على المقالات، ولا تتطلب مخرجات النموذج ذكر المصدر. أما الاستخدامات الأخرى، فتحتاج المؤسسات التي تتجاوز إيراداتها 100 مليون دولار أمريكي أو يتجاوز عدد مستخدميها الشهريين 100 مليون مستخدم إلى ترخيص منفصل.

نسبة المحتوى: اعرض سطر credit لكل مقالة، مع رابطه، أينما تعرض نصها. وتتضمن استجابات المقالات هذا السطر أيضًا في credit_md وcredit_html جاهزًا للصق، وكذلك license.spdx (LicenseRef-Edgepedia-Community-1.0). وتحمل استجابات واجهة برمجة التطبيقات للمقالات ولنتائج /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. وتحدد هذه القيم إصدار المتن العام المنشور وتاريخ إصداره، لا تاريخ آخر تعديل لكل مقالة. وتظهر البيانات الوصفية نفسها في تعليمات خادم MCP. ولا تغيّر إصدارات المتن رقم إصدار برمجيات واجهة برمجة التطبيقات أو MCP. ويوضح id_policy هناك ما يضمنه المعرّف: فقد يعيد إصدار ما ترقيم المعرّفات أو يدمجها، كما فعل الإصدار 1.5، وتظل المعرّفات القديمة تستجيب، عبر الحالة 308 وPOST /api/v1/ids/translate.

هل هناك خلل؟ أبلغ عنه.

المرجع

تعيد المسارات والحقول التي تقرأ من البيانات المشتقة (الأهمية، ومستويات القراءة، والروابط، والتواريخ، والأسماء الأخرى، وفهرس النص الكامل) الحالة 503 مع Retry-After، أو تحذف الحقل، إلى أن تُنشَر تلك البيانات مع مخزن البيانات.

قراءة مقالة

يقبل /api/v1/articles/{slug} وأداة MCP ‏fetch الخيارات التالية؛ ومن دونها تكون الاستجابة هي المقالة كاملة.

الخيارما يعيده
section={heading}قسم واحد، بحسب عنوانه أو كلمة منه (يعثر section=etymology على «الاسم وأصل التسمية»؛ ويشير section=lead إلى الافتتاحية)، مع أقسامه الفرعية. ويعيد العنوان غير المعروف الحالة 404 مع sections الخاص بالمقالة.
outline=1outline: جميع العناوين مع حجم كل منها بوحدات الترميز.
max_tokens={n}النص مقتطعًا إلى نحو n من وحدات الترميز عند حدّ قسم أو فقرة، مع tokens_estimate وtruncated وnext_cursor؛ مرّره في صورة cursor مع max_tokens نفسه للحصول على البقية.
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 (فليش–كينكايد)، وreading_minutes إلا حين يطلبها fields= بالاسم (?fields=title,importance,rank)؛ أما أداة MCP ‏fetch فتتضمنها دائمًا. ويضيف next=1 ما يصل إلى 5 مقالات لقراءتها بعد ذلك. ويضع citations=false علامات [n] بدلًا من روابط المصادر المضمَّنة، في markdown وchunks وpassages، كما يفعل citations: false في MCP. ويُفسَّر العنوان الذي لا تشغله أي مقالة على أنه معرّف مقالة (/api/v1/articles/ep7rbwcy0a) أو عنوانها، مع تجاهل حالة الأحرف وعلامات النبر (/api/v1/articles/paris)؛ أما عنوان الويب المكتوب بأحرف صغيرة تفصل بينها شرطات، إذا ابتعد عن المطابقة أكثر من ذلك، فيعيد الحالة 404 ما لم تضف ?suggest=1، في حين يُفسَّر العنوان الذي يتضمن أحرفًا كبيرة أو مسافات أو شرطات سفلية (/api/v1/articles/Albert_Einstein) على أنه اسم، فتؤدي المطابقة القريبة إلى إرجاع أفضل نتيجة بحث مع resolved_by: search. وحين لا يكون الاسم الذي أدخلته هو عنوان ويب المقالة، توضح الاستجابة كيف فُسِّر (resolved_from، resolved_by: عنوان ويب، أو عنوان مقالة، أو بحث)، وتسرد المقالات الثلاث الأخرى في 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 وشيكاغو وهارفارد العنوان المائل بين نجمات، كما تفعل 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=centralموضوعات المقالات التي تتلقى أكبر عدد من الروابط أولًا، من بين جميع المطابقات حتى 1,000 مطابقة.
max_grade={grade}المقالات التي يعادل مستوى قراءتها ذلك الصف الدراسي أو يقل عنه فقط.
facets=1أعداد المطابقات بحسب الموضوع في المستوى الأعلى وبحسب المنطقة الجغرافية، عبر جميع المطابقات حتى 1,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}جميع مقالات المتن العام، بترتيب ثابت: {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إعادة توجيه إلى ملف JSONL واحد مضغوط بصيغة gzip، بسطر لكل مقالة: { id, slug, title, updated, sha256, topic } (sha256 لـ .md الخاص بالمقالة). اجلبه مرة واحدة لإنشاء نسخة مطابقة من 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 مطابقة للاسم تحته، يُبحث في المطابقات الستين التالية عند طلب اسم واحد)؛ و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، يُحتسَب المحرف الواقع خارج المستوى الأساسي متعدد اللغات، مثل رمز تعبيري، وحدتين)، والمقالة، ودرجة الثقة. ويعيد ?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/reconcileنقطة نهاية لـ واجهة برمجة تطبيقات خدمة التوفيق 0.2: ملف التعريف، وqueries للدفعات (GET أو POST)، واقتراح الكيان والنوع والخاصية، والمعاينة، وتوسيع البيانات (title، url، excerpt، topic، topic_path، importance_rank). وتدعم JSONP باستخدام callback=. في 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 هي الأكثر مركزية. انتبه إلى الأسماء: importance في /search والمقالات هو هذه المرتبة معبَّرًا عنها برتبة مئينية بين 0 و1؛ أما importance في /resolve فهو قيمة 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}أحداث في يوم من أيام السنة (اليوم الحالي بالتوقيت العالمي المنسق افتراضيًا)، أو في سنة واحدة (من -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.jsonسير عمل بصيغة Arazzo 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.httpمثال واحد على طلب لكل مسار، لاستخدامه في Postman وBruno وInsomnia وVS Code أو JetBrains.

يُرجى إرسال User-Agent يذكر اسم برنامجك، كما تفعل مجموعات الطلبات (edgepedia-collection/1).