Octri: API dokümantasyonu oluşturma, SDK ve MCP

Octri, API dokümantasyonu oluşturma sürecini SDK üretimi, MCP erişimi ve izlemeyle birleştirir. API sağlayan ekiplerin geliştiricilere sunduğu sayfa ve paketler aynı tanımı temel alır.

Octri ne işe yarar? Basit bir açıklama

API tanımı, bir servise hangi isteğin gönderileceğini ve hangi yanıtın alınacağını anlatır. Octri bu tanımı insanların okuyacağı bir siteye, uygulamaların kullanacağı istemci kütüphanelerine ve yapay zekâ asistanlarının erişebileceği araçlara dönüştürür.

SaaS ekipleri, API sağlayıcıları ve farklı dillerde entegrasyon sunan geliştiriciler için uygundur. Çalışan API'nin kendisini oluşturmak ve üretilen açıklamaları doğrulamak ekibin sorumluluğundadır. Dört modül ayrı ayrı kullanılabilir.

İlk dokümantasyonu hazırlama ve doğrulama

API Studio uç noktaları, parametreleri, iç içe şemaları ve örnek istekleri düzenler. Üretilen sayfa doğrudan değiştirilebilir. Kimlik doğrulama veya birkaç çağrı gerektiren bir işlem için ekibin yazdığı MDX kılavuzları eklenebilir.

1. Tanım dosyasını yükleyin veya GitHub deposunu bağlayın.
2. İşlem adlarını, kimlik doğrulamayı ve istek/yanıt modellerini kontrol edin.
3. Sayfaları üretip açıklamaları gerçek API davranışıyla karşılaştırın.
4. Test ortamında başarılı bir çağrıyı ve hata durumunu deneyin.
5. Yayınlama ve gerekiyorsa SDK ayarlarını tamamlayıp taslağı ve farkları inceleyerek onaylayın.

Deneme konsolu isteği okuyucunun tarayıcısından gönderir; API'nizin CORS kuralları bu yüzden önemlidir. GitHub değişikliği yeniden oluşturmayı başlatabilir, ancak yeni SDK sürümlerinin paket kayıtlarına yayınlanması onay aşamasından geçer.

Yeniden üretim sırasında elle düzenlenen açıklama alanları da korunur.

Farklı diller için istemci kütüphaneleri

SDK Studio TypeScript, Python, Go, Java, Kotlin, Ruby, PHP, Rust, Swift ve Dart destekler. Metot adları, dışarıda bırakılan uç noktalar ve dile özgü seçenekler yapılandırılabilir.

On dil, platformun toplam desteğidir; aynı anda kullanılabilecek dil sayısını plan belirler. Özel SDK kodu Growth ve üstündedir. Üretilen istemciyi dağıtmadan önce kimlik doğrulama ve API'nize özgü yanıtları test edin.

MCP ile okuma ve işlem yapma yetkisini ayırın

MCP sunucusu yedi dokümantasyon aracı sunar ve seçilen uç noktaları çalıştırılabilir araçlara dönüştürebilir. Claude veya Cursor gibi istemciler yayınlanmış API bilgilerine erişebilir.

Dokümantasyonu okumak için proje kimliği yeterlidir. Gerçek API çağrıları uygun kimlik bilgilerini gerektirir; bu bilgiler sunucunun çalıştığı makinede kalır. Hedef ortamı, yetki kapsamını ve dışlanan uç noktaları açıkça seçin.

İzleme ve verilerin işlendiği yer

İzleme varsayılan olarak kapalıdır. Etkinleştirildiğinde oluşturulan SDK'lar ve backend paketleri günlük, gruplanmış hata ve iz verileri gönderebilir. Erişilebilirlik kontrolleri ve uyarılar da bulunur. Octri hassas bilgilerin istemcide ve alım sırasında maskelendiğini açıklar.

Gizlilik politikası, metin üretimi için ilgili API tanımının model sağlayıcısına gönderildiğini belirtir. Soru-cevap için soru ve ilgili bölümler, arama için dokümantasyon metni işlenir. Şirket bu içeriklerin model eğitiminde kullanılmadığını söyler; bu, tüm işlemenin yerel olduğu anlamına gelmez.

Ücretsiz plan ve ücretli seçenekler

6 Ekim 2026 tarihinde doğrulanan aylık ABD doları fiyatlarıdır; ücretli planlara vergi dahil değildir ve bunlar Türk lirası fiyatları değildir.

• Free: bir proje, bir SDK dili, 50 uç nokta, ayda 100 MB izleme ve tek seferlik 100 yapay zekâ kredisi.
• Starter: ayda 49 USD, iki dil.
• Growth: ayda 99 USD, dört dil, sürümleme ve özel kod/bileşenler.
• Business: ayda 249 USD, on dil ve white-label.
• Enterprise: özel teklif; üretici ve dokümantasyon görüntüleme bileşeni kendi altyapınızda çalışabilir.

Bir uç noktanın açıklamasını üretmek veya Ask-the-docs yanıtı almak bir kredi tüketir. Elle düzenleme, SDK derleme ve barındırma bu kredi sisteminin dışındadır. Ayrıntılar için resmî plan karşılaştırmasını inceleyin.

Sık sorulan sorular

Hangi tanım biçimleri destekleniyor?

OpenAPI 3.0/3.1, Swagger 2.0, Postman ve AsyncAPI; JSON veya YAML biçiminde desteklenir.

Ücretsiz planda özel alan adı var mı?

Evet, özel alan adı ve GitHub eşitlemesi dahildir.

Yapay zekâ kredisi biterse ne olur?

Yapay zekâ üretimi ve Ask-the-docs yanıtları durur. Yayınlanmış dokümantasyon, SDK derleme ve izleme devam eder. Ücretsiz 100 kredi her ay yenilenmez.

Resmî kaynaklar

• Octri dokümantasyonu: kurulum ve SDK kılavuzları.
• Octri GitHub: açık paketler ve SDK sorunları.
• Ürün ve faturalandırma desteği: yardım kanalları ve sorun giderme.