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 लेखाच्या प्रमाणित ID वरून कार्ड पुरवतो. त्याचे रूप auto, light किंवा dark असू शकते. पर्यायी /assets/edgepedia-embed.js स्क्रिप्ट फ्रेमचा आकार तिच्यातील आशयानुसार जुळवते; ती नसली तरी फ्रेममधील मजकूर वाचता येतो आणि स्क्रोल करता येतो.

/embed/{slug} हाही पर्याय चालतो: तो थीम कायम ठेवून लेखाच्या ID वरील कार्डकडे पुनर्निर्देशित करतो. 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शीर्षके आणि इतर नावांशी जुळणारे निकाल; सर्वाधिक जुळणारे प्रथम. विषयाचे नाव शोधा, प्रश्न नव्हे. प्रत्येक निकालात: id, शीर्षक, सर्वोच्च स्तरावरील विषय, पूर्वावलोकन मजकूर, लिंक आणि तो कसा जुळला (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}वरीलच माहिती, id वरून. लेखसंग्रहाच्या स्थलांतरानंतरही लेखांचे जुने id योग्य लेखापर्यंत पोहोचवतात; वृक्षाची पुनर्रचना झाल्यास विषयांचे id बदलू शकतात. एखादा पत्ता बदलू शकतो; जुना पत्ताही moved_from सह प्रतिसाद देत राहतो. ids= एकावेळी जास्तीत जास्त 10 स्वीकारतो.
/api/v1/leads?ids={id},{id}कार्डच्या पानासाठी, id वरून जास्तीत जास्त 50 लेख; प्रत्येक लेख शोध-निकालाच्या स्वरूपात (id, शीर्षक, सर्वोच्च स्तरावरील विषय, पूर्वावलोकन मजकूर, लिंक). स्थलांतरित आणि विलीन केलेल्या id साठी, मागितलेला id की म्हणून वापरून, विलिनीकरणानंतर टिकून राहिलेला लेख परत मिळतो; निकालातील id हा प्रमाणित id असतो. अज्ञात किंवा अनुपलब्ध 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/translatev1.5 स्थलांतर सक्षम असल्यास: {"ids":["old-id", "another-id"]} पाठवा (जास्तीत जास्त 500 वेगवेगळे id). प्रतिसादात बदललेल्या id ची, त्यांच्या जागी टिकून राहिलेल्या प्रमाणित id शी सांगड दिलेली असते; न बदललेले किंवा अज्ञात id वगळले जातात. पूर्ण झालेल्या बॅचची तपासबिंदू-नोंद ठेवा आणि 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: id दिल्यास त्या विषयाचा पालक विषय, अधिक विशिष्ट विषय आणि लेख यांची यादी मिळते, एका 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 मध्ये मोजले जातात. साधनातील त्रुटी म्हणजे मॉडेलला वाचता येणारा मजकूर (कोणत्याही लेखाला नसलेला id दिल्यास did_you_mean id सह); तिचा कोड _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 हा लेखाचा कायमस्वरूपी id असतो: fetch तो स्वीकारते; आणि तुम्ही साठवलेला id किंवा पत्ता बदलला असल्यास, fetch लेख परत देते आणि moved_from मध्ये तुम्ही मागितलेला id किंवा पत्ता ठेवते. निकालांमध्ये _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 नमूद असते.

मर्यादा

प्रत्येक IP पत्त्यासाठी मिनिटाला 600 आणि दिवसाला 100,000 विनंत्या; API आणि MCP सर्व्हर दोन्हींना हीच मर्यादा लागू आहे. प्रत्येक प्रतिसादात RateLimit-Policy येथे दोन्ही कालावधी नमूद असतात. मर्यादा ओलांडल्यावर API, Retry-After आणि RateLimit सह 429 प्रतिसाद देतो; MCP साधनाचा कॉल साधन-त्रुटी परत करतो, जिच्या retry_after मध्ये सेकंद दिलेले असतात. मोजणी सर्व्हरच्या प्रत्येक इन्स्टन्सपुरती ठेवली जाते; म्हणून या आकड्यांकडे अचूक मोजमाप म्हणून नव्हे, तर न ओलांडण्याची कमाल मर्यादा म्हणून पाहा. कृपया कॅशे वापरा. जुन्या id चे नवीन id मध्ये रूपांतर करताना मागितलेला प्रत्येक id स्वतंत्रपणे मोजला जातो; जुने id तपासणाऱ्या /leads बॅचनाही प्रत्येक जुन्या id मागे स्वतंत्र मोजणी लागू होते. इतर बॅचमध्ये प्रत्येक id किंवा नाव ही एक विनंती मोजली जाते, आणि annotate साठी प्रत्येक 1,000 अक्षरांमागे एक विनंती मोजली जाते.

परवाना

Edgepedia समुदाय परवाना 1.0: श्रेय दिल्यास मोफत; व्यावसायिक वापरही समाविष्ट. AI प्रशिक्षण सर्वांसाठी खुले आहे, आणि मॉडेलच्या आउटपुटमध्ये श्रेय देणे आवश्यक नाही. इतर वापरांसाठी, 10 कोटी अमेरिकी डॉलरपेक्षा अधिक महसूल किंवा दरमहा 10 कोटींपेक्षा अधिक वापरकर्ते असलेल्या संस्थांना स्वतंत्र परवाना घ्यावा लागतो.

श्रेय: जिथे लेखाचा मजकूर दाखवाल, तिथे त्या लेखाची 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 मध्ये झाली होती, बदललेला विषय-id त्याच्या नवीन id सह 301 प्रतिसाद देतो; आणि /api/v1/changes?since=<release> मध्ये त्या प्रकाशन-आवृत्तीपासून जोडलेला, बदललेला, हलवलेला किंवा काढलेला प्रत्येक लेख सूचीबद्ध असतो.

/api/v1 येथे corpus_version, corpus_updated आणि release_notes मिळतात. यांत प्रकाशित General लेखसंग्रहाची प्रकाशन-आवृत्ती आणि तिच्या प्रकाशनाची तारीख दिलेली असते; प्रत्येक लेखाच्या शेवटच्या संपादनाची तारीख नव्हे. हाच मेटाडेटा MCP सर्व्हरच्या सूचनांमध्येही दिसतो. लेखसंग्रहाच्या प्रकाशन-आवृत्त्यांमुळे API किंवा MCP सॉफ्टवेअरची आवृत्ती बदलत नाही. तेथील id_policy मध्ये id कडून कोणती हमी मिळते ते सांगितलेले आहे: एखाद्या प्रकाशन-आवृत्तीत, जसे 1.5 मध्ये झाले, id चे क्रमांक बदलले जाऊ शकतात किंवा ते विलीन केले जाऊ शकतात; आणि जुने id, 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: परिच्छेदांच्या स्वरूपातील लेख; प्रत्येक परिच्छेदासोबत त्याच्या शीर्षक-पथावरून तयार केलेला स्थिर id (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 वापरल्यास markdown, chunks आणि passages मधील मजकुरात दिलेल्या स्रोत-लिंकच्या जागी [n] खुणा येतात, जसे MCP मधील citations: false करते. कोणत्याही लेखाचा नसलेला पत्ता हा एखाद्या लेखाचा id (/api/v1/articles/ep7rbwcy0a) किंवा त्याचे शीर्षक म्हणून वाचला जातो; शीर्षकाच्या बाबतीत लहान-मोठी अक्षरे आणि स्वराघातचिन्हे यांतील फरक दुर्लक्षित केला जातो (/api/v1/articles/paris). फक्त लहान अक्षरे आणि जोडचिन्हे असलेला पत्ता याहून ढोबळपणे जुळत असेल, तर ?suggest=1 जोडल्याशिवाय 404 प्रतिसाद मिळतो; मात्र मोठी अक्षरे, मोकळ्या जागा किंवा अंडरस्कोअर असलेला पत्ता (/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=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}General मधील प्रत्येक लेख, एका ठरावीक क्रमाने: {id, slug, title, api_url} आणि next (शेवटी null). after= रिकामा ठेवल्यास सुरुवातीपासून सुरू होते; कोणत्याही id नंतर, अगदी काढलेल्या id नंतरही, पुढे सुरू करता येते.
/api/v1/trees, /api/v1/trees/topic, /api/v1/trees/geoसंपूर्ण विषय-वृक्ष आणि भूगोल-वृक्ष: nodes: [[id, label, parent index, own articles]]; बिंदूने सुरू होणारा id हा त्याच्या पालक नोडच्या id चा पुढील भाग असतो.
/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." नव्हे).

नाव ओळखणे, मजकुराला लेख-लिंक जोडणे आणि नोंदी जुळवणे

मुक्त मजकूर द्या, लेखांचे id मिळवा—मॉडेल नाही, एम्बेडिंगही नाहीत. annotate, classify आणि geoparse यांना पाठवलेला मजकूर कधीही लॉगमध्ये नोंदवला जात नाही किंवा साठवला जात नाही.

रूटकाय परत मिळते
/api/v1/resolve?name=Mercury&context=planetएखाद्या नावाने अभिप्रेत असण्याची सर्वाधिक शक्यता असलेला लेख: result, confidence, ambiguous, match (exact, alias, anchor, partial किंवा none), आणि alternatives. type= फक्त एका विषय-id खालील संभाव्य लेख ठेवतो (नावाच्या पहिल्या 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 मध्ये मूलभूत बहुभाषिक पटलाबाहेरील एखादे अक्षर, उदा. इमोजी, दोन म्हणून मोजावे), लेख आणि विश्वासांक. ?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 id किंवा पत्ते (जसे /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.json3.1 वाचू न शकणाऱ्या साधनांसाठी तेच वर्णन OpenAPI 3.0.3 मध्ये.
/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 यांच्यासाठी प्रत्येक रूटमागे एक विनंतीचे उदाहरण.

कृपया या संग्रहांप्रमाणेच (edgepedia-collection/1), तुमच्या प्रोग्रामचे नाव नमूद करणारा User-Agent पाठवा.