API

Bu site bir kamu REST API’si sunmaz. Aşağıdaki uçlar, ajanların ve tarayıcıların kaynakları RFC 9727 API kataloğu üzerinden keşfetmesi içindir. Kimlik doğrulama gerekmez; Authorization başlığı göndermeyin.

Kimlik doğrulama

Yayımlanan tüm uçlar herkese açıktır ve salt okunurdur. API anahtarı, OAuth jetonu veya çerez gerekmez. Ayrıntı: /auth.md.

Uçlar

• /.well-known/ai-catalog.json— ARD / AI Catalog yetenek listesi (MCP kartı, OpenAPI, ajan becerileri)
• /.well-known/api-catalog— API kataloğu (application/linkset+json)
• /openapi.json— makine okunur OpenAPI 3.1 açıklaması
• /api/status.json— sağlık durumu
• /llms.txt— ajanlar için seçilmiş site rehberi
• /sitemap-index.xml— genel sayfa haritası
• /.well-known/agent-skills/index.json— Agent Skills keşif dizini (RFC v0.2.0)
• /.well-known/mcp/server-card.json— MCP Server Card (SEP-1649). Bu sitede MCP sunucusu yoktur; /mcp JSON-RPC hata döner.
• /auth.md— ajan kaydı talimatları (Auth.md). Bu sitede ajan kaydı yoktur; uçlar kimlik bilgisi üretmez.
• /.well-known/oauth-protected-resource— OAuth 2.0 korumalı kaynak metadata’sı (RFC 9728). Bu sitede korumalı API yoktur; erişim jetonu gerekmez.
• /.well-known/oauth-authorization-server— OAuth 2.0 keşif belgesi (RFC 8414) ve agent_auth bloğu. Bu sitede korumalı API yoktur; uçlar token üretmez.
• /.well-known/openid-configuration— OpenID Connect Discovery belgesi (aynı politika)

Örnek istekler

curl -s https://fiorlaw.com/api/status.json
curl -sI https://fiorlaw.com/api/status.json | grep -i ratelimit
curl -s https://fiorlaw.com/openapi.json
curl -s -H "Accept: text/markdown" https://fiorlaw.com/

Hız sınırı

/api/ uçları istemci IP başına 60 saniyede 120 istek kabul eder. Yanıtlar IETF RateLimit-Policy ve RateLimit alanlarını (q kota, w pencere, r kalan, t sıfırlamaya saniye) ve uyumluluk için RateLimit-Limit, RateLimit-Remaining,RateLimit-Reset başlıklarını taşır. Kota bitince429 ve Retry-After döner; ajanlar bu süre kadar beklemelidir.

JSON hataları

Tanımsız /api/ yolları ve JSON tercih eden 404/405 yanıtlarıRFC 9457application/problem+json döner: type, title,status, detail, code, resolution.

curl -s -D - -o - https://fiorlaw.com/api/does-not-exist
curl -s -H "Accept: application/problem+json" https://fiorlaw.com/no-such-page

• 404 api_route_not_found — Tanımsız bir /api/ yolu. OpenAPI veya API kataloğundan keşfedin.
• 404 page_not_found — HTML sayfası yok. /llms.txt, sitemap veya bu belgeye bakın.
• 405 method_not_allowed — Yalnızca GET ve HEAD. POST/PUT/PATCH/DELETE kabul edilmez.
• 429 rate_limit_exceeded — Kota doldu. Retry-After kadar bekleyip yeniden deneyin.

Var olmayan HTML yolları gerçek HTTP 404 döner. Accept: text/markdownile kısa bir kurtarma metni (sitemap, llms.txt, bu belge) gelir.

Tarayıcıdaki ajanlar WebMCP araçlarını sayfa yüklenince alır (navigator.modelContext.provideContext() /registerTool()): sayfa gezintisi, çalışma alanları, yayınlar, ekip, iletişim.

HTML varsayılandır. Ajanlar Accept: text/markdown ile sayfaların Markdown karşılığını isteyebilir.