Edgepedia API
അഞ്ചു ലക്ഷത്തിലേറെ വിജ്ഞാനകോശലേഖനങ്ങൾ, JSON രൂപത്തിൽ. എണ്ണം നിരന്തരം വർധിക്കുന്നു. സൗജന്യം. കീ വേണ്ട, രജിസ്ട്രേഷൻ വേണ്ട. കടപ്പാട് രേഖപ്പെടുത്തി വാണിജ്യാവശ്യങ്ങൾക്കും ഉപയോഗിക്കാം. AI പരിശീലനത്തിന് എല്ലാവർക്കും ഉപയോഗിക്കാം.
പരീക്ഷിച്ചുനോക്കൂ
- www.edgepedia.org/api/v1/search?q=koala
- www.edgepedia.org/api/v1/articles/koala
- www.edgepedia.org/api/v1/random
- www.edgepedia.org/api/v1/topics
വായിക്കാനുള്ള റൂട്ടുകൾ 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). “സയൻസ് ഫിക്ഷൻ എഴുത്തുകാർ” പോലുള്ള, ഒരു വിഷയവിഭാഗത്തെ സൂചിപ്പിക്കുന്ന വാക്കുകൾക്ക് 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/translate | v1.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-ൽ ഒരു കസ്റ്റം കണക്ടറായി, Developer mode ഓണാക്കിയ ChatGPT-ൽ, ഒറ്റ ക്ലിക്കിൽ 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-ഉം സ്വീകരിക്കുന്നു. ഓരോ ഫലത്തിലും ലേഖനത്തിന്റെ സ്ഥിരം id ആയ canonical_id ഉണ്ടാകും: fetch അത് സ്വീകരിക്കും. നിങ്ങൾ സൂക്ഷിച്ച id-യോ വിലാസമോ മാറിയിട്ടുണ്ടെങ്കിൽ, 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 വ്യക്തമാക്കിയിരിക്കും.
പരിധികൾ
ഒരു IP വിലാസത്തിന് മിനിറ്റിൽ 600 റിക്വസ്റ്റുകളും ദിവസം 100,000 റിക്വസ്റ്റുകളും; API-ക്കും MCP സെർവറിനും ഒരേ പരിധി. ഓരോ മറുപടിയും RateLimit-Policy-ൽ ഈ രണ്ട് സമയപരിധികളും വ്യക്തമാക്കുന്നു. അവ കടന്നാൽ API, Retry-After, RateLimit എന്നിവ സഹിതം 429 നൽകും; MCP ടൂൾ കോൾ ഒരു ടൂൾ പിശക് നൽകും, അതിലെ retry_after സെക്കൻഡുകൾ വ്യക്തമാക്കും. എണ്ണങ്ങൾ ഓരോ സെർവർ ഇൻസ്റ്റൻസിനും വെവ്വേറെയാണ് സൂക്ഷിക്കുന്നത്. അതിനാൽ ഇവ കൃത്യമായ അളവുകോലല്ല, കടക്കാതിരിക്കേണ്ട പരമാവധി പരിധികളാണ്. ദയവായി കാഷ് ചെയ്യുക. POST /api/v1/ids/translate-ൽ ആവശ്യപ്പെടുന്ന ഓരോ 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-കൾക്ക് പുതിയ നമ്പറുകൾ നൽകുകയോ അവ ലയിപ്പിക്കുകയോ ചെയ്യാം; 308-ലൂടെയും POST /api/v1/ids/translate-ലൂടെയും പഴയ id-കൾ തുടർന്നും മറുപടി നൽകും.
എന്തെങ്കിലും പ്രവർത്തിക്കുന്നില്ലേ? അറിയിക്കുക.
റഫറൻസ്
ഉരുത്തിരിച്ചെടുത്ത ഡാറ്റയിൽനിന്ന് (പ്രാധാന്യം, വായനാനിലകൾ, ലിങ്കുകൾ, തീയതികൾ, മറ്റു പേരുകൾ, പൂർണടെക്സ്റ്റ് സൂചിക എന്നിവ) വായിക്കുന്ന റൂട്ടുകളും ഫീൽഡുകളും, ആ ഡാറ്റ സ്റ്റോറിനൊപ്പം പ്രസിദ്ധീകരിക്കുന്നതുവരെ Retry-After സഹിതം 503 നൽകും; അല്ലെങ്കിൽ ഫീൽഡ് ഒഴിവാക്കും.
ഒരു ലേഖനം വായിക്കൽ
/api/v1/articles/{slug}, MCP fetch എന്നിവ ഈ ഓപ്ഷനുകൾ സ്വീകരിക്കുന്നു; ഇവയില്ലെങ്കിൽ പൂർണ ലേഖനമാണ് മറുപടി.
| ഓപ്ഷൻ | ലഭിക്കുന്നത് |
|---|---|
section={heading} | തലക്കെട്ടോ അതിലെ ഒരു വാക്കോ ഉപയോഗിച്ച് ഒരു ഭാഗം, അതിന്റെ ഉപഭാഗങ്ങൾ സഹിതം (section=etymology “പേരും പദോൽപ്പത്തിയും” കണ്ടെത്തും; section=lead തുടക്കഭാഗമാണ്). അറിയാത്ത തലക്കെട്ടിന് ലേഖനത്തിന്റെ sections സഹിതം 404 ലഭിക്കും. |
outline=1 | outline: ഓരോ തലക്കെട്ടും, അതിലെ ടോക്കണുകളുടെ എണ്ണം സഹിതം. |
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=1 | chunks: ഖണ്ഡികകളായി ലേഖനം; ഓരോന്നിനും അതിന്റെ തലക്കെട്ടുപാതയിൽനിന്നുള്ള സ്ഥിരമായ 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 (Flesch-Kincaid), reading_minutes എന്നിവ fields=-ൽ പേരെടുത്തു നൽകിയാൽ മാത്രമേ ലഭിക്കൂ (?fields=title,importance,rank); MCP fetch-ൽ ഇവ എപ്പോഴുമുണ്ടാകും. next=1 അടുത്തതായി വായിക്കാൻ 5 ലേഖനങ്ങൾ വരെ ചേർക്കുന്നു. MCP-യുടെ citations: false പോലെ, citations=false ഉപയോഗിച്ചാൽ markdown, chunks, passages എന്നിവയിൽ ടെക്സ്റ്റിനിടയിലെ ഉറവിടലിങ്കുകൾക്കു പകരം [n] അടയാളങ്ങൾ ലഭിക്കും. ഒരു ലേഖനത്തിനുമില്ലാത്ത വിലാസത്തെ, ഒരു ലേഖനത്തിന്റെ 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-ക്കു ശേഷവും, നീക്കം ചെയ്തതാണെങ്കിലും, അവിടെനിന്ന് തുടരാം. |
/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/health | application/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 }, കൂടാതെ YYYY, YYYY-MM, അല്ലെങ്കിൽ YYYY-MM-DD രൂപത്തിലുള്ള date (പൊതുവർഷത്തിനു മുമ്പുള്ളവയ്ക്ക് നെഗറ്റീവ് സംഖ്യ: -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" }] }. ഒരു പേര് മാത്രം നൽകി ഒരു ലേഖനം ഉറപ്പിക്കാനാകുന്നില്ലെങ്കിൽ, ഏറ്റവും സാധ്യതയുള്ളത് result ആയി നൽകി ambiguous: true എന്ന മറുപടി ലഭിക്കും; തിരഞ്ഞെടുക്കാൻ context നൽകുക. |
/api/v1/surface?form=mercury | കൃത്യം ഈ പ്രയോഗംകൊണ്ട് കോർപ്പസിലെ സ്വന്തം ലിങ്കുകൾ സൂചിപ്പിച്ചിട്ടുള്ള എല്ലാ ലേഖനങ്ങളും, ലിങ്കുകളുടെ എണ്ണവും ഓരോന്നിന്റെയും വിഹിതവും സഹിതം (commonness). |
/api/v1/suggest?prefix=koa | ആദ്യം കൃത്യം ആ ശീർഷകമുള്ള ലേഖനം, തുടർന്ന് മറ്റൊരു പേര് കൃത്യമായി പൊരുത്തപ്പെടുന്ന ലേഖനം, പിന്നെ നൽകിയ തുടക്കഭാഗത്തിൽ ആരംഭിക്കുന്ന ശീർഷകങ്ങൾ, അതിനുശേഷം അങ്ങനെ തുടങ്ങുന്ന മറ്റു പേരുകൾ (matched ആ പേര് നൽകുന്നു); തിരയൽബോക്സുകൾക്കും ശബ്ദാധിഷ്ഠിത ഇന്റർഫേസുകൾക്കും വേണ്ടി. |
POST /api/v1/annotate | { "text": "…" } (പരമാവധി 20,000 അക്ഷരങ്ങൾ): ലിങ്ക് ചെയ്ത ഓരോ പ്രയോഗവും അതിന്റെ സ്ഥാനസൂചകങ്ങളും (start, end, JavaScript സ്ട്രിങ്ങുകൾ ഇൻഡക്സ് ചെയ്യുന്നതുപോലെ UTF-16 കോഡ് യൂണിറ്റുകളിൽ: 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/reconcile | ഒരു Reconciliation 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-ലും അത് ഉൾപ്പെടുത്തിയിട്ടുള്ള സ്ഥാനങ്ങളുടെ എണ്ണമാണ്. അതിനാൽ ഒരു പ്രദേശത്തിന്റെ രണ്ടു കാലഘട്ടങ്ങളിലുമുള്ള ലേഖനം അവിടെ രണ്ടുതവണ എണ്ണപ്പെടും. |
കണ്ടെത്തലും മറ്റു പ്രോട്ടോക്കോളുകളും
- MCP സെർവർ കാർഡ്: /.well-known/mcp/server-card.json (
/mcp/server-card-ലും ലഭ്യമാണ്): കണക്റ്റ് ചെയ്യാതെതന്നെ പേര്, എൻഡ്പോയിന്റ്, ടൂളുകൾ, പതിപ്പുകൾ എന്നിവ അറിയാം. രജിസ്ട്രി കോൺഫിഗറേഷൻ:/.well-known/mcp/config-schema.json,/.well-known/mcp/examples.json. - AI കാറ്റലോഗ്: /.well-known/ai-catalog.json: പ്രവേശിക്കാനുള്ള എല്ലാ വഴികളും (MCP, ഈ API, A2A, NLWeb, Agent Skill), ഉദാഹരണ ക്വറികൾ സഹിതം.
- API കാറ്റലോഗ്: /.well-known/api-catalog, ഈ API-യും അതിന്റെ വിവരണവും ഈ രേഖകളും ചൂണ്ടിക്കാട്ടുന്ന ഒരു RFC 9727 ലിങ്ക്സെറ്റ്.
- Agent Skill: /.well-known/agent-skills/index.json,
SKILL.md-ഉം അതിന്റെ sha256 ഡൈജസ്റ്റും പട്ടികപ്പെടുത്തുന്നു. - OpenSearch: /opensearch.xml, തിരയൽ സേവനദാതാവായി Edgepedia-യെ ചേർക്കുന്നു.
- A2A:
https://www.edgepedia.org/a2a(JSON-RPC; A2A 1.0SendMessage, 0.3message/send; കാർഡ്/.well-known/agent-card.json-ൽ). ഒരു വിഷയത്തിന്റെ പേര് നൽകിയാൽ ഏറ്റവും അനുയോജ്യമായ അഞ്ച് ലേഖനങ്ങൾ ലഭിക്കും; ലേഖനത്തിന്റെ വിലാസം നൽകിയാൽ കടപ്പാട് വരിയോടുകൂടി Markdown രൂപത്തിൽ ആ ലേഖനം ലഭിക്കും. മറുപടി എപ്പോഴും ഒരു സന്ദേശമായിരിക്കും, ഒരിക്കലും ഒരു ടാസ്ക് ആയിരിക്കില്ല; ഇതേ മെത്തഡുകൾക്ക്/mcp-ലും മറുപടി ലഭിക്കും. - NLWeb:
https://www.edgepedia.org/ask?query=Mount%20Fuji(GET, അല്ലെങ്കിൽ JSON ബോഡിയോ ഫോം ബോഡിയോ ഉള്ള POST), NLWeb-ന്റെ പട്ടികരൂപത്തിൽ മറുപടി നൽകുന്നു; ഓരോ ഫലത്തിനും ഒരു schema.orgschema_objectഉണ്ടാകും;streaming=trueപട്ടികയെ സെർവർ അയയ്ക്കുന്ന ഇവന്റുകളായി അയയ്ക്കുന്നു. ഒരു മോഡലിനെയും വിളിക്കുന്നില്ല. - ലേഖനത്തിന്റെ യന്ത്രവായനയ്ക്കുള്ള രൂപങ്ങൾ:
Acceptഹെഡറിൽ പറയുന്ന രൂപം അതിന്റെ വിലാസത്തിൽനിന്ന് ലഭിക്കും:text/markdown(x-markdown-tokens-ന്റെ ഏകദേശ കണക്കോടെ),application/json(ഈ API-യുടെ മറുപടി), അല്ലെങ്കിൽapplication/ld+json; മറ്റെന്തു നൽകിയാലും പേജ് ലഭിക്കും. ലേഖനപ്പേജുകളിൽ ഈ രൂപങ്ങൾ, ലൈസൻസ്, API കാറ്റലോഗ്, OpenAPI വിവരണം എന്നിവ ചൂണ്ടിക്കാട്ടുന്ന ഒരുLinkഹെഡർ ഉണ്ടാകും.
ജനറേറ്റ് ചെയ്ത ഫയലുകൾ
/openapi.json-ൽനിന്ന് നിർമ്മിക്കുന്നതിനാൽ, ഇവ ഒരിക്കലും അതിൽനിന്ന് വ്യതിചലിക്കില്ല.
| ഫയൽ | എന്താണ് |
|---|---|
| /openapi-3.0.json | 3.1 വായിക്കാത്ത ടൂളുകൾക്കായി, അതേ വിവരണം OpenAPI 3.0.3-ൽ. |
| /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 എന്നിവയ്ക്കായി ഓരോ റൂട്ടിനും ഓരോ ഉദാഹരണ റിക്വസ്റ്റ്. |
കളക്ഷനുകളിൽ ചെയ്തിരിക്കുന്നതുപോലെ (edgepedia-collection/1), നിങ്ങളുടെ പ്രോഗ്രാമിന്റെ പേര് വ്യക്തമാക്കുന്ന ഒരു User-Agent ദയവായി അയയ്ക്കുക.