API ของ Edgepedia
บทความสารานุกรมกว่า 500,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 หน้าบทความทุกหน้าในหมวดทั่วไปจะใส่ลิงก์ที่อยู่ 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=1 | outline: หัวข้อทุกหัวข้อพร้อมขนาดเป็นจำนวนโทเคน |
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=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 บทความ 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/health | application/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 จะนับจำนวนตำแหน่งที่จัดบทความไว้ ดังนั้นบทความที่อยู่ในสองยุคสมัยของภูมิภาคหนึ่งจึงนับเป็นสองครั้ง |
การค้นพบและโพรโทคอลอื่น
- การ์ดเซิร์ฟเวอร์ 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 เป็นชุดลิงก์ตาม RFC 9727 ที่ระบุ API นี้ คำอธิบาย API และเอกสารชุดนี้
- 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 หรือ POST ที่มีเนื้อหาคำขอเป็น JSON หรือข้อมูลฟอร์ม) ตอบกลับในรูปแบบรายการของ NLWeb โดยแต่ละผลลัพธ์เป็นschema_objectของ schema.org;streaming=trueส่งรายการเป็นเหตุการณ์ SSE ไม่มีการเรียกใช้โมเดล - รูปแบบบทความสำหรับเครื่อง: ที่อยู่ของบทความจะตอบกลับในรูปแบบที่ส่วนหัว
Acceptระบุ ได้แก่text/markdown(พร้อมค่าประมาณx-markdown-tokens),application/json(คำตอบจาก API นี้) หรือapplication/ld+json; หากระบุอย่างอื่นจะได้หน้าเว็บ หน้าบทความมีส่วนหัวLinkที่ระบุรูปแบบเหล่านี้ สัญญาอนุญาต แค็ตตาล็อก API และคำอธิบาย OpenAPI
ไฟล์ที่สร้างอัตโนมัติ
สร้างจาก /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)