edgepedia

Edgepedia

API ของ Edgepedia

บทความสารานุกรมกว่า 500,000 บทความ และเพิ่มขึ้นอย่างต่อเนื่อง ในรูปแบบ JSON ฟรี ไม่ต้องใช้คีย์ ไม่ต้องสมัคร ใช้เชิงพาณิชย์ได้โดยให้เครดิต เปิดให้ทุกคนนำไปฝึก AI ได้

ลองใช้งาน

เส้นทางสำหรับอ่านข้อมูลใช้ GET ส่วนการย้ายข้อมูล การเรียกแบบชุด และข้อความที่คุณส่งเข้าไปใช้ POST ทุกเส้นทางตอบกลับเป็น JSON ให้โปรแกรมหรือหน้าเว็บใดก็ได้ (CORS อนุญาตทุกออริจิน) คำอธิบายที่เครื่องอ่านได้อยู่ที่ /openapi.json พร้อมตัวอย่างการตอบกลับของทุกเส้นทาง ส่วนคำอธิบายเดียวกันในรูปแบบ OpenAPI 3.0 นิยามฟังก์ชันสำหรับโมเดล ชนิดข้อมูล TypeScript และชุดคำขอ อยู่ในหัวข้อไฟล์ที่สร้างอัตโนมัติด้านล่าง

การ์ดอ้างอิง

รูปแบบการแสดงผล

เลือกแล้ว: Cantor's diagonal argument

ตัวอย่าง

ชื่อบทความ บทสรุปฉบับเต็ม และเครดิต Edgepedia ในรูปแบบการ์ดสำหรับเว็บไซต์ของคุณ

/embed/{id}?theme=auto ให้บริการการ์ดตาม ID หลักของบทความ โดยเลือกรูปลักษณ์เป็น auto, light หรือ dark ได้ สคริปต์ /assets/edgepedia-embed.js ซึ่งจะใช้หรือไม่ก็ได้จะปรับขนาดกรอบให้พอดีกับเนื้อหา หากไม่ใช้ กรอบก็ยังอ่านและเลื่อนได้ตามปกติ

/embed/{slug} ก็ใช้ได้เช่นกัน โดยจะเปลี่ยนเส้นทางไปยังการ์ดที่ ID ของบทความ และคงธีมไว้ Edgepedia ยังเป็นผู้ให้บริการ oEmbed ด้วย: GET /oembed?url={article or card URL}&format=json ส่งโค้ดฝังตัวแบบเดียวกับเครื่องมือสร้างด้านบนกลับมาในรูป html พร้อมชื่อ ความกว้าง และความสูง โดยรองรับค่าของ maxwidth และ maxheight หน้าบทความทุกหน้าในหมวดทั่วไปจะใส่ลิงก์ที่อยู่ oEmbed ไว้ใน <head> เพื่อให้ WordPress, Discourse และระบบอื่นที่รองรับ oEmbed เปลี่ยนลิงก์ Edgepedia ที่วางลงไปให้เป็นการ์ดได้

เส้นทาง

เส้นทางสิ่งที่ส่งกลับ
/api/v1/search?q=wordsค้นหาจากชื่อบทความและชื่ออื่น ๆ โดยเรียงรายการที่ตรงที่สุดก่อน ให้ค้นด้วยชื่อเรื่องที่ต้องการ ไม่ใช่คำถาม แต่ละผลลัพธ์ประกอบด้วย id ชื่อบทความ หัวข้อระดับบนสุด ข้อความตัวอย่าง ลิงก์ และวิธีที่จับคู่ได้ (match, confidence) คำที่เป็นชื่อหัวข้อ เช่น "science fiction writers" จะส่ง topics ซึ่งเป็นลิงก์ไปยังบทความในหัวข้อนั้นกลับมาด้วย limit คือจำนวนรายการต่อหน้า ตั้งแต่ 1 ถึง 30 (ค่าเริ่มต้น 10); page ใช้เปลี่ยนหน้า และหน้าที่เลยหน้าสุดท้ายไปจะว่างเปล่า ใช้ชื่ออื่นและคำสะกดผิดได้ด้วย: "zhu yuanzhang" จะพบจักรพรรดิหงอู่ และ "siddartha" จะส่ง did_you_mean กลับมา ตัวเลือกเพิ่มเติมอยู่ในหัวข้อการค้นหาด้านล่าง
/api/v1/articles/{slug}บทความในรูปแบบ Markdown เส้นทางหัวข้อ ตำแหน่งในโครงสร้างต้นไม้ภูมิศาสตร์ (geo) วันที่ปรับปรุงล่าสุด และบรรทัดเครดิตที่ต้องแสดง ใช้ชื่อรูปแบบใดก็ได้ (Mount_Fuji, ชื่อบทความ, ที่อยู่แบบเต็ม) และใช้ตัวเลือกเพื่อรับเฉพาะส่วน โครงร่าง ข้อความบางช่วง หรือรูปแบบอื่นได้ ดูหัวข้อการอ่านบทความด้านล่าง
/api/v1/articles?id={id}ข้อมูลแบบเดียวกัน โดยเรียกผ่าน id หลังย้ายคลังบทความแล้ว id บทความเดิมยังคงใช้ค้นหาได้ ส่วน id หัวข้ออาจเปลี่ยนเมื่อปรับโครงสร้างต้นไม้ ที่อยู่อาจย้ายได้ แต่ที่อยู่เดิมยังตอบกลับ พร้อม moved_from ส่วน ids= รับได้ครั้งละไม่เกิน 10 รายการ
/api/v1/leads?ids={id},{id}บทความตาม id สูงสุด 50 บทความ แต่ละบทความอยู่ในรูปผลการค้นหา (id ชื่อบทความ หัวข้อระดับบนสุด ข้อความตัวอย่าง ลิงก์) สำหรับแสดงเป็นหน้ารวมการ์ด id ที่ย้ายหรือรวมเข้าด้วยกันแล้วจะส่งบทความที่คงอยู่กลับมา โดยใช้ id ที่ร้องขอเป็นคีย์ ส่วน id ในผลลัพธ์คือ id หลัก ระบบจะละ id ที่ไม่รู้จักหรือไม่พร้อมใช้งาน
/api/v1/randomบทความสุ่มหนึ่งบทความ new=1 เลือกจากบทความใหม่ล่าสุด; topic= หรือ geo= เลือกจากภายใต้โหนดที่ระบุ
/api/v1/related/{slug}บทความข้างเคียงในการเรียกครั้งเดียว: บทความที่ใกล้เคียงที่สุดในหัวข้อเดียวกันไม่เกิน 10 บทความ จากหัวข้อข้างเคียงไม่เกิน 8 หัวข้อ หัวข้อละ 3 บทความ และบทความที่ใกล้เคียงที่สุดในแต่ละโหนดภูมิศาสตร์ที่บทความนั้นสังกัดอยู่ โหนดละไม่เกิน 10 บทความ รองรับ ?id={id} ด้วย ส่วน by=links จะให้บทความที่ถูกอ้างอิงร่วมกับบทความนี้แทน
/api/v1/topicsระดับบนสุดของโครงสร้างต้นไม้หัวข้อ
/api/v1/topics/{id}เส้นทางของหัวข้อ หัวข้อย่อยพร้อมจำนวนบทความ และบทความทั้งหมดภายใต้หัวข้อนั้น หน้าละ 30 บทความ format=mermaid แสดงแผนผังต้นไม้ย่อยของหัวข้อนั้น
/api/v1/geoโครงสร้างต้นไม้ภูมิศาสตร์: ภูมิภาคต่าง ๆ พร้อมยุคสมัยของแต่ละภูมิภาค
/api/v1/geo/{id}โหนดภูมิศาสตร์ มีโครงสร้างเหมือนหัวข้อ ได้แก่ เส้นทาง โหนดย่อยที่เฉพาะเจาะจงขึ้น และบทความ หน้าละ 30 บทความ สำหรับภูมิภาคจะแสดงเฉพาะยุคสมัยของภูมิภาคนั้น
POST /api/v1/ids/translateเมื่อเปิดใช้การย้ายข้อมูล v1.5: ส่ง {"ids":["old-id", "another-id"]} (id ที่ไม่ซ้ำกันสูงสุด 500 รายการ) การตอบกลับจะจับคู่ id ที่ย้ายแล้วกับ id หลักที่คงอยู่ โดยละ id ที่ไม่เปลี่ยนแปลงหรือไม่รู้จัก บันทึกจุดตรวจสอบของชุดที่ทำเสร็จแล้ว และปฏิบัติตาม Retry-After

ข้อความตัวอย่างจะใช้ข้อความย่อจากคลังบทความหากมี มิฉะนั้นจะใช้ข้อความเปิดบทความ ระเบียนและผลลัพธ์ที่มีข้อความย่อจะใส่ข้อความนั้นไว้ใน snippet ด้วย ส่วน markdown ยังคงเป็นเนื้อหาบทความฉบับเต็ม หากมี node ค่านี้คือโหนดปัจจุบันของบทความในโครงสร้างต้นไม้แนวคิด

ทุกบทความยังมีฉบับ Markdown อยู่ที่ที่อยู่ของตัวเองด้วย เพียงเติม .md: www.edgepedia.org/koala.md

เซิร์ฟเวอร์ MCP

https://www.edgepedia.org/mcp เพิ่มลงใน Claude เป็นตัวเชื่อมต่อแบบกำหนดเอง เพิ่มลงใน ChatGPT โดยเปิดโหมดนักพัฒนา เพิ่มลงใน VS Code หรือ Cursor ได้ในคลิกเดียว หรือเพิ่มลงในไคลเอนต์ MCP อื่นด้วยที่อยู่ ไม่ต้องใช้คีย์ ไม่ต้องเข้าสู่ระบบ มีเครื่องมือแบบอ่านอย่างเดียวห้าตัว: search (รับชื่อเรื่อง ส่งกลับบทความที่ตรงกัน และส่งหัวข้อกลับมาด้วยหากคำที่ใช้เป็นชื่อหัวข้อ), fetch (บทความหนึ่งบทความในรูปแบบ Markdown พร้อมบรรทัดเครดิต เส้นทางหัวข้อ และภูมิศาสตร์; ใช้ citations: false เพื่อรับข้อความที่สั้นลงประมาณหนึ่งในสี่; id แบบ topic: จะแสดงหัวข้อแม่ หัวข้อย่อยที่เฉพาะเจาะจงขึ้น และบทความของหัวข้อนั้น ครั้งละ 120 บทความต่อ page; topic:root และ topic:geo คือระดับบนสุดของโครงสร้างต้นไม้หัวข้อและภูมิศาสตร์), related (บทความข้างเคียงในหัวข้อเดียวกัน หัวข้อใกล้เคียง และภูมิศาสตร์; ใช้ by: "links" เพื่อรับบทความที่ถูกอ้างอิงร่วมกัน), connect (from, to: ลำดับลิงก์ที่เชื่อมระหว่างสองบทความ เช่นเดียวกับที่ /api/v1/path ให้มา) และ resolve (name พร้อมตัวเลือก context และ type: บทความที่ชื่อนั้นน่าจะหมายถึงมากที่สุด เช่นเดียวกับที่ /api/v1/resolve ให้มา) หาก search ไม่พบชื่อบทความที่ตรงกัน บทความที่มีข้อความตรงกันจะตามหลังผลที่ตรงกับชื่อ โดยทำเครื่องหมาย match: fulltext อยู่ภายในจำนวนที่กำหนดด้วย limit และนับรวมใน pages ข้อผิดพลาดของเครื่องมือเป็นข้อความที่โมเดลอ่านได้ (พร้อม id ใน did_you_mean เมื่อระบุ id ที่ไม่มีบทความใดใช้); รหัสข้อผิดพลาดอยู่ใน _meta["ai.edgechat/error"] ไม่ใช่ structuredContent เมื่อใช้ fetch กับ links: "in" จะรับ links_page เพื่อเรียกบทความอีก 30 บทความถัดไปที่ลิงก์มายังบทความนั้น

search รับ limit (1 ถึง 30 ค่าเริ่มต้น 10), page, first, topic และ sort และตอบกลับด้วย page และ pages; fetch รับตัวเลือกบทความด้านล่าง และรับ ids สำหรับเรียกหลายบทความพร้อมกัน ทุกผลลัพธ์มี canonical_id ซึ่งเป็น id ถาวรของบทความ: fetch รับ id นี้ได้ และเมื่อ 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 การเรียก GET ไปยัง /mcp จะส่งการ์ดเซิร์ฟเวอร์กลับมาเป็น JSON ไคลเอนต์ที่รับเฉพาะ text/event-stream จะได้รับแต่ละคำตอบเป็นเหตุการณ์ SSE message หนึ่งเหตุการณ์ ค่า sha256 ของรายการเครื่องมือจะอยู่ใน _meta (ai.edgechat/tools-sha256) ของทุกคำตอบ จึงตรวจเห็นการเปลี่ยนแปลงคำอธิบายของเครื่องมือได้

Windows (รุ่นทดลอง บิลด์ 26220.7262 หรือใหม่กว่า): odr.exe mcp add --uri https://www.edgepedia.org/mcp คำสั่งตั้งค่าสำหรับไคลเอนต์อื่นทั้งหมด 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

ขีดจำกัด

600 คำขอต่อนาที และ 100,000 คำขอต่อวันต่อที่อยู่ IP ใช้เท่ากันทั้ง API และเซิร์ฟเวอร์ MCP ทุกคำตอบระบุช่วงเวลาทั้งสองไว้ใน RateLimit-Policy เมื่อเกินขีดจำกัด API จะตอบกลับ 429 พร้อม Retry-After และ RateLimit; การเรียกเครื่องมือ MCP จะตอบกลับเป็นข้อผิดพลาดของเครื่องมือ โดย retry_after ระบุเวลาเป็นวินาที ระบบเก็บยอดแยกตามอินสแตนซ์ของเซิร์ฟเวอร์ จึงควรถือว่าตัวเลขเหล่านี้เป็นเพดานที่ต้องไม่เกิน ไม่ใช่มาตรวัดที่เที่ยงตรง โปรดแคชข้อมูล การแปลง id จะนับ id ที่ร้องขอแต่ละรายการแยกกัน ส่วนชุดคำขอ /leads ที่ตรวจสอบ id เก่าก็นับตาม id เก่าแต่ละรายการเช่นกัน คำขอแบบชุดอื่น ๆ นับแต่ละ id หรือชื่อเป็นหนึ่งคำขอ ส่วนการใส่คำอธิบายประกอบนับหนึ่งคำขอต่อ 1,000 อักขระ

สัญญาอนุญาต

สัญญาอนุญาตชุมชน Edgepedia 1.0: ใช้ได้ฟรีโดยให้เครดิต รวมถึงการใช้เชิงพาณิชย์ เปิดให้ทุกคนนำไปฝึก AI ได้ และผลลัพธ์ของโมเดลไม่ต้องให้เครดิต สำหรับการใช้งานอื่น องค์กรที่มีรายได้เกิน 100 ล้านดอลลาร์สหรัฐ หรือมีผู้ใช้ต่อเดือนเกิน 100 ล้านราย ต้องทำสัญญาอนุญาตแยกต่างหาก

เครดิต: แสดงบรรทัด 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 หัวข้อที่ย้ายจะตอบกลับ 301 พร้อม id ใหม่ และ /api/v1/changes?since=<release> จะแสดงบทความทุกรายการที่เพิ่ม เปลี่ยนแปลง ย้าย หรือนำออกนับตั้งแต่รุ่นนั้น

/api/v1 รายงาน corpus_version, corpus_updated และ release_notes ค่าเหล่านี้ระบุรุ่นที่เผยแพร่ของคลังบทความหมวดทั่วไป และวันที่เผยแพร่รุ่นนั้น ไม่ใช่วันที่แก้ไขล่าสุดของทุกบทความ เมทาดาทาเดียวกันนี้ปรากฏในคำแนะนำของเซิร์ฟเวอร์ MCP ด้วย การออกรุ่นคลังบทความไม่เปลี่ยนเวอร์ชันซอฟต์แวร์ API หรือ MCP ส่วน id_policy ที่อยู่ในนั้นระบุข้อรับประกันของ id: การออกรุ่นอาจเปลี่ยนหมายเลขหรือรวม id เข้าด้วยกันได้ เช่นที่เกิดขึ้นในรุ่น 1.5 และ id เก่ายังคงตอบกลับผ่าน 308 และ POST /api/v1/ids/translate

มีอะไรใช้งานไม่ได้หรือไม่? แจ้งปัญหา

ข้อมูลอ้างอิง

เส้นทางและฟิลด์ที่อ่านจากข้อมูลที่ประมวลผลต่อมา (ระดับความสำคัญ ระดับชั้นการอ่าน ลิงก์ วันที่ ชื่ออื่น และดัชนีข้อความฉบับเต็ม) จะตอบกลับ 503 พร้อม Retry-After หรือละฟิลด์นั้นไว้ จนกว่าจะเผยแพร่ข้อมูลดังกล่าวพร้อมคลังข้อมูล

การอ่านบทความ

/api/v1/articles/{slug} และ MCP fetch รับตัวเลือกต่อไปนี้ หากไม่ระบุจะตอบกลับด้วยบทความทั้งฉบับ

ตัวเลือกสิ่งที่ส่งกลับ
section={heading}ส่วนหนึ่งของบทความ โดยระบุหัวข้อหรือคำใดคำหนึ่งในหัวข้อนั้น (section=etymology จะพบ "Name and etymology"; section=lead คือส่วนเปิดบทความ) พร้อมส่วนย่อยภายใน หากไม่รู้จักหัวข้อที่ระบุ จะตอบกลับ 404 พร้อม sections ของบทความ
outline=1outline: หัวข้อทุกหัวข้อพร้อมขนาดเป็นจำนวนโทเคน
max_tokens={n}ข้อความที่ตัดให้เหลือประมาณ n โทเคน โดยตัดตรงรอยต่อระหว่างส่วนหรือย่อหน้า พร้อม tokens_estimate, truncated และ next_cursor; ส่งค่านี้เป็น cursor โดยใช้ max_tokens เดิมเพื่อรับข้อความที่เหลือ
length=snippet, length=leadข้อความย่อ หรือชื่อบทความพร้อมย่อหน้าเปิด แทนเนื้อหาทั้งหมด
format=text, html, jsonld, turtle, tablesคำตอบในรูปข้อความล้วน เนื้อหาที่เรนเดอร์แล้ว หรือข้อมูลฟิลด์สาธารณะในรูป JSON-LD หรือ Turtle; tables ให้แต่ละตารางในรูป columns และ rows ในรูป csv และย้ายรายการอ้างอิงของตารางไปไว้ใน cites และ sources
chunks=1chunks: บทความที่แยกเป็นย่อหน้า แต่ละย่อหน้ามี id คงที่ซึ่งได้จากเส้นทางหัวข้อ (geology-2) และมี cite_url
q={words}&k={1–10}passages: ย่อหน้าที่ตรงกับคำที่ระบุมากที่สุดจำนวน k ย่อหน้า (ค่าเริ่มต้น 3) แต่ละย่อหน้ามี cite_url
quote={sentence or chunk id}cite_url: ที่อยู่บทความพร้อมตัวระบุส่วนข้อความ ซึ่งเปิดหน้าไปยังข้อความช่วงนั้น; quote_found ระบุว่าบทความมีข้อความนั้นหรือไม่
cite={format}cite: รายการอ้างอิงบทความ เช่นเดียวกับที่ /api/v1/cite ให้มา

คำตอบที่เป็นบทความทุกคำตอบยังมี speakable (ข้อความย่อในรูปที่ผู้ช่วยเสียงอ่านออกเสียงได้) ส่วน importance และ rank (PageRank จากลิงก์ระหว่างบทความ; อันดับ 1 อยู่ใจกลางเครือข่ายมากที่สุด เป็นการนับลิงก์ ไม่ใช่การตัดสินคุณค่าของเรื่องนั้น), words, reading_grade (เฟลช–คินเคด) และ reading_minutes จะมีต่อเมื่อ fields= ระบุชื่อไว้เท่านั้น (?fields=title,importance,rank); MCP fetch มีค่าเหล่านี้เสมอ next=1 เพิ่มบทความแนะนำให้อ่านต่อไม่เกิน 5 บทความ citations=false ใช้เครื่องหมาย [n] แทนลิงก์แหล่งข้อมูลที่แทรกในเนื้อหา ใน markdown, chunks และ passages เช่นเดียวกับ citations: false ของ MCP ที่อยู่ที่ไม่มีบทความใดใช้จะถูกอ่านเป็น id ของบทความ (/api/v1/articles/ep7rbwcy0a) หรือชื่อบทความ โดยไม่แยกตัวพิมพ์ใหญ่เล็กและเครื่องหมายกำกับเสียง (/api/v1/articles/paris); ที่อยู่ตัวพิมพ์เล็กซึ่งคั่นคำด้วยขีดกลางและไม่ตรงตามเกณฑ์นี้จะตอบกลับ 404 เว้นแต่จะเพิ่ม ?suggest=1 ส่วนที่อยู่ที่มีตัวพิมพ์ใหญ่ ช่องว่าง หรือขีดล่าง (/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}บทความทุกบทความในหมวดทั่วไป ไล่ตามลำดับที่กำหนดไว้: {id, slug, title, api_url} และ next (เป็น null เมื่อถึงท้ายสุด) หาก after= ว่าง จะเริ่มจากต้น และเริ่มไล่ต่อจาก id ใดก็ได้ แม้เป็น id ที่ถูกนำออกแล้ว
/api/v1/trees, /api/v1/trees/topic, /api/v1/trees/geoโครงสร้างต้นไม้หัวข้อและภูมิศาสตร์ทั้งต้น: nodes: [[id, label, parent index, own articles]]; id ที่ขึ้นต้นด้วยจุดเป็นส่วนที่ต่อท้าย id ของโหนดแม่
/api/v1/releasesรุ่นของคลังบทความ เรียงจากใหม่ที่สุด พร้อม current
/api/v1/healthapplication/health+json: pass, warn หรือ fail (503)
/api/v1/manifestเปลี่ยนเส้นทางไปยังไฟล์ JSONL ที่บีบอัดด้วย gzip หนึ่งไฟล์ แต่ละบรรทัดเป็นหนึ่งบทความ: { id, slug, title, updated, sha256, topic } (ค่า sha256 ของ .md ของบทความ) ดาวน์โหลดครั้งเดียวเพื่อทำสำเนา Edgepedia ค่าเช็กซัมคำนวณจากข้อความที่เผยแพร่ ก่อนการแก้ไขตามที่ผู้อ่านแจ้ง: บทความที่แก้ไขตามรายงานของผู้อ่านหลังออกรุ่นจะมีค่าไม่ตรงกันจนกว่าจะออกรุ่นถัดไป
/api/v1/changes?since={release}ไฟล์การเปลี่ยนแปลงตั้งแต่รุ่นที่ระบุจนถึงรุ่นปัจจุบัน ตามลำดับ (ฟีดเริ่มที่ 1.5: since=1.5 คือค่าแรกสุด); แต่ละบรรทัดคือ { op, id, … } โดย op เป็นค่าใดค่าหนึ่งใน added, changed, moved (from_slug คือที่อยู่เดิม) หรือ removed
/api/v1/events/{slug}ประโยคในบทความที่ระบุวันเดือนปี: { date, precision, text, para }, date ในรูป YYYY, YYYY-MM หรือ YYYY-MM-DD (เป็นค่าลบสำหรับก่อนคริสต์ศักราช: -0044-03-15) ปีก่อนคริสต์ศักราชใช้หลักทางประวัติศาสตร์ ไม่ใช่การนับปีทางดาราศาสตร์: -0044 คือ 44 ปีก่อนคริสต์ศักราช (ตัวแยกวิเคราะห์ ISO 8601 มาตรฐานจะอ่านเป็น 45 ปีก่อนคริสต์ศักราช) ประโยคนั้นคือหลักฐาน: อ่านก่อนถือว่าวันเดือนปีนั้นเป็นข้อเท็จจริง
/api/v1/aliases/{id}ชื่ออื่นของบทความ รวมถึงคำย่อที่บทความระบุไว้ ("NASA"); ไม่รวมคำสะกดผิดและรูปที่ต่างกันเพียงตัวพิมพ์ใหญ่เล็ก และหากชื่อเดียวกันมีสองรูปสะกด จะเก็บรูปที่ไม่มีจุด ("WHO" ไม่ใช่ "W.H.O.")

การระบุบทความ การใส่คำอธิบายประกอบ และการจับคู่ระเบียน

รับข้อความอิสระ ส่งกลับ id บทความ โดยไม่ใช้โมเดลหรือเวกเตอร์ฝังตัว ข้อความที่ส่งมาเพื่อใส่คำอธิบายประกอบ จัดหมวดหมู่ และแยกวิเคราะห์ภูมิศาสตร์จะไม่ถูกบันทึกลงล็อกหรือเก็บไว้

เส้นทางสิ่งที่ส่งกลับ
/api/v1/resolve?name=Mercury&context=planetบทความที่ชื่อนั้นน่าจะหมายถึงมากที่สุด: result, confidence, ambiguous, match (exact, alias, anchor, partial หรือ none) และ alternatives ส่วน type= เก็บเฉพาะรายการที่อาจตรงกันภายใต้ id หัวข้อเดียว (หากผลที่ตรงกับชื่อนั้น 30 รายการแรกไม่มีรายการใดอยู่ในหัวข้อนี้ การเรียกด้วยชื่อเดียวจะค้นต่อในอีก 60 รายการถัดไป); limit= มีค่าตั้งแต่ 1 ถึง 10 ส่วน POST รับได้สูงสุด 50 รายการ: { "names": ["Paris", "Koala"] } หรือ { "queries": [{ "name": "Mercury", "context": "planet" }] } หากชื่อเพียงอย่างเดียวยังชี้ชัดไม่ได้ว่าเป็นบทความใด จะตอบกลับ ambiguous: true พร้อมตัวเลือกที่น่าจะใช่ที่สุดใน result; ส่ง context เพื่อเลือก
/api/v1/surface?form=mercuryทุกบทความที่ลิงก์ภายในคลังบทความใช้วลีตรงตัวนี้อ้างถึง พร้อมจำนวนลิงก์และสัดส่วนของแต่ละบทความ (commonness)
/api/v1/suggest?prefix=koaบทความที่มีชื่อตรงกันทุกตัวอักษรก่อน ตามด้วยบทความที่มีชื่ออื่นตรงกันทุกตัวอักษร จากนั้นเป็นชื่อบทความที่ขึ้นต้นด้วยข้อความที่ระบุ แล้วจึงเป็นชื่ออื่นที่ขึ้นต้นเช่นนั้น (matched ระบุชื่อดังกล่าว) สำหรับช่องค้นหาและส่วนติดต่อด้วยเสียง
POST /api/v1/annotate{ "text": "…" } (ไม่เกิน 20,000 อักขระ): วลีแต่ละวลีที่เชื่อมโยงกับบทความ พร้อมตำแหน่งในข้อความ (start, end นับเป็นหน่วยรหัส UTF-16 เช่นเดียวกับที่ JavaScript ใช้ดัชนีเข้าถึงสตริง: ใน Python อักขระที่อยู่นอกระนาบพหุภาษาพื้นฐาน เช่น อีโมจิ ให้นับเป็นสองหน่วย) บทความ และค่าความเชื่อมั่น ส่วน ?format=html ส่งข้อความที่แปลงอักขระพิเศษของ HTML แล้วกลับมาด้วย โดยใส่ลิงก์ให้แต่ละวลี
POST /api/v1/classify{ "text": "…" }: หัวข้อที่ข้อความกล่าวถึง ให้คะแนนจากเส้นทางหัวข้อของบทความที่ข้อความเอ่ยถึง พร้อมสัดส่วนของหัวข้อระดับบนสุด
POST /api/v1/geoparse{ "text": "…" }: สถานที่และยุคสมัยที่ข้อความเอ่ยถึง บนโครงสร้างต้นไม้ภูมิศาสตร์ (nodes, regions, places, periods); กิ่งที่ไม่ใช่ภูมิศาสตร์ของโครงสร้างต้นไม้นี้ (geo.nongeo) จะไม่ถือเป็นสถานที่
/api/v1/mentions?term=CRISPRบทความที่กล่าวถึงเรื่องหนึ่งโดยไม่ลิงก์ไปยังบทความของเรื่องนั้น; complete: false หมายความว่ารายชื่อบทความที่ลิงก์มาถูกตัดให้สั้นลง
/api/v1/reconcileจุดปลายทางของ Reconciliation Service API 0.2: รายการประกาศบริการ, queries แบบชุด (GET หรือ POST), คำแนะนำเอนทิตี ชนิด และคุณสมบัติ, การแสดงตัวอย่าง และการขยายข้อมูล (title, url, excerpt, topic, topic_path, importance_rank) ใช้ JSONP ได้ด้วย callback= ใน OpenRefine: เลือก Reconcile › Start reconciling › Add standard service แล้ววาง https://www.edgepedia.org/api/v1/reconcile

กราฟลิงก์ วันเดือนปี และรายการ

แผนภาพ (format=mermaid) เป็นข้อความ Mermaid สำหรับระบบปลายทางที่เรนเดอร์ได้

เส้นทางสิ่งที่ส่งกลับ
/api/v1/links/{slug}ลิงก์จากบทความนี้ไปยังบทความอื่น ตามลำดับการอ่าน แต่ละลิงก์มีข้อความลิงก์และประโยคที่มีลิงก์นั้น
/api/v1/backlinks/{slug}?page=บทความที่ลิงก์มายังบทความนี้ หน้าละ 30 บทความ เรียงจากสำคัญที่สุด พร้อมข้อความลิงก์
/api/v1/path?from=&to=ลำดับลิงก์ที่สั้นที่สุดระหว่างสองบทความ (ไม่เกิน 6 ช่วง โดยเลี่ยงโหนดศูนย์กลางเมื่อทำได้) พร้อมประโยคที่เชื่อมแต่ละช่วง เซิร์ฟเวอร์ MCP เรียกสิ่งนี้ว่า connect
/api/v1/compare?a=&b=สองบทความเทียบเคียงกัน: ส่วนนำ เส้นทางหัวข้อ หัวข้อร่วมที่อยู่ลึกที่สุด ลำดับลิงก์ที่เชื่อมระหว่างกัน ลิงก์ที่มีร่วมกันและที่มีเฉพาะแต่ละบทความ และตารางข้อเท็จจริงสำคัญของแต่ละบทความ
/api/v1/graph/{slug}?depth=1|2&limit=บทความข้างเคียงที่สำคัญที่สุดไม่เกิน limit รายการ (ค่าเริ่มต้น 50 สูงสุด 200) และลิงก์ทั้งหมดระหว่างบทความเหล่านั้น ส่วน complete: false (ที่นี่ รวมถึงบน backlinks และ rank/top) หมายความว่าคำตอบถูกตัดให้สั้นลงเพราะเกินเวลาประมวลผลที่เส้นทางกำหนดไว้ราวหนึ่งวินาที; คำตอบเช่นนี้จะแคชไว้เพียงหนึ่งนาที
POST /api/v1/context{ "ids": [...] } รับ id หรือที่อยู่สูงสุด 50 รายการ (เช่นเดียวกับที่ /rank?ids= และ /leads?ids= รับได้): ส่งกลับลิงก์ระหว่างบทความเหล่านั้น บทความที่มีการเชื่อมโยงกับบทความส่วนใหญ่ในชุด หัวข้อและสถานที่ร่วมที่อยู่ลึกที่สุด และส่วนนำของแต่ละบทความ
/api/v1/rank?ids=, /api/v1/rank/top?topic=&limit=ความสำคัญตาม PageRank: ผลรวมของ pr ทั้งคลังบทความเท่ากับ 1 อันดับ 1 อยู่ใจกลางเครือข่ายมากที่สุด โปรดสังเกตชื่อ: importance บน /search และบทความคืออันดับนี้ในรูปเปอร์เซ็นไทล์ช่วง 0 ถึง 1; importance ของ /resolve คือค่า pr ดิบ และของ /leads คือ { pr, rank }
/api/v1/timeline?topic=|geo=&from=&to=ประโยคที่มีวันเดือนปีจากบทความในหัวข้อหรือสถานที่หนึ่ง เรียงจากเก่าที่สุด หน้าละ 50 รายการ; ปีก่อนคริสต์ศักราชเป็นค่าลบ แต่ละโหนดเก็บตัวอย่างเหตุการณ์สูงสุด 200 รายการโดยกระจายให้ครอบคลุมช่วงเวลา และ from กับ to ใช้กรองตัวอย่างนั้น; คำตอบที่ดึงจากชุดตัวอย่างซึ่งเต็มแล้วจะระบุ sampled: true และ cap และ total จะนับจำนวนในชุดตัวอย่าง
/api/v1/onthisday?date=MM-DD, /api/v1/year/{year}เหตุการณ์ในวันหนึ่งของปี (ค่าเริ่มต้นคือวันนี้ตามเวลา UTC) หรือในปีหนึ่ง (-9999 ถึง 2100) แต่ละวันเก็บเหตุการณ์สูงสุด 500 รายการ และแต่ละปี 2,000 รายการ; หากเต็มแล้วจะระบุ sampled: true
/api/v1/featured?date=, /api/v1/featured.xmlบทความเด่นประจำวัน (ข้อเท็จจริงวันนี้บนหน้าแรก) และฟีด Atom ย้อนหลังสิบวัน
/api/v1/list?topic=|geo=&period=&type=personบทความในหัวข้อหนึ่ง หรือในสถานที่และยุคสมัยหนึ่ง (TBC, T500, T1000, T1800, T1946, T2001, T2021, NODATE) หน้าละ 30 บทความ; type=person เก็บเฉพาะบุคคล แต่ละแถวในรายการภูมิศาสตร์มี geo และไม่มี id (เรียกบทความเพื่อรับค่านี้)
/api/v1/keyterms?topic=|geo=&limit=ชื่อบทความและชื่ออื่นภายในต้นไม้ย่อย สำหรับเตรียมคำศัพท์ให้ระบบรู้จำเสียงพูด
/api/v1/stats?topic=|geo=&by=periodเฉพาะจำนวน: บทความ ลิงก์ และชื่ออื่น สำหรับทั้งคลังบทความ หรือโหนดหนึ่งและโหนดย่อยของโหนดนั้น ที่นี่ articles นับบทความที่ไม่ซ้ำกัน; บน /geo และ /trees/geo จะนับจำนวนตำแหน่งที่จัดบทความไว้ ดังนั้นบทความที่อยู่ในสองยุคสมัยของภูมิภาคหนึ่งจึงนับเป็นสองครั้ง

การค้นพบและโพรโทคอลอื่น

ไฟล์ที่สร้างอัตโนมัติ

สร้างจาก /openapi.json จึงตรงกับไฟล์นั้นเสมอ

ไฟล์คำอธิบาย
/openapi-3.0.jsonคำอธิบายเดียวกันในรูป OpenAPI 3.0.3 สำหรับเครื่องมือที่อ่าน 3.1 ไม่ได้
/arazzo.jsonลำดับงาน Arazzo 1.0: ค้นหา ดึงบทความที่ตรงที่สุด แล้วดึงบทความที่เกี่ยวข้อง
/tools.jsonเส้นทาง JSON ทุกเส้นทางในรูปฟังก์ชันที่โมเดลเรียกใช้ได้ ตามรูปแบบของ OpenAI, Anthropic และ Gemini และในรูป JSON Schema พร้อมเส้นทางของแต่ละฟังก์ชัน
/edgepedia.d.tsชนิดข้อมูล TypeScript สำหรับทุกคำตอบและพารามิเตอร์ของทุกเส้นทาง
/edgepedia.postman_collection.json, /edgepedia.bruno.json, /edgepedia.insomnia.json, /edgepedia.httpตัวอย่างคำขอหนึ่งรายการต่อเส้นทาง สำหรับ Postman, Bruno, Insomnia และ VS Code หรือ JetBrains

โปรดส่ง User-Agent ที่ระบุชื่อโปรแกรมของคุณ เช่นเดียวกับที่ชุดคำขอเหล่านี้ทำ (edgepedia-collection/1)