DOKÜMAN

REST API

/v1 kontratı OpenAPI olarak yayınlanır ve capability kaydından üretilir.

KİM İÇİN

İşletme bilgisini API, MCP, A2A ve mevcut sistemlerle güvenli biçimde açmak isteyen ürün ekipleri

İŞ SONUCU

Tek canonical capability kaydından tutarlı makine kontratları ve kontrollü iş akışları üretin.

KARAR GÜVENİ

Scope, rol, entitlement ve yazma yetkisi istemcide değil sunucu tarafında uygulanır.

Kontrat

Makine tarafından okunabilir kontrat /v1/openapi.json adresindedir. Üretildiği için belgelenen yüzey ile çağrılabilir yüzey birbirinden ayrışamaz.

Yollar /v1 önekiyle gelir. Kırıcı bir değişiklik, mevcut route'un sessizce değişmesi yerine yeni sürüm olarak yayınlanır.

Yazma endpointleri idempotency-key başlığı kabul eder. Aynı key'i aynı payload ile tekrarlamak işi çoğaltmak yerine ilk sonucu döner.

Hatalar; sabit bir kod, başlık, detay ve korelasyon kimliği taşıyan problem dokümanı olarak döner. Stack trace asla dönmez.