Edgepedia API
నిరంతరం పెరుగుతున్న, 5,00,000కు పైగా విజ్ఞానసర్వస్వ వ్యాసాలు 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). "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లను వదిలేస్తుంది. |
/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లో కస్టమ్ కనెక్టర్గా, 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నూ స్వీకరిస్తుంది. ప్రతి ఫలితంలో వ్యాసపు శాశ్వత 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 అభ్యర్థనలు, రోజుకు 1,00,000 అభ్యర్థనలు; APIకీ MCP సర్వర్కీ ఇదే వర్తిస్తుంది. ప్రతి ప్రతిస్పందనలో RateLimit-Policy ఈ రెండు కాలవ్యవధులనూ పేర్కొంటుంది. వాటిని మించితే, API Retry-After, RateLimitలతో 429ను ఇస్తుంది; MCP టూల్ కాల్ టూల్ దోషాన్ని ఇస్తుంది, అందులోని retry_after సెకన్లను తెలియజేస్తుంది. లెక్కలను ఒక్కో సర్వర్ ఇన్స్టెన్స్కు విడిగా ఉంచుతారు; అందువల్ల వీటిని దాటకూడని గరిష్ఠ పరిమితులుగా చూడాలి తప్ప, కచ్చితమైన వినియోగ కొలమానంగా కాదు. దయచేసి కాష్ చేసుకోండి. /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లకు కొత్త సంఖ్యలు ఇవ్వవచ్చు లేదా వాటిని విలీనం చేయవచ్చు; పాత idలు 308, POST /api/v1/ids/translateల ద్వారా ప్రతిస్పందిస్తూనే ఉంటాయి.
ఏదైనా పనిచేయడం లేదా? తెలియజేయండి.
రిఫరెన్స్
ఉత్పన్న డేటా (ప్రాముఖ్యం, పఠన స్థాయులు, లింకులు, తేదీలు, ఇతర పేర్లు, పూర్తి పాఠ్య సూచిక) నుంచి చదివే రూట్లు, ఫీల్డ్లు—ఆ డేటాను డేటా స్టోర్తో పాటు ప్రచురించే వరకు—Retry-Afterతో 503ను ఇస్తాయి లేదా ఆ ఫీల్డ్ను వదిలేస్తాయి.
వ్యాసాన్ని చదవడం
/api/v1/articles/{slug}, MCP fetch ఈ ఎంపికలను స్వీకరిస్తాయి; ఇవి లేకపోతే పూర్తి వ్యాసం వస్తుంది.
| ఎంపిక | అందించేది |
|---|---|
section={heading} | శీర్షిక లేదా దానిలోని ఒక పదం ఆధారంగా ఒక విభాగం, దాని ఉపవిభాగాలతో సహా (section=etymologyతో "Name and 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 (ఫ్లెష్–కిన్కెయిడ్), 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} | ఆ అంశం లేదా భౌగోళిక నోడ్ కింద ఉన్న వ్యాసాలు మాత్రమే; గరిష్ఠంగా 1,000 సరిపోలికల్లో ప్రతిదానినీ geo వడపోస్తుంది; ప్రతిస్పందన ఎంతవరకు పరిశీలించిందో 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" }] }. పేరు ఒక్కటితో ఏ వ్యాసమో తేలనప్పుడు 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, JavaScript స్ట్రింగ్ల స్థానాలను లెక్కించే విధంగా UTF-16 కోడ్ యూనిట్లలో: 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 | ఒక 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ను పంపండి.