Edgepedia API
JSON biçiminde, sayısı sürekli artan 500.000'den fazla ansiklopedi maddesi. Ücretsiz. Anahtar yok, kayıt yok. Kaynak göstererek ticari kullanım serbest. Yapay zekâ eğitimi herkese açık.
Deneyin
- 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
Okuma uç noktaları GET; geçiş, toplu işlemler ve gönderdiğiniz metinler POST kullanır. Her uç nokta, her programa veya web sayfasına JSON yanıtı verir (CORS tüm kaynaklara izin verir). Makine tarafından okunabilir açıklama: /openapi.json; her uç nokta için örnek bir yanıt içerir. Bunun OpenAPI 3.0 biçimi, modeller için işlev tanımları, TypeScript türleri ve istek koleksiyonları da aşağıdaki Oluşturulan dosyalar bölümünde listelenmiştir.
Referans kartları
Seçilen: Cantor's diagonal argument
Web siteniz için bir kartta maddenin başlığı, tam özeti ve Edgepedia kaynak bilgisi.
/embed/{id}?theme=auto, maddenin kanonik kimliğine göre bir kart sunar. Görünüm auto, light veya dark olabilir. İsteğe bağlı /assets/edgepedia-embed.js betiği, çerçeveyi içeriğine göre boyutlandırır; betik olmadan da çerçeve okunabilir ve kaydırılabilir durumda kalır.
/embed/{slug} de çalışır: temayı koruyarak maddenin kimliğindeki karta yönlendirir. Edgepedia aynı zamanda bir oEmbed sağlayıcısıdır: GET /oembed?url={article or card URL}&format=json, yukarıdaki oluşturucuyla aynı gömme kodunu html olarak, başlık, genişlik ve yükseklik bilgileriyle birlikte döndürür; maxwidth ve maxheight dikkate alınır. Genel derlemindeki her madde sayfası, <head> içinde kendi oEmbed adresine bağlantı verir; böylece WordPress, Discourse ve diğer oEmbed istemcileri, yapıştırılan bir Edgepedia bağlantısını karta dönüştürür.
Uç noktalar
| Uç nokta | Döndürdüğü |
|---|---|
/api/v1/search?q=words | Başlıkları ve diğer adları eşleştirir; en iyi eşleşmeler önce gelir. Soru değil, konunun adını arayın. Her sonuç şunları içerir: kimlik, başlık, en üst düzey konu, önizleme metni, bağlantılar ve eşleşme biçimi (match, confidence). “science fiction writers” gibi bir konuyu adlandıran sözcükler, o konunun maddelerine bağlantı veren topics öğesini de döndürür. limit, 1 ile 30 arasındaki sayfa boyutudur (varsayılan 10); page sayfalar arasında geçiş yapar; son sayfadan sonraki bir sayfa boştur. Diğer adlar ve yanlış yazımlar da işe yarar: “zhu yuanzhang” araması Hongwu İmparatoru'nu bulur, “siddartha” ise did_you_mean döndürür. Diğer seçenekler için aşağıdaki Arama bölümüne bakın. |
/api/v1/articles/{slug} | Markdown biçiminde maddeyi, konu yolunu, coğrafya ağacındaki yerlerini (geo), son güncellenme tarihini ve gösterilecek kaynak satırını döndürür. Her türlü ad kullanılabilir (Mount_Fuji, bir başlık, tam bir adres); seçeneklerle bir bölüm, ana hatlar, pasajlar veya başka biçimler döndürülür: aşağıdaki Bir maddeyi okuma bölümüne bakın. |
/api/v1/articles?id={id} | Aynı bilgileri kimliğe göre döndürür. Eski madde kimlikleri, derlem geçişinden sonra da çözümlenmeye devam eder; ağaç yeniden düzenlendiğinde konu kimlikleri değişebilir. Bir adres taşınabilir; eski adres moved_from ile yanıt vermeyi sürdürür. ids= tek seferde en fazla 10 tane alır. |
/api/v1/leads?ids={id},{id} | Kartlardan oluşan bir sayfa için, kimliğe göre en fazla 50 maddeyi, her biri bir arama sonucu biçiminde (kimlik, başlık, en üst düzey konu, önizleme metni, bağlantılar) döndürür. Taşınmış ve birleştirilmiş kimlikler, istenen kimlik anahtarı altında, kullanımda kalan maddeyi döndürür; sonuçtaki id kanoniktir. Bilinmeyen veya kullanılamayan kimlikler sonuçlara alınmaz. |
/api/v1/random | Rastgele bir madde. new=1 en yeni maddeler arasından; topic= veya geo= ise bir düğümün altından seçim yapar. |
/api/v1/related/{slug} | Bir maddenin komşularını tek çağrıda döndürür: kendi konusunda ona en yakın en fazla 10 madde, en fazla 8 komşu konunun her birinden 3 madde ve bulunduğu her coğrafya düğümünde ona en yakın en fazla 10 madde. ?id={id} de kullanılabilir. by=links ise bunun yerine onunla birlikte atıfta bulunulan maddeleri verir. |
/api/v1/topics | Konu ağacının kökü. |
/api/v1/topics/{id} | Bir konunun yolu, madde sayılarıyla birlikte alt konuları ve sayfa başına 30 tane olmak üzere altındaki tüm maddeler. format=mermaid alt ağacını çizer. |
/api/v1/geo | Coğrafya ağacı: bölgeler ve her birinin dönemleri. |
/api/v1/geo/{id} | Konuyla aynı yapıda bir coğrafya düğümü: yolu, daha dar kapsamlı düğümleri ve sayfa başına 30 tane olmak üzere maddeleri. Bir bölge yalnızca dönemlerini listeler. |
POST /api/v1/ids/translate | v1.5 geçişi etkinse: {"ids":["old-id", "another-id"]} gönderin (en fazla 500 farklı kimlik). Yanıt, taşınan kimlikleri kullanımda kalan kanonik kimliklerle eşler; değişmeyen veya bilinmeyen kimlikler dahil edilmez. Tamamlanan gruplar için ilerleme kaydı tutun ve Retry-After değerine uyun. |
Önizleme metni için, varsa derlemdeki kısa alıntı, yoksa maddenin girişi kullanılır. Kısa alıntısı olan kayıtlar ve sonuçlar bunu snippet olarak da içerir; markdown, maddenin tam metni olarak kalır. node, mevcutsa, maddenin kavram ağacındaki güncel düğümüdür.
Her madde kendi adresinde Markdown biçiminde de sunulur. .md ekleyin: www.edgepedia.org/koala.md.
MCP sunucusu
https://www.edgepedia.org/mcp. Claude'a özel bağlayıcı olarak, ChatGPT'ye Geliştirici modu açıkken, VS Code veya Cursor uygulamasına tek tıklamayla ya da başka herhangi bir MCP istemcisine adresiyle ekleyin. Anahtar yok, oturum açmak yok. Beş salt okunur araç: search (bir konunun adını alır, eşleşen maddeleri ve sözcükler bir konu adı oluşturuyorsa o konuyu döndürür), fetch (kaynak satırı, konu yolu ve coğrafya bilgisiyle birlikte Markdown biçiminde tek bir madde; yaklaşık dörtte bir oranında daha kısa bir metin için citations: false; bir topic: kimliği, o konunun üst konusunu, daha dar kapsamlı konularını ve maddelerini, page başına 120 tane olacak şekilde listeler; topic:root ve topic:geo, konu ve coğrafya ağaçlarının kökleridir), related (bir maddenin kendi konusundaki, yakın konulardaki ve coğrafyadaki komşuları; onunla birlikte atıfta bulunulan maddeler için by: "links"), connect (from, to: /api/v1/path tarafından verildiği biçimiyle iki madde arasındaki bağlantı zinciri) ve resolve (name, isteğe bağlı context ve type ile: /api/v1/resolve tarafından verildiği biçimiyle bir adın en olası karşılığı olan madde). Bir search aramasında başlık eşleşmesi bulunmadığında, metni eşleşen maddeler de başlık eşleşmelerinin ardından, match: fulltext ile işaretlenerek, limit sınırı içinde ve pages sayısına dahil edilerek sunulur. Araç hatası, modelin okuduğu bir metindir (hiçbir maddeye ait olmayan bir kimlik için did_you_mean kimlikleriyle birlikte); hata kodu _meta["ai.edgechat/error"] içinde taşınır, asla structuredContent içinde değil. links: "in" ile kullanılan fetch, oraya bağlantı veren sonraki 30 madde için links_page alır.
search; limit (1 ile 30 arası, varsayılan 10), page, first, topic ve sort alır, page ve pages döndürür; fetch aşağıdaki madde seçeneklerini ve birden fazlasını aynı anda almak için ids kabul eder. Her sonuç, maddenin kalıcı kimliği olan canonical_id öğesini taşır: fetch bunu kabul eder; kaydettiğiniz bir kimlik veya adres taşındığında ise fetch maddeyi, moved_from alanında sizin istediğiniz değer olacak şekilde döndürür. Sonuçlar, derlem sürümünü _meta.corpus_version içinde belirtir. 2025-06-18 veya sonraki protokol sürümlerini kullanan istemciler, her madde için ayrıca bir resource_link alır.
Kaynaklar: edgepedia://article/{slug} (Markdown biçiminde bir madde, fetch ile aynı metin) ve edgepedia://topic/{id} (bir konunun daha dar kapsamlı konuları ve maddeleri); her ikisi için de tamamlama desteği vardır. Tamamlama, bir maddeyi adlandıran her bağımsız değişken için madde başlıkları da önerir. Ajan Becerisi de MCP üzerinden (skills/list, skills/get), skill://edgepedia/SKILL.md olarak sunulur. /mcp adresine yapılan bir GET isteği, sunucu kartını JSON olarak döndürür. Yalnızca text/event-stream kabul eden istemciler her yanıtı tek bir SSE message olayı olarak alır. Araç listesinin sha256 değeri, her yanıtın _meta alanında (ai.edgechat/tools-sha256) taşınır; böylece bir aracın açıklamasındaki değişiklik görülebilir.
Windows (önizleme, derleme 26220.7262 veya sonrası): odr.exe mcp add --uri https://www.edgepedia.org/mcp. Diğer tüm istemciler için kurulum satırları, bir Ajan Becerisi ve örnekler: github.com/EdgePlat/edgepedia-mcp.
MCP yok mu, yoksa istemciniz yalnızca eski SSE aktarımını mı destekliyor? Modelinize /api/v1/search ve /api/v1/articles/{slug} çağrısı yapan iki işlev verin ya da bunları /tools.json adresinden hazır alın. Eski aktarımın adresleri (/sse, /mcp/sse), gövdesinde https://www.edgepedia.org/mcp belirtilen bir 404 yanıtı verir.
Sınırlar
Hem API hem de MCP sunucusu için IP adresi başına dakikada 600, günde 100.000 istek. Her yanıt, her iki zaman aralığını da RateLimit-Policy içinde belirtir. Sınırlar aşıldığında API, Retry-After ve RateLimit ile 429 yanıtı verir; MCP araç çağrısı ise retry_after alanında saniye sayısını veren bir araç hatası döndürür. Sayımlar sunucu örneği başına tutulur; dolayısıyla bunlar kesin bir sayaç değil, altında kalınması gereken üst sınırlardır. Lütfen önbellek kullanın. Kimlik çevirisi, istenen her kimliği ayrı ayrı sayar; eski kimlikleri sorgulayan /leads toplu işlemleri de eski kimlik başına sayılır. Diğer toplu işlemlerde her kimlik veya ad bir istek, açıklama ekleme işleminde ise her 1.000 karakter bir istek sayılır.
Lisans
Edgepedia Topluluk Lisansı 1.0: ticari kullanım dahil, kaynak gösterme koşuluyla ücretsiz. Yapay zekâ eğitimi herkese açıktır ve bir modelin çıktısında kaynak gösterilmesi gerekmez. Diğer kullanımlar için, geliri 100 milyon ABD dolarını veya aylık kullanıcı sayısı 100 milyonu aşan kuruluşların ayrıca lisans alması gerekir.
Kaynak gösterimi: Bir maddenin metnini gösterdiğiniz her yerde, o maddenin credit satırını bağlantısıyla birlikte gösterin. Madde yanıtları bunu yapıştırılmaya hazır olarak credit_md ve credit_html biçiminde, ayrıca license.spdx (LicenseRef-Edgepedia-Community-1.0) olarak da taşır. API'nin madde ve /leads yanıtları Link: <https://www.edgepedia.org/edgepedia/license>; rel="license" ve X-License: LicenseRef-Edgepedia-Community-1.0 içerir.
EdgeChat uygulaması, onun Edge Apps uygulamaları ve yazılımlarımız ücretsizdir, ancak özel mülkiyete tabidir: kaynak kodları sağlanmaz; kopyalanamaz, değiştirilemez veya yeniden dağıtılamazlar (EdgeChat Lisans Sözleşmesi).
Hatalar
JSON: { "error": { "code": "not_found", "message": "…" } }. 400 eksik q, 404 bulunamadı, 410 kaldırıldı, 413 metin çok uzun, 429 çok fazla istek, 503 yeniden deneyin. Bir 404 yanıtı, sonraki çağrıyı belirtir: hint, next (bir URL) ve hiçbir sonuç döndürmeyen bir madde adresi için, en yakın üç başlığı içeren did_you_mean. MCP fetch aracının bulunamadı hatası da aynı did_you_mean öğesini taşır.
Değişiklikler
Sürüm 1 yapısını korur: alanlar eklenebilir, ancak hiçbir zaman yeniden adlandırılmaz veya kaldırılmaz. Edgepedia'nın kendi değişiklikleri /edgepedia/updates adresindedir. Bir sürüm, 1.8.0'da olduğu gibi konu ağacını yeniden düzenlediğinde, taşınmış bir konu kimliği yeni kimliğiyle birlikte 301 yanıtı verir; /api/v1/changes?since=<release> ise o sürümden bu yana eklenen, değiştirilen, taşınan veya kaldırılan tüm maddeleri listeler.
/api/v1; corpus_version, corpus_updated ve release_notes bilgilerini bildirir. Bunlar, her maddenin son düzenlenme tarihini değil, Genel derleminin yayımlanan sürümünü ve bu sürümün yayımlanma tarihini belirtir. Aynı üst veriler MCP sunucusu talimatlarında da yer alır. Derlem sürümleri, API veya MCP yazılım sürümünü değiştirmez. Buradaki id_policy, bir kimliğin neyi garanti ettiğini açıklar: 1.5'te olduğu gibi, bir sürümde kimlikler yeniden numaralandırılabilir veya birleştirilebilir; eski kimlikler ise 308 ve POST /api/v1/ids/translate aracılığıyla yanıt vermeyi sürdürür.
Bir şey çalışmıyor mu? Bildirin.
Referans
Türetilmiş verilerden (önem, okuma düzeyleri, bağlantılar, tarihler, diğer adlar ve tam metin dizini) okuyan uç noktalar ve alanlar, bu veriler veri deposuyla birlikte yayımlanana kadar Retry-After ile 503 yanıtı verir veya ilgili alanı yanıta dahil etmez.
Bir maddeyi okuma
/api/v1/articles/{slug} ve MCP fetch şu seçenekleri kabul eder; seçenek kullanılmadığında yanıt maddenin tamamıdır.
| Seçenek | Döndürdüğü |
|---|---|
section={heading} | Başlığına veya başlığındaki bir sözcüğe göre, alt bölümleriyle birlikte tek bir bölüm (section=etymology, “Adı ve etimolojisi” bölümünü bulur; section=lead giriştir). Bilinmeyen bir başlık, maddenin sections öğesiyle birlikte 404 yanıtı verir. |
outline=1 | outline: token cinsinden boyutlarıyla birlikte tüm başlıklar. |
max_tokens={n} | tokens_estimate, truncated ve next_cursor ile birlikte, bir bölüm veya paragraf sınırında yaklaşık n token uzunluğunda kesilmiş metin; kalanını almak için bunu aynı max_tokens ile cursor olarak iletin. |
length=snippet, length=lead | Tam metin yerine kısa alıntı veya başlık ve giriş paragrafı. |
format=text, html, jsonld, turtle, tables | Düz metin olarak yanıt, işlenmiş gövde veya herkese açık alanlarının JSON-LD ya da Turtle biçimi; tables, her tabloyu columns ve rows olarak, csv biçiminde ve atıfları cites ile sources içine taşınmış olarak verir. |
chunks=1 | chunks: her biri başlık yolundan (geology-2) türetilmiş sabit bir kimliğe ve bir cite_url öğesine sahip paragraflar halinde madde. |
q={words}&k={1–10} | passages: sözcüklerle en iyi eşleşen k paragraf (varsayılan 3), her biri bir cite_url öğesiyle birlikte. |
quote={sentence or chunk id} | cite_url: sayfayı ilgili pasajda açan bir metin parçası içeren madde adresi; quote_found, maddenin bu parçayı içerip içermediğini belirtir. |
cite={format} | cite: /api/v1/cite tarafından verildiği biçimiyle maddeye bir kaynakça atfı. |
Her madde yanıtı ayrıca speakable içerir (kısa alıntının sesli asistanın okuyabileceği biçimi). importance ve rank (maddeler arasındaki bağlantılar üzerinden hesaplanan PageRank; 1 en merkezî olandır; konunun değerine ilişkin bir yargı değil, bağlantı sayımına dayalı bir ölçüdür), words, reading_grade (Flesch-Kincaid) ve reading_minutes yalnızca fields= içinde adları belirtildiğinde gelir (?fields=title,importance,rank); MCP fetch bunları her zaman içerir. next=1, ardından okunabilecek en fazla 5 madde ekler. citations=false, MCP'nin citations: false seçeneği gibi, markdown, chunks ve passages içinde satır içi kaynak bağlantıları yerine [n] işaretleri verir. Hiçbir maddeye ait olmayan bir adres, bir maddenin kimliği (/api/v1/articles/ep7rbwcy0a) veya büyük-küçük harf ve aksan işaretleri göz ardı edilerek başlığı (/api/v1/articles/paris) olarak okunur; bundan daha gevşek bir eşleşme sunan, küçük harfli ve kısa çizgilerle ayrılmış bir adres, ?suggest=1 eklemediğiniz sürece 404 yanıtı verir. Buna karşılık büyük harf, boşluk veya alt çizgi içeren bir adres (/api/v1/articles/Albert_Einstein) ad olarak okunur; dolayısıyla tam tutmayan bir ad, resolved_by: search ile birlikte en iyi arama eşleşmesini döndürür. Verdiğiniz ad maddenin adresi değilse yanıt, bunun nasıl okunduğunu belirtir (resolved_from, resolved_by: adres, başlık veya arama) ve en yakın diğer 3 maddeyi nearest içinde listeler. /api/v1/articles?ids={slug or id},{name}, en fazla 10 maddeyi articles olarak (her birinin karşılık geldiği ad asked içinde olacak şekilde) ve missing döndürür; her seçenek her bir maddeye uygulanır.
Bir maddeye atıfta bulunma
/api/v1/cite/{slug}?format=; csl (varsayılan olan CSL-JSON), bibtex, ris, apa, mla, chicago veya harvard biçiminde bir kaynakça atfını, metin, Markdown ve HTML biçimindeki kaynak satırıyla birlikte verir; /api/v1/cite?ids={id},{slug} aynısını en fazla 50 madde için yapar. Yazar Edgepedia'dır (EdgeChat); APA, MLA, Chicago ve Harvard, Markdown'da olduğu gibi, italik başlığı yıldız işaretleriyle belirtir. Referans kartları da kaynakça yönetim araçları için aynı atfı, görünmez biçimde COinS ve JSON-LD olarak taşır.
Arama
match | Ne zaman | confidence |
|---|---|---|
exact | Başlık sorguyla aynıdır. | Bu tür ilk sonuç için 1,0; sonraki için 0,9 |
alias | Başka bir ad veya başlığın baş harfleri ("mlk") eşleşmiştir. | 0,8; sorgudaki hiçbir sözcüğü içermeyen ilk sonuç için 0,7; başka bir yazı sisteminden çevrilmiş sorgu için 0,6 |
misspelling | Arama, sorguyu düzeltmiştir (did_you_mean). | 0,5 × yazılan sorgunun düzeltmede korunan oranı |
partial | Sorgudaki bazı sözcükler başlıkta veya yalnızca metinde bulunur. | 0,2 + 0,5 × sorgu sözcüklerinin başlıkta bulunan oranı; yalnızca metinde bulunuyorsa 0,2 |
fulltext | Hiçbir başlık veya diğer ad eşleşmediği için maddelerin metinlerinde arama yapılmıştır (BM25): bir betimleme, adını bilmediğiniz maddeyi bulur. | en az 0,2 |
none | Hiçbir şey eşleşmemiştir. Yanıt boştur. | 0 |
Güven puanı, kalibre edilmiş bir olasılık değil, sabit bir kurala dayanır; en iyi sonucunun puanı 0,2'nin altında olan bir yanıt boş döner. Her sonuç, özetindeki sorgu sözcüklerini en çok içeren cümle olan highlight öğesini taşır. Hiçbir şey bulamayan bir arama, Latin harfleriyle bir kez daha denenir (Kiril, Yunan, kana ve Hangıl yazıları Latin harflerine çevrilir, pinyin ton numaraları kaldırılır, romajideki çift ünlüler kısaltılır); yanıtta bu sorgu searched_as olarak belirtilir. Çince karakterler Latin harflerine çevrilmez.
| Seçenek | İşlevi |
|---|---|
first=true | Yalnızca en iyi eşleşme veya hiçbiri. |
topic={id}, geo={id} | Yalnızca belirtilen konu veya coğrafya düğümünün altındaki maddeler; geo, en fazla 1.000 eşleşmenin tamamını süzer ve scope yanıtın ne kadarını kapsadığını belirtir. |
sort=central | En fazla 1.000 eşleşmenin tamamı arasında, en çok bağlantı verilen konular önce gelir. |
max_grade={grade} | Yalnızca belirtilen okuma sınıfı düzeyinde veya altında olan maddeler. |
facets=1 | En fazla 1.000 eşleşmenin tamamı üzerinden, en üst düzey konuya ve coğrafi bölgeye göre eşleşme sayıları (facets.counted). |
Her yanıt
fields=a,b, her sonuçta (veya sonuç içermiyorsa yanıtın kendisinde) yalnızca belirtilen anahtarları tutar; dış yapı (total, page, next, license) korunur. Önbelleğe alınabilen bir 200 yanıtı, bir ETag taşır: bunu If-None-Match olarak geri gönderdiğinizde, yanıt değişmemişse gövdesiz bir 304 döner. Last-Modified, derlem sürümünün yayımlanma tarihidir ve yalnızca bilgi amaçlıdır. Edgepedia-Corpus-Version derlem sürümünü belirtir; Content-Digest ise gövdenin SHA-256 değeridir (RFC 9530); bir maddenin .md yanıtı da ikisini birden taşır.
Diğer uç noktalar
| Uç nokta | Döndürdüğü |
|---|---|
/api/v1/articles?after={id}&limit={1..1000} | Sabit bir sırayla gezinilen tüm Genel maddeler: {id, slug, title, api_url} ve next (sonda null). after= boşsa baştan başlanır; kaldırılmış olsa bile herhangi bir kimliğin ardından gezinmeye devam edilebilir. |
/api/v1/trees, /api/v1/trees/topic, /api/v1/trees/geo | Konu ve coğrafya ağaçlarının tamamı: nodes: [[id, label, parent index, own articles]]; noktayla başlayan bir kimlik, üst düğümünün kimliğinin devamıdır. |
/api/v1/releases | En yenisi önce olmak üzere derlem sürümleri ve current. |
/api/v1/health | application/health+json: pass, warn veya fail (503). |
/api/v1/manifest | Madde başına bir satır içeren, gzip ile sıkıştırılmış tek bir JSONL dosyasına yönlendirme: { id, slug, title, updated, sha256, topic } (maddenin .md yanıtının sha256 değeri). Edgepedia'nın bir aynasını oluşturmak için dosyayı bir kez indirin. Sağlama toplamı, okur düzeltmelerinden önceki yayımlanmış metne aittir: sürüm yayımlandıktan sonra bir okurun bildirdiği düzeltmeyle değiştirilen madde, bir sonraki sürüme kadar bu değerle eşleşmez. |
/api/v1/changes?since={release} | Belirtilen sürümden güncel sürüme kadar olan değişiklik dosyaları, sırasıyla (akış 1.5'ten başlar: en eskisi since=1.5); her satır { op, id, … } biçimindedir; op, added, changed, moved (from_slug eski adrestir) veya removed değerlerinden biridir. |
/api/v1/events/{slug} | Bir maddenin tarih belirten cümleleri: { date, precision, text, para }, YYYY, YYYY-MM veya YYYY-MM-DD biçiminde date (milattan öncesi için negatif: -0044-03-15). MÖ tarihler astronomik yıl numaralandırmasını değil, tarihsel kullanımı izler: -0044, MÖ 44'tür (standart bir ISO 8601 ayrıştırıcısı bunu MÖ 45 olarak okur). Kanıt cümlenin kendisidir: tarihi bir olgu olarak kabul etmeden önce cümleyi okuyun. |
/api/v1/aliases/{id} | Maddelerde belirtilen kısaltmalar ("NASA") dahil, bir maddenin diğer adları; yanlış yazımlar ve büyük-küçük harf farkından doğan biçimler dahil edilmez; bir adın iki yazımından noktasız olanı korunur ("W.H.O." değil, "WHO"). |
Çözümleme, açıklama ekleme ve uzlaştırma
Serbest metin girer, madde kimlikleri çıkar; model de yok, gömme vektörleri de. Açıklama ekleme, sınıflandırma ve coğrafi ayrıştırma için gönderilen metinler hiçbir zaman günlüğe kaydedilmez veya saklanmaz.
| Uç nokta | Döndürdüğü |
|---|---|
/api/v1/resolve?name=Mercury&context=planet | Bir adın en olası karşılığı olan madde: result, confidence, ambiguous, match (exact, alias, anchor, partial veya none) ve alternatives. type= adayları tek bir konu kimliğinin altında tutar (adın ilk 30 eşleşmesinden hiçbiri orada değilse, tek bir ad için sonraki 60 eşleşme de taranır); limit= 1 ile 10 arasındadır. POST en fazla 50 tane alır: { "names": ["Paris", "Koala"] } veya { "queries": [{ "name": "Mercury", "context": "planet" }] }. Tek başına bir ad, tek bir maddeyi kesinleştirmiyorsa yanıt, en iyi tahmin result içinde olacak şekilde ambiguous: true döner; seçim yapmak için context iletin. |
/api/v1/surface?form=mercury | Derlemin kendi bağlantılarında bu ifadenin tam olarak karşılık geldiği tüm maddeler; bağlantı sayıları ve her birinin payıyla birlikte (commonness). |
/api/v1/suggest?prefix=koa | Önce başlığı tam olarak bu olan madde, ardından diğer adlarından biri bununla tam eşleşen madde, sonra başlıkları bu önekle başlayanlar, ardından diğer adları bu önekle başlayanlar (matched o adı verir); arama kutuları ve sesli arayüzler için. |
POST /api/v1/annotate | { "text": "…" } (en fazla 20.000 karakter): bağlantı verilen her ifade; konumları (start, end, JavaScript'in dizeleri indekslediği biçimde UTF-16 kod birimleriyle: Python'da, emoji gibi Temel Çok Dilli Düzlem dışındaki bir karakter iki birim sayılır), maddesi ve güven puanıyla birlikte. ?format=html ayrıca metni, HTML için kaçış uygulanmış ve her ifade bağlantıya dönüştürülmüş olarak döndürür. |
POST /api/v1/classify | { "text": "…" }: metnin sözünü ettiği maddelerin konu yollarına göre puanlanan konuları ve en üst düzey konu payları. |
POST /api/v1/geoparse | { "text": "…" }: metinde adı geçen yerler ve dönemler, coğrafya ağacı üzerinde (nodes, regions, places, periods); ağacın coğrafi olmayan dalı (geo.nongeo) hiçbir zaman bir yer sayılmaz. |
/api/v1/mentions?term=CRISPR | Bir konudan söz ettiği hâlde onun maddesine bağlantı vermeyen maddeler; complete: false, bağlantı veren maddeler listesinin kesildiği anlamına gelir. |
/api/v1/reconcile | Bir Reconciliation Service API 0.2 uç noktası: bildirim dosyası, toplu queries (GET veya POST), varlık, tür ve özellik önerileri, önizleme ve veri genişletme (title, url, excerpt, topic, topic_path, importance_rank). callback= ile JSONP. OpenRefine'da: Reconcile › Start reconciling › Add standard service yolunu izleyip https://www.edgepedia.org/api/v1/reconcile değerini yapıştırın. |
Bağlantı grafiği, tarihler ve listeler
Diyagramlar (format=mermaid), bunları görselleştiren bir ortam için Mermaid metni biçimindedir.
| Uç nokta | Döndürdüğü |
|---|---|
/api/v1/links/{slug} | Maddenin diğer maddelere verdiği bağlantılar; okuma sırasıyla, her birinin bağlantı metni ve cümlesiyle birlikte. |
/api/v1/backlinks/{slug}?page= | Maddeye bağlantı veren maddeler; sayfa başına 30 tane, en önemlileri önce, bağlantı metinleriyle birlikte. |
/api/v1/path?from=&to= | İki madde arasındaki en kısa bağlantı zinciri (en fazla 6 adım; mümkün olduğunda bağlantı merkezlerinden kaçınarak), her adımı sağlayan cümleyle birlikte. MCP sunucusu bunu connect olarak adlandırır. |
/api/v1/compare?a=&b= | Yan yana iki madde: girişleri, konu yolları, paylaştıkları en alt düzey konu, aralarındaki zincir, ortak ve kendilerine özgü bağlantılar ve her birinin Temel bilgiler tablosu. |
/api/v1/graph/{slug}?depth=1|2&limit= | En önemli komşularından en fazla limit tanesi (varsayılan 50, en fazla 200) ve bunların arasındaki tüm bağlantılar. complete: false (burada, geri bağlantılarda ve rank/top üzerinde), uç noktanın yaklaşık bir saniyelik süre sınırı nedeniyle yanıtın kesildiği anlamına gelir; böyle bir yanıt yalnızca bir dakika önbellekte tutulur. |
POST /api/v1/context | { "ids": [...] }, en fazla 50 kimlik veya adres (/rank?ids= ve /leads?ids= de bunları kabul eder): aralarındaki bağlantılar, çoğunun bağlantı verdiği maddeler, paylaştıkları en alt düzey konu ve yer ve her birinin girişi. |
/api/v1/rank?ids=, /api/v1/rank/top?topic=&limit= | PageRank'e göre önem: derlem genelinde pr toplamı 1'dir; 1. sıra en merkezî olandır. Adlara dikkat edin: /search ve maddelerdeki importance, bu sıranın 0 ile 1 arasında yüzdelik dilim olarak ifadesidir; /resolve içindeki importance ham pr değeridir, /leads içindeki ise { pr, rank } değeridir. |
/api/v1/timeline?topic=|geo=&from=&to= | Bir konunun veya yerin maddelerinden tarih içeren cümleler; en eskisi önce, sayfa başına 50 tane; MÖ yıllar negatiftir. Bir düğüm, tarihlerine yayılmış en fazla 200 olay tutar; from ve to bu örneklemi süzer. Üst sınıra ulaşmış bir örneklemden alınan yanıt, sampled: true ve örneklemin cap değerini belirtir; total de örneklemdeki sayıyı verir. |
/api/v1/onthisday?date=MM-DD, /api/v1/year/{year} | Yılın bir günündeki (varsayılan olarak UTC'ye göre bugün) veya belirli bir yıldaki (-9999 ile 2100 arası) olaylar. Bir gün en fazla 500, bir yıl 2.000 olay tutar; üst sınıra ulaşılmışsa sampled: true belirtilir. |
/api/v1/featured?date=, /api/v1/featured.xml | Günün öne çıkan maddesi (açılış sayfasındaki Günün bilgisi) ve son on günün Atom akışı. |
/api/v1/list?topic=|geo=&period=&type=person | Bir konunun veya bir yer ve dönemin (TBC, T500, T1000, T1800, T1946, T2001, T2021, NODATE) maddeleri, sayfa başına 30 tane; type=person yalnızca kişileri tutar. Bir coğrafya listesinin satırları geo taşır, id taşımaz (bunun için maddeyi getirin). |
/api/v1/keyterms?topic=|geo=&limit= | Bir konuşma tanıyıcıyı hazırlamak için, bir alt ağacın başlıkları ve diğer adları. |
/api/v1/stats?topic=|geo=&by=period | Yalnızca sayılar: derlem veya bir düğüm ve alt düğümleri için madde, bağlantı ve diğer ad sayıları. Burada articles farklı maddeleri sayar; /geo ve /trees/geo üzerinde ise yerleşimleri sayar; dolayısıyla bir bölgenin iki döneminde bulunan bir madde oralarda iki kez sayılır. |
Keşif ve diğer protokoller
- MCP sunucu kartı: /.well-known/mcp/server-card.json (ayrıca
/mcp/server-card): bağlantı kurmadan ad, uç nokta, araçlar ve sürümler. Kayıt dizini yapılandırması:/.well-known/mcp/config-schema.jsonve/.well-known/mcp/examples.json. - Yapay zekâ kataloğu: /.well-known/ai-catalog.json: örnek sorgularla birlikte tüm erişim yolları (MCP, bu API, A2A, NLWeb ve Ajan Becerisi).
- API kataloğu: /.well-known/api-catalog; bu API'yi, tanımını ve bu belgeleri belirten bir RFC 9727 bağlantı kümesi.
- Ajan Becerisi: /.well-known/agent-skills/index.json,
SKILL.mdöğesini sha256 özet değeriyle birlikte listeler. - OpenSearch: /opensearch.xml, Edgepedia'yı arama sağlayıcısı olarak ekler.
- A2A:
https://www.edgepedia.org/a2a(JSON-RPC; A2A 1.0SendMessageve 0.3message/send; kartı/.well-known/agent-card.jsonadresindedir). Bir konunun adı en iyi beş maddeyi döndürür; bir maddenin adresi ise maddeyi kaynak satırıyla birlikte Markdown biçiminde döndürür. Yanıt her zaman bir mesajdır, hiçbir zaman görev değildir; aynı yöntemler/mcpüzerinde de yanıtlanır. - NLWeb:
https://www.edgepedia.org/ask?query=Mount%20Fuji(GET veya JSON ya da form gövdeli POST), her sonuç için bir schema.orgschema_objectöğesiyle, NLWeb'in liste yapısında yanıt verir;streaming=true, listeyi sunucu tarafından gönderilen olaylar olarak iletir. Hiçbir model çağrılmaz. - Bir maddenin makine tarafından okunabilir biçimleri: maddenin adresi,
Acceptbaşlığında belirtilen biçimi döndürür:text/markdown(birx-markdown-tokenstahminiyle birlikte),application/json(bu API'nin yanıtı) veyaapplication/ld+json; başka bir değer için sayfa döner. Madde sayfaları, bu biçimleri, lisansı, API kataloğunu ve OpenAPI tanımını belirten birLinkbaşlığı taşır.
Oluşturulan dosyalar
/openapi.json temel alınarak oluşturulurlar; dolayısıyla ondan hiçbir zaman sapmazlar.
| Dosya | Açıklama |
|---|---|
| /openapi-3.0.json | 3.1'i okuyamayan araçlar için aynı tanımın OpenAPI 3.0.3 biçimi. |
| /arazzo.json | Bir Arazzo 1.0 iş akışı: ara, en iyi eşleşmeyi getir, ardından onunla ilişkili maddeleri getir. |
| /tools.json | Her JSON uç noktası; OpenAI, Anthropic ve Gemini biçimlerinde, bir modelin çağırabileceği bir işlev olarak ve uç noktasıyla birlikte JSON Schema biçiminde. |
| /edgepedia.d.ts | Her yanıt ve her uç noktanın parametreleri için TypeScript türleri. |
| /edgepedia.postman_collection.json, /edgepedia.bruno.json, /edgepedia.insomnia.json, /edgepedia.http | Postman, Bruno, Insomnia ve VS Code veya JetBrains için uç nokta başına bir örnek istek. |
Lütfen koleksiyonlarda olduğu gibi programınızın adını belirten bir User-Agent gönderin (edgepedia-collection/1).