Yönetici Özeti
IETF RFC 9727, web kökenlerinin aktif API'lerini otonom ajanlara nasıl duyuracağını standartlaştırır. /.well-known/api-catalog adresindeki RFC 9264 JSON Linkset formatı ile ajanlar OpenAPI özelliklerini, dokümantasyonu ve sağlık uç noktalarını otomatik olarak keşfeder.
1. RFC 9727 Bağlantı Kümelerini Anlama
Geleneksel web API'leri insan odaklı geliştirici portallarına dayanır. RFC 9727, /.well-known/api-catalog adresinde application/linkset+json sunarak yetkili bir makine yüzeyi oluşturur.
Temel Bağlantı İlişkileri (Link Relations):
service-desc: OpenAPI / Swagger JSON şemasına doğrudan URI.service-doc: İnsan veya ajan tarafından okunabilir dokümantasyon uç noktası.status: Otomatik yeniden deneme ve hata devri için canlı sağlık durumu uç noktası.
/.well-known/api-catalog
{
"linkset": [
{
"anchor": "https://tinycto.tv/api/episodes",
"service-desc": [
{
"href": "https://tinycto.tv/api/openapi.json",
"type": "application/openapi+json"
}
],
"service-doc": [
{
"href": "https://tinycto.tv/docs/api",
"type": "text/html"
}
],
"status": [
{
"href": "https://tinycto.tv/api/health",
"type": "application/json"
}
]
}
]
}