Edgepedia API
Mahigit 500,000 artikulo sa ensiklopedya at patuloy na dumarami, sa anyong JSON. Libre. Walang key, walang pagpaparehistro. Maaaring gamitin sa komersiyo basta may pagkilala sa pinagmulan. Bukas sa lahat ang pagsasanay ng AI.
Subukan
- 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 ang gamit ng mga route para sa pagbasa; POST naman para sa migrasyon, mga batch, at tekstong ipinapadala mo. JSON ang tugon ng bawat route sa anumang programa o web page (pinapayagan ng CORS ang lahat ng origin). Paglalarawang nababasa ng makina: /openapi.json, na may halimbawang tugon para sa bawat route; nakalista sa Mga nabuong file, sa ibaba, ang katumbas nito sa OpenAPI 3.0, mga depinisyon ng function para sa mga modelo, mga type sa TypeScript, at mga koleksiyon ng request.
Mga card na sanggunian
Napili: Cantor's diagonal argument
Ang pamagat, buong buod, at pagkilala sa Edgepedia ng isang artikulo, sa isang card para sa iyong website.
Naghahatid ang /embed/{id}?theme=auto ng card batay sa kanonikal na ID ng artikulo. Maaaring auto, light, o dark ang hitsura. Inaangkop ng opsiyonal na script na /assets/edgepedia-embed.js ang frame sa nilalaman nito; kung wala ito, nababasa at naii-scroll pa rin ang frame.
Gumagana rin ang /embed/{slug}: nagre-redirect ito sa card sa ID ng artikulo, nang pinananatili ang tema. Provider din ng oEmbed ang Edgepedia: ibinabalik ng GET /oembed?url={article or card URL}&format=json ang kaparehong embed code mula sa builder sa itaas bilang html, kasama ang pamagat, lapad, at taas; sinusunod ang maxwidth at maxheight. Naka-link ang oEmbed address ng bawat pahina ng artikulo sa General sa <head> nito, kaya ginagawang card ng WordPress, Discourse, at iba pang gumagamit ng oEmbed ang isang idinikit na link ng Edgepedia.
Mga route
| Route | Ibinabalik |
|---|---|
/api/v1/search?q=words | Mga katugmang pamagat at iba pang pangalan, na nauuna ang pinakamalapit na tugma. Pangalan ng paksa ang hanapin, hindi tanong. Bawat resulta: id, pamagat, paksa sa pinakamataas na antas, paunang teksto, mga link, at kung paano ito tumugma (match, confidence). Ang mga salitang tumutukoy sa isang paksa, gaya ng "science fiction writers", ay nagbabalik din ng topics, isang link sa mga artikulo nito. Ang limit ang laki ng pahina, mula 1 hanggang 30 (default 10); nagpapalit ng pahina ang page, at walang laman ang pahinang lampas sa huli. Gumagana ang ibang pangalan at maling baybay: nahahanap ng "zhu yuanzhang" ang Emperador Hongwu, at ibinabalik ng "siddartha" ang did_you_mean. Iba pang opsiyon: Paghahanap, sa ibaba. |
/api/v1/articles/{slug} | Ang artikulo bilang Markdown, ang landas nito sa mga paksa, ang mga puwesto nito sa punong heograpiko (geo), ang petsa ng huling pag-update nito, at ang linyang pagkilalang dapat ipakita. Gumagana ang anumang pangalan (Mount_Fuji, isang pamagat, isang buong address), at maaaring ibalik ng mga opsiyon ang isang seksiyon, balangkas, mga sipi, o iba pang anyo: Pagbasa ng artikulo, sa ibaba. |
/api/v1/articles?id={id} | Gaya rin nito, ayon sa id. Patuloy na tumutugon ang mga lumang id ng artikulo matapos ang migrasyon ng korpus; maaaring magbago ang mga id ng paksa kapag nirebisa ang puno. Maaaring lumipat ang isang address; tumutugon pa rin ang luma, na may moved_from. Tumatanggap ang ids= ng hanggang 10 nang sabay-sabay. |
/api/v1/leads?ids={id},{id} | Hanggang 50 artikulo ayon sa id, bawat isa bilang resulta ng paghahanap (id, pamagat, paksa sa pinakamataas na antas, paunang teksto, mga link), para sa isang pahina ng mga card. Para sa mga id na nailipat o pinagsama, ibinabalik ang natirang artikulo, na naka-key sa hiniling na id; kanonikal ang id ng resulta. Hindi isinasama ang mga id na hindi kilala o hindi magagamit. |
/api/v1/random | Isang artikulong pinili nang sapalaran. Pumipili ang new=1 mula sa mga pinakabagong artikulo; pumipili naman ang topic= o geo= sa ilalim ng isang node. |
/api/v1/related/{slug} | Mga kapitbahay ng isang artikulo sa iisang tawag: hanggang 10 pinakamalapit dito sa sarili nitong paksa, tig-3 mula sa hanggang 8 kalapit na paksa, at hanggang 10 pinakamalapit dito sa bawat node na heograpiko na kinabibilangan nito. May ?id={id} din. Sa halip, ibinibigay ng by=links ang mga artikulong sinisipi kasabay nito. |
/api/v1/topics | Ang tuktok ng puno ng mga paksa. |
/api/v1/topics/{id} | Ang landas ng isang paksa, ang mga subpaksa nito kasama ang bilang ng mga artikulo, at bawat artikulo sa ilalim nito, tig-30 sa isang pahina. Iginuguhit ng format=mermaid ang sanga nito sa puno. |
/api/v1/geo | Ang punong heograpiko: ang mga rehiyon nito, bawat isa ay may kani-kaniyang mga panahon. |
/api/v1/geo/{id} | Isang node na heograpiko, na kapareho ng estruktura ng isang paksa: ang landas nito, ang mas tiyak na mga node, at mga artikulo, tig-30 sa isang pahina. Mga panahon lamang nito ang inililista ng isang rehiyon. |
POST /api/v1/ids/translate | Kapag naka-enable ang migrasyon sa v1.5: ipadala ang {"ids":["old-id", "another-id"]} (hanggang 500 magkakaibang id). Itinatapat ng tugon ang mga nailipat na id sa kanilang kanonikal na mga natira; hindi isinasama ang mga id na hindi nagbago o hindi kilala. Itala ang mga natapos na batch bilang checkpoint at sundin ang Retry-After. |
Ginagamit bilang paunang teksto ang maikling sipi sa korpus kung mayroon, at ang simula ng artikulo kung wala. Kasama rin ito bilang snippet sa mga rekord at resultang may maikling sipi; nananatiling buong teksto ng artikulo ang markdown. Ang node, kung mayroon, ang kasalukuyang node ng artikulo sa puno ng mga konsepto.
May Markdown din ang bawat artikulo sa sarili nitong address. Idagdag ang .md: www.edgepedia.org/koala.md.
MCP server
https://www.edgepedia.org/mcp. Idagdag ito sa Claude bilang custom connector, sa ChatGPT habang naka-on ang Developer mode, sa VS Code o Cursor sa isang click, o sa alinmang ibang MCP client gamit ang address nito. Walang key, walang pag-sign in. Limang tool na para sa pagbasa lamang: search (pangalan ng paksa ang ipinapasok, mga katugmang artikulo ang ibinabalik, at isang paksa kung may tinutukoy na ganoon ang mga salita), fetch (isang artikulo bilang Markdown, kasama ang linya ng pagkilala, landas sa mga paksa, at heograpiya nito; citations: false para sa tekstong mas maikli nang halos isang-kapat; inililista ng isang id na topic: ang magulang na paksa nito, mas tiyak na mga paksa, at mga artikulo, tig-120 sa isang page; ang topic:root at topic:geo ang mga tuktok ng puno ng mga paksa at ng punong heograpiko), related (mga kapitbahay ng isang artikulo sa paksa nito, mga kalapit na paksa, at heograpiya; by: "links" para sa mga artikulong sinisipi kasabay nito), connect (from, to: ang kawing ng mga link sa pagitan ng dalawang artikulo, gaya ng ibinibigay ng /api/v1/path), at resolve (name, na may opsiyonal na context at type: ang artikulong pinakamalamang na tinutukoy ng isang pangalan, gaya ng ibinibigay ng /api/v1/resolve). Kapag hindi tumugma sa mga pamagat ang isang search, isinusunod sa mga tugma sa pamagat ang mga artikulong may tugma sa teksto, na minarkahang match: fulltext, saklaw ng limit at binibilang sa pages. Ang error ng tool ay tekstong binabasa ng modelo (na may mga id na did_you_mean para sa id na walang katumbas na artikulo); nasa _meta["ai.edgechat/error"] ang code nito, hindi kailanman sa structuredContent. Tumatanggap ang fetch na may links: "in" ng links_page para sa susunod na 30 artikulong naka-link doon.
Tumatanggap ang search ng limit (1 hanggang 30, default 10), page, first, topic, at sort, at ibinabalik ang page at pages; tinatanggap ng fetch ang mga opsiyon sa artikulo sa ibaba at ang ids para sa ilan nang sabay-sabay. Taglay ng bawat resulta ang canonical_id, ang permanenteng id ng artikulo: tinatanggap ito ng fetch, at kapag lumipat na ang isang id o address na itinabi mo, ibinabalik ng fetch ang artikulo na ang moved_from ay nakatakda sa hiniling mo. Tinutukoy ng mga resulta ang release ng korpus sa _meta.corpus_version. Nakakakuha rin ng tig-isang resource_link bawat artikulo ang mga client sa protocol 2025-06-18 o mas bago.
Mga resource: edgepedia://article/{slug} (isang artikulo bilang Markdown, kaparehong teksto ng fetch) at edgepedia://topic/{id} (mas tiyak na mga paksa at mga artikulo ng isang paksa), na parehong may awtomatikong pagkumpleto; nagmumungkahi rin ang awtomatikong pagkumpleto ng mga pamagat ng artikulo para sa anumang argument na tumutukoy sa isang artikulo. Inihahatid din sa MCP ang Agent Skill (skills/list, skills/get), bilang skill://edgepedia/SKILL.md. Ibinabalik ng isang GET ng /mcp ang server card bilang JSON. Nakukuha ng mga client na text/event-stream lamang ang tinatanggap ang bawat tugon bilang isang SSE event na message. Kasama sa _meta (ai.edgechat/tools-sha256) ng bawat tugon ang sha256 ng listahan ng mga tool, kaya nakikita ang pagbabago sa paglalarawan ng isang tool.
Windows (preview, build 26220.7262 o mas bago): odr.exe mcp add --uri https://www.edgepedia.org/mcp. Mga linyang pang-setup para sa lahat ng iba pang client, isang Agent Skill, at mga halimbawa: github.com/EdgePlat/edgepedia-mcp.
Walang MCP, o lumang SSE transport lamang ang sinusuportahan ng client? Bigyan ang iyong modelo ng dalawang function na tumatawag sa /api/v1/search at /api/v1/articles/{slug}, o kunin ang mga handa nang gamitin sa /tools.json. Sumasagot ng 404 ang mga address ng lumang transport (/sse, /mcp/sse), na may body na tumutukoy sa https://www.edgepedia.org/mcp.
Mga limitasyon
600 request bawat minuto at 100,000 bawat araw sa bawat IP address, kapwa para sa API at sa MCP server. Tinutukoy ng bawat tugon ang dalawang saklaw ng oras sa RateLimit-Policy. Kapag lumampas sa mga ito, sumasagot ang API ng 429 na may Retry-After at RateLimit; ang tawag sa isang MCP tool ay nagbabalik ng error ng tool na ang retry_after ay nagsasaad ng mga segundo. Hiwalay ang bilang sa bawat instance ng server, kaya mga hangganang hindi dapat lampasan ang mga ito, hindi isang eksaktong panukat. Mangyaring gumamit ng cache. Sa POST /api/v1/ids/translate, hiwalay na binibilang ang bawat hiniling na id; sinisingil din bawat lumang id ang mga batch na /leads na sumusuri sa mga lumang id. Sa ibang mga batch, itinuturing na isang request ang bawat id o pangalan, at sa annotate, isa bawat 1,000 character.
Lisensiya
Edgepedia Community License 1.0: libre basta may pagkilala sa pinagmulan, kasama ang paggamit sa komersiyo. Bukas sa lahat ang pagsasanay ng AI, at hindi kailangan ng pagkilala sa output ng isang modelo. Para sa iba pang gamit, kailangang kumuha ng hiwalay na lisensiya ang mga organisasyong may higit sa USD 100 milyon na kita o 100 milyong buwanang gumagamit.
Pagkilala: ipakita ang linyang credit ng bawat artikulo, kasama ang link nito, saanman mo ipinapakita ang teksto nito. Kasama rin ito sa mga tugon para sa artikulo bilang credit_md at credit_html, na handa nang idikit, at license.spdx (LicenseRef-Edgepedia-Community-1.0). Kasama ang Link: <https://www.edgepedia.org/edgepedia/license>; rel="license" at X-License: LicenseRef-Edgepedia-Community-1.0 sa mga tugon ng API para sa artikulo at para sa /leads.
Libre ngunit pagmamay-ari namin ang EdgeChat app, ang mga Edge App nito, at ang aming software: walang ibinibigay na source code, at hindi maaaring kopyahin, baguhin, o muling ipamahagi ang mga ito (EdgeChat License Agreement).
Mga error
JSON: { "error": { "code": "not_found", "message": "…" } }. 400 kulang ang q, 404 hindi nahanap, 410 inalis, 413 masyadong mahaba ang teksto, 429 masyadong maraming request, 503 subukang muli. Tinutukoy ng isang 404 ang susunod na tawag: hint, next (isang URL), at, para sa address ng artikulong walang ibinabalik, did_you_mean na may tatlong pinakamalapit na pamagat. Taglay rin ng error na hindi nahanap mula sa MCP tool na fetch ang gayong did_you_mean.
Mga pagbabago
Pinananatili ng Bersiyon 1 ang estruktura nito: maaaring magdagdag ng mga field, ngunit hinding-hindi papalitan ang pangalan o aalisin ang mga ito. Nasa /edgepedia/updates ang mga pagbabago mismo sa Edgepedia. Kapag muling inayos ng isang release ang puno ng mga paksa, gaya ng ginawa ng 1.8.0, sumasagot ng 301 ang isang nailipat na id ng paksa kasama ang bagong id nito, at inililista ng /api/v1/changes?since=<release> ang bawat artikulong idinagdag, binago, inilipat, o inalis mula noong release na iyon.
Iniuulat ng /api/v1 ang corpus_version, corpus_updated, at release_notes. Tinutukoy ng mga ito ang inilathalang release ng korpus na General at ang petsa ng release nito, hindi ang petsa ng huling pag-edit sa bawat artikulo. Makikita ang gayon ding metadata sa mga tagubilin ng MCP server. Hindi binabago ng mga release ng korpus ang bersiyon ng software ng API o MCP. Sinasabi ng id_policy doon kung ano ang ginagarantiya ng isang id: maaaring muling bilangin o pagsamahin ang mga id sa isang release, gaya ng ginawa ng 1.5, at patuloy na tumutugon ang mga lumang id, sa pamamagitan ng isang 308 at POST /api/v1/ids/translate.
May hindi gumagana? Iulat ito.
Sanggunian
Ang mga route at field na bumabasa mula sa datos na hinango (kahalagahan, antas ng pagbasa, mga link, petsa, iba pang pangalan, at indeks ng buong teksto) ay sumasagot ng 503 na may Retry-After, o hindi isinasama ang field, hanggang mailathala ang datos na iyon kasama ng imbakan.
Pagbasa ng artikulo
Tinatanggap ng /api/v1/articles/{slug} at MCP fetch ang mga opsiyong ito; kung wala ang mga ito, buong artikulo ang tugon.
| Opsiyon | Ibinabalik |
|---|---|
section={heading} | Isang seksiyon, ayon sa heading nito o isang salita roon (nahahanap ng section=etymology ang "Name and etymology"; ang section=lead ang pambungad), kasama ang mga subseksiyon nito. Sumasagot ng 404 ang hindi kilalang heading, kasama ang sections ng artikulo. |
outline=1 | outline: bawat heading kasama ang laki nito sa mga token. |
max_tokens={n} | Ang tekstong pinaikli sa humigit-kumulang n token, na pinuputol sa hangganan ng seksiyon o talata, kasama ang tokens_estimate, truncated, at next_cursor; ipasa ito bilang cursor na may kaparehong max_tokens para sa natitira. |
length=snippet, length=lead | Ang maikling sipi, o ang pamagat at pambungad na talata, kapalit ng buong teksto. |
format=text, html, jsonld, turtle, tables | Ang tugon bilang payak na teksto, ang na-render na body, o JSON-LD o Turtle ng mga pampublikong field nito; ibinibigay ng tables ang bawat talahanayan bilang columns at rows, bilang csv, at may mga pagsiping inilipat sa cites at sources. |
chunks=1 | chunks: ang artikulo bilang mga talata, bawat isa ay may matatag na id batay sa landas ng heading nito (geology-2) at may cite_url. |
q={words}&k={1–10} | passages: ang k talata (default 3) na pinakamalapit na tumutugma sa mga salita, bawat isa ay may cite_url. |
quote={sentence or chunk id} | cite_url: ang address ng artikulo na may text fragment na nagbubukas sa pahina sa mismong siping iyon; sinasabi ng quote_found kung nasa artikulo ito. |
cite={format} | cite: isang sanggunian sa artikulo, gaya ng ibinibigay ng /api/v1/cite. |
Taglay rin ng bawat tugon para sa artikulo ang speakable (ang maikling sipi sa anyong maaaring basahin ng isang voice assistant). Ang importance at rank (PageRank batay sa mga link sa pagitan ng mga artikulo; 1 ang pinakasentro; bilang ito ng mga link, hindi paghusga sa paksa), words, reading_grade (Flesch-Kincaid), at reading_minutes ay kasama lamang kapag tinukoy sila sa fields= (?fields=title,importance,rank); laging kasama ang mga ito sa MCP fetch. Nagdaragdag ang next=1 ng hanggang 5 artikulong maaaring basahin kasunod. Naglalagay ang citations=false ng mga panandang [n] kapalit ng mga link sa sanggunian na nakapaloob sa teksto, sa markdown, chunks, at passages, gaya ng ginagawa ng citations: false ng MCP. Ang isang address na hindi ginagamit ng alinmang artikulo ay binabasa bilang id ng artikulo (/api/v1/articles/ep7rbwcy0a) o bilang pamagat nito, nang hindi isinasaalang-alang ang laki ng titik at mga tuldik (/api/v1/articles/paris); ang address na maliliit ang titik at pinagdurugtong ng gitling, ngunit hindi sapat ang pagkakatugma para rito, ay nagbabalik ng 404 maliban kung idagdag mo ang ?suggest=1, samantalang ang address na may malalaking titik, espasyo, o underscore (/api/v1/articles/Albert_Einstein) ay binabasa bilang pangalan, kaya kapag malapit lamang ang tugma, ibinabalik ang pinakamahusay na resulta ng paghahanap kasama ang resolved_by: search. Kapag hindi address ng artikulo ang pangalang ibinigay mo, sinasabi ng tugon kung paano ito binasa (resolved_from, resolved_by: address, pamagat, o paghahanap) at inililista ang 3 iba pang artikulong nearest. Nagbabalik ang /api/v1/articles?ids={slug or id},{name} ng hanggang 10 bilang articles (bawat isa ay may pangalang tinutugunan nito bilang asked) at missing; inilalapat ang bawat opsiyon sa bawat isa.
Pagsipi sa artikulo
Nagbibigay ang /api/v1/cite/{slug}?format= ng sanggunian sa csl (CSL-JSON, ang default), bibtex, ris, apa, mla, chicago, o harvard, kasama ang linya ng pagkilala bilang teksto, Markdown, at HTML; gayon din ang ginagawa ng /api/v1/cite?ids={id},{slug} para sa hanggang 50. Edgepedia (EdgeChat) ang may-akda; minamarkahan ng APA, MLA, Chicago, at Harvard ang pamagat na nakapahilis sa pamamagitan ng mga asterisk, gaya sa Markdown. Taglay rin ng Mga card na sanggunian ang kaparehong pagsipi, na hindi nakikita sa pahina, bilang COinS at JSON-LD, para sa mga programang namamahala ng sanggunian.
Paghahanap
match | Kailan | confidence |
|---|---|---|
exact | Ang pamagat mismo ang query. | 1.0 para sa unang ganitong resulta, 0.9 para sa mga kasunod |
alias | Tumugma ang ibang pangalan, o ang mga inisyal ng pamagat ("mlk"). | 0.8; 0.7 para sa unang resultang walang alinmang salita sa query; 0.6 para sa query na isinalin sa ibang sistema ng pagsulat |
misspelling | Itinama ng paghahanap ang query (did_you_mean). | 0.5 × ang bahagdan ng nai-type na query na nanatili sa pagwawasto |
partial | Nasa pamagat ang ilan sa mga salita sa query, o nasa teksto lamang. | 0.2 + 0.5 × ang bahagdan ng mga salita sa query na nasa pamagat; 0.2 kung nasa teksto lamang |
fulltext | Walang tumugmang pamagat o ibang pangalan, kaya hinalughog ang teksto ng mga artikulo (BM25): nahahanap sa pamamagitan ng paglalarawan ang artikulong hindi mo alam ang pangalan. | hindi bababa sa 0.2 |
none | Walang tumugma. Walang laman ang tugon. | 0 |
Nakatakdang tuntunin ang antas ng katiyakan, hindi isang kinalibrang probabilidad; walang laman ang ibinabalik na tugon kung mas mababa sa 0.2 ang marka ng pinakamahusay na resulta. Taglay ng bawat resulta ang highlight, ang pangungusap sa buod nito na may pinakamaraming salita mula sa query. Ang paghahanap na walang nahanap ay muling sinusubukan nang isang beses gamit ang mga titik Latin (isinusulat sa titik Latin ang Cyrillic, Griyego, kana, at Hangul, inaalis ang mga numerong pantono sa pinyin, at pinaiikli ang mga dobleng patinig sa romaji), at tinutukoy ito sa tugon bilang searched_as. Hindi isinasalin sa titik Latin ang mga karakter na Tsino.
| Opsiyon | Ginagawa nito |
|---|---|
first=true | Ang pinakamahusay na tugma lamang, o wala. |
topic={id}, geo={id} | Mga artikulo lamang sa ilalim ng paksang iyon o node na heograpiko; sinasala ng geo ang lahat ng tugma hanggang 1,000, at sinasabi ng scope kung hanggang saan ang saklaw ng tugon. |
sort=central | Inuuna ang mga paksang may pinakamaraming link na tumuturo sa mga ito, mula sa lahat ng tugma hanggang 1,000. |
max_grade={grade} | Mga artikulo lamang na nasa o mas mababa sa tinukoy na baitang ng pagbasa. |
facets=1 | Bilang ng mga tugma ayon sa paksa sa pinakamataas na antas at ayon sa heograpikong rehiyon, mula sa lahat ng tugma hanggang 1,000 (facets.counted). |
Bawat tugon
Pinananatili lamang ng fields=a,b ang mga tinukoy na key ng bawat resulta (o ng tugon, kapag wala itong mga resulta); nananatili ang panlabas na balangkas (total, page, next, license). Ang isang 200 na maaaring i-cache ay may kasamang ETag: ipadala itong muli bilang If-None-Match at kung hindi nagbago ang tugon, magiging 304 ito na walang body. Ang Last-Modified ang petsa ng release ng korpus at para lamang sa impormasyon. Tinutukoy ng Edgepedia-Corpus-Version ang release ng korpus, at ang Content-Digest ang SHA-256 ng body (RFC 9530); taglay rin ang dalawang ito ng .md ng isang artikulo.
Iba pang route
| Route | Ibinabalik |
|---|---|
/api/v1/articles?after={id}&limit={1..1000} | Bawat artikulo sa General, na dinaraanan sa isang nakatakdang pagkakasunod-sunod: {id, slug, title, api_url} at next (null sa dulo). Nagsisimula sa umpisa kapag walang laman ang after=, at maaaring ipagpatuloy ang pagdaan pagkatapos ng anumang id, kahit inalis na iyon. |
/api/v1/trees, /api/v1/trees/topic, /api/v1/trees/geo | Ang buong puno ng mga paksa at punong heograpiko: nodes: [[id, label, parent index, own articles]]; ang id na nagsisimula sa tuldok ay pagpapatuloy ng id ng magulang nito. |
/api/v1/releases | Mga release ng korpus, mula sa pinakabago, at current. |
/api/v1/health | application/health+json: pass, warn, o fail (503). |
/api/v1/manifest | Isang redirect sa isang gzip JSONL file, na may isang linya bawat artikulo: { id, slug, title, updated, sha256, topic } (sha256 ng .md ng artikulo). Kunin ito nang isang beses upang magkaroon ng salaming kopya ng Edgepedia. Para sa inilathalang teksto ang checksum, bago ang mga pagwawastong mula sa mambabasa: hindi tutugma rito ang artikulong nabago mula noong release dahil sa pagwawastong iniulat ng mambabasa, hanggang sa susunod na release. |
/api/v1/changes?since={release} | Ang mga file ng pagbabago mula sa release na iyon hanggang sa kasalukuyan, ayon sa pagkakasunod-sunod (nagsisimula ang feed sa 1.5: since=1.5 ang pinakamaaga); bawat linya ay { op, id, … }, na ang op ay isa sa added, changed, moved (from_slug ang lumang address), o removed. |
/api/v1/events/{slug} | Ang mga pangungusap sa artikulo na nagsasaad ng petsa: { date, precision, text, para }, date bilang YYYY, YYYY-MM, o YYYY-MM-DD (negatibo bago ang karaniwang panahon: -0044-03-15). Sinusunod ng mga petsang BC ang kumbensiyong pangkasaysayan, hindi ang mga taong astronomiko: ang -0044 ay 44 BC (babasahin ito ng isang karaniwang ISO 8601 parser bilang 45 BC). Ang pangungusap ang ebidensiya: basahin muna ito bago ituring na katotohanan ang petsa. |
/api/v1/aliases/{id} | Iba pang pangalan ng isang artikulo, kabilang ang mga akronim na nakasaad sa mga artikulo ("NASA"); hindi isinasama ang mga maling baybay at mga baryanteng laki lamang ng titik ang pagkakaiba, at sa dalawang baybay ng iisang pangalan, pinananatili ang walang tuldok ("WHO", hindi "W.H.O."). |
Pagtukoy, paglalagay ng anotasyon, at pagtutugma
Malayang teksto ang ipinapasok, mga id ng artikulo ang ibinabalik, nang walang modelo at walang mga embedding. Ang tekstong ipinapadala sa annotate, classify, at geoparse ay hindi kailanman itinatala sa log o iniimbak.
| Route | Ibinabalik |
|---|---|
/api/v1/resolve?name=Mercury&context=planet | Ang artikulong pinakamalamang na tinutukoy ng isang pangalan: result, confidence, ambiguous, match (exact, alias, anchor, partial, o none), at alternatives. Nililimitahan ng type= ang mga kandidato sa ilalim ng iisang id ng paksa (kapag walang naroon sa unang 30 tugma ng pangalan, sinusuri rin ang susunod na 60 para sa isang pangalang hiniling nang mag-isa); ang limit= ay 1 hanggang 10. Tumatanggap ang POST ng hanggang 50: { "names": ["Paris", "Koala"] } o { "queries": [{ "name": "Mercury", "context": "planet" }] }. Kapag hindi sapat ang pangalan lamang upang matukoy ang iisang artikulo, ang tugon ay ambiguous: true kasama ang pinakamahusay na hula bilang result; ipasa ang context upang pumili. |
/api/v1/surface?form=mercury | Bawat artikulong tinukoy ng sariling mga link ng korpus sa pamamagitan ng eksaktong pariralang ito, kasama ang bilang ng mga link at ang bahagdan ng bawat isa (commonness). |
/api/v1/suggest?prefix=koa | Una ang artikulong gayon mismo ang pamagat, kasunod ang eksaktong tinutukoy ng ibang pangalan, pagkatapos ang mga pamagat na nagsisimula sa prefix, at saka ang ibang pangalang nagsisimula rin dito (ibinibigay ng matched ang pangalang iyon), para sa mga kahon ng paghahanap at voice interface. |
POST /api/v1/annotate | { "text": "…" } (hindi hihigit sa 20,000 character): bawat pariralang may link kasama ang mga offset nito (start, end, sa mga code unit na UTF-16, gaya ng pag-index ng JavaScript sa mga string: sa Python, binibilang na dalawa ang isang karakter sa labas ng Basic Multilingual Plane, gaya ng emoji), artikulo, at antas ng katiyakan. Ibinabalik din ng ?format=html ang teksto, na naka-HTML escape at may link ang bawat parirala. |
POST /api/v1/classify | { "text": "…" }: ang mga paksang tinatalakay ng teksto, na minamarkahan ayon sa mga landas sa paksa ng mga artikulong binabanggit nito, at ang mga bahagdan sa pinakamataas na antas. |
POST /api/v1/geoparse | { "text": "…" }: ang mga lugar at panahong pinapangalanan nito, sa punong heograpiko (nodes, regions, places, periods); hindi kailanman itinuturing na lugar ang di-heograpikong sanga ng puno (geo.nongeo). |
/api/v1/mentions?term=CRISPR | Mga artikulong bumabanggit ng isang paksa nang hindi nagli-link sa artikulo nito; nangangahulugan ang complete: false na pinutol ang listahan ng mga artikulong nagli-link dito. |
/api/v1/reconcile | Isang endpoint ng Reconciliation Service API 0.2: ang manifest, batch na queries (GET o POST), mga mungkahi para sa entity, type, at property, isang paunang pagtingin, at pagpapalawak ng datos (title, url, excerpt, topic, topic_path, importance_rank). JSONP na may callback=. Sa OpenRefine: Reconcile › Start reconciling › Add standard service, at idikit ang https://www.edgepedia.org/api/v1/reconcile. |
Ang grap ng mga link, mga petsa, at mga listahan
Tekstong Mermaid ang mga diyagram (format=mermaid), para sa host na nagre-render nito.
| Route | Ibinabalik |
|---|---|
/api/v1/links/{slug} | Ang mga link ng artikulo sa iba pang artikulo, ayon sa pagkakasunod sa pagbasa, bawat isa ay may tekstong kawing at pangungusap nito. |
/api/v1/backlinks/{slug}?page= | Ang mga artikulong nagli-link dito, tig-30 sa isang pahina, na nauuna ang pinakamahalaga, kasama ang kanilang tekstong kawing. |
/api/v1/path?from=&to= | Ang pinakamaikling kawing ng mga link sa pagitan ng dalawang artikulo (hanggang 6 na hakbang, na umiiwas hangga't maaari sa mga sentrong maraming link), kasama ang pangungusap na nagdurugtong sa bawat hakbang. Tinatawag ito ng MCP server na connect. |
/api/v1/compare?a=&b= | Dalawang artikulong magkatabi: mga pambungad, landas sa mga paksa, ang pinakamalalim na paksang kapwa nila kinabibilangan, ang kawing sa pagitan nila, mga link na pareho at bukod sa kanila, at ang talahanayang Mahahalagang katotohanan ng bawat isa. |
/api/v1/graph/{slug}?depth=1|2&limit= | Hanggang limit (default 50, hindi hihigit sa 200) sa pinakamahahalagang kapitbahay nito, at bawat link sa pagitan nila. Ang complete: false (dito, sa backlinks, at sa rank/top) ay nangangahulugang napaikli ang tugon dahil sa takdang oras ng route na humigit-kumulang isang segundo; isang minuto lamang naka-cache ang ganitong tugon. |
POST /api/v1/context | { "ids": [...] }, hanggang 50 id o address (gaya ng pagtanggap din sa mga ito ng /rank?ids= at /leads?ids=): ang mga link sa pagitan nila, ang mga artikulong may ugnayang link sa karamihan sa kanila, ang pinakamalalim na paksa at lugar na kapwa nila kinabibilangan, at ang pambungad ng bawat isa. |
/api/v1/rank?ids=, /api/v1/rank/top?topic=&limit= | Kahalagahan ayon sa PageRank: 1 ang kabuuan ng pr sa buong korpus, at ranggong 1 ang pinakasentro. Pansinin ang mga pangalan: ang importance sa /search at sa mga artikulo ay ang ranggong ito bilang percentile mula 0 hanggang 1; ang importance ng /resolve ay ang mismong pr, at ang sa /leads ay { pr, rank }. |
/api/v1/timeline?topic=|geo=&from=&to= | Mga pangungusap na may petsa mula sa mga artikulo ng isang paksa o lugar, mula sa pinakamatanda, tig-50 sa isang pahina; negatibo ang mga taon para sa BC. Nagpapanatili ang isang node ng hanggang 200 pangyayaring nakakalat sa mga petsa nito, at sinasala ng from at to ang sampol na iyon; ang tugong hinango sa sampol na umabot sa takdang dami ay nagsasaad ng sampled: true at ng cap nito, at sampol ang binibilang ng total nito. |
/api/v1/onthisday?date=MM-DD, /api/v1/year/{year} | Mga pangyayari sa isang araw ng taon (kasalukuyang araw sa UTC ang default), o sa isang taon (-9999 hanggang 2100). Hanggang 500 pangyayari ang laman ng isang araw at 2,000 ng isang taon; kapag umabot sa takdang dami, isinasaad ang sampled: true. |
/api/v1/featured?date=, /api/v1/featured.xml | Ang tampok na artikulo ng araw (ang Katotohanan ngayong araw sa pambungad na pahina), at isang Atom feed ng nakaraang sampung araw. |
/api/v1/list?topic=|geo=&period=&type=person | Mga artikulo ng isang paksa, o ng isang lugar at panahon (TBC, T500, T1000, T1800, T1946, T2001, T2021, NODATE), tig-30 sa isang pahina; mga tao lamang ang pinananatili ng type=person. Taglay ng mga hanay sa isang listahang heograpiko ang geo at walang id (kunin ang artikulo para rito). |
/api/v1/keyterms?topic=|geo=&limit= | Mga pamagat at iba pang pangalan para sa isang sangay ng puno, upang ihanda ang isang sistema ng pagkilala sa pananalita. |
/api/v1/stats?topic=|geo=&by=period | Mga bilang lamang: mga artikulo, link, at iba pang pangalan para sa korpus o sa isang node at mga anak nito. Dito, magkakaibang artikulo ang binibilang ng articles; sa /geo at /trees/geo, mga pagkakalagay ang binibilang nito, kaya dalawang beses na nabibilang doon ang isang artikulong nasa dalawang panahon ng isang rehiyon. |
Pagtuklas at iba pang protocol
- Card ng MCP server: /.well-known/mcp/server-card.json (gayundin ang
/mcp/server-card): pangalan, endpoint, mga tool, at mga bersiyon, nang hindi kumokonekta. Configuration ng registry:/.well-known/mcp/config-schema.jsonat/.well-known/mcp/examples.json. - Katalogo ng AI: /.well-known/ai-catalog.json: lahat ng paraan ng pag-access (MCP, ang API na ito, A2A, NLWeb, at ang Agent Skill), kasama ang mga halimbawang query.
- Katalogo ng API: /.well-known/api-catalog, isang linkset na sumusunod sa RFC 9727 at tumutukoy sa API na ito, sa paglalarawan nito, at sa dokumentasyong ito.
- Agent Skill: inililista ng /.well-known/agent-skills/index.json ang
SKILL.mdkasama ang sha256 digest nito. - OpenSearch: idinaragdag ng /opensearch.xml ang Edgepedia bilang tagapagbigay ng paghahanap.
- A2A:
https://www.edgepedia.org/a2a(JSON-RPC; A2A 1.0SendMessageat 0.3message/send; nasa/.well-known/agent-card.jsonang card). Kapag pangalan ng paksa ang ibinigay, ibinabalik ang nangungunang limang artikulo; kapag address ng artikulo, ibinabalik ang artikulo bilang Markdown kasama ang linya ng pagkilala nito. Laging mensahe ang tugon, hindi kailanman task, at sinasagot din sa/mcpang gayunding mga method. - NLWeb: sumasagot ang
https://www.edgepedia.org/ask?query=Mount%20Fuji(GET, o POST na may JSON o form body) sa anyong listahan ng NLWeb, na may isang schema.orgschema_objectbawat resulta; ipinapadala ngstreaming=trueang listahan bilang mga event na ipinapadala ng server. Walang modelong tinatawag. - Mga anyo ng artikulo para sa makina: ibinabalik ng address nito ang anyong tinutukoy ng header na
Accept:text/markdown(na may pagtatantiya ngx-markdown-tokens),application/json(ang tugon ng API na ito), oapplication/ld+json; ang pahina ang ibinabalik para sa anumang iba pa. May header naLinkang mga pahina ng artikulo na tumutukoy sa mga anyong ito, sa lisensiya, sa katalogo ng API, at sa paglalarawan ng OpenAPI.
Mga nabuong file
Binuo mula sa /openapi.json, kaya hindi kailanman lumilihis dito.
| File | Ano ito |
|---|---|
| /openapi-3.0.json | Ang parehong paglalarawan sa OpenAPI 3.0.3, para sa mga tool na hindi nakakabasa ng 3.1. |
| /arazzo.json | Isang workflow sa Arazzo 1.0: maghanap, kunin ang pinakamahusay na tugma, pagkatapos ay ang mga kaugnay na artikulo nito. |
| /tools.json | Bawat JSON route bilang function na maaaring tawagin ng isang modelo, sa mga format ng OpenAI, Anthropic, at Gemini, at bilang JSON Schema kasama ang route nito. |
| /edgepedia.d.ts | Mga type sa TypeScript para sa bawat tugon at sa mga parameter ng bawat route. |
| /edgepedia.postman_collection.json, /edgepedia.bruno.json, /edgepedia.insomnia.json, /edgepedia.http | Isang halimbawang request bawat route para sa Postman, Bruno, Insomnia, at VS Code o JetBrains. |
Mangyaring magpadala ng User-Agent na nagsasaad ng pangalan ng iyong programa, gaya ng ginagawa ng mga collection (edgepedia-collection/1).