REST API

MCP sunucusunun ve CLI'ın üzerine inşa edildiği HTTP API'si. Willet'i HTTP konuşan her şeyle entegre etmek için kullanın.

Etkileşimli referans

Eksiksiz ve her zaman güncel olan endpoint referansı, gösterge panelinizden erişebileceğiniz etkileşimli API gezginidir. OpenAPI spec'i tüm endpoint'ler, parametreler ve yanıt şemalarıyla birlikte görüntüler; kısa süreli bir token kullanarak hesabınıza karşı canlı istekler çalıştırmanıza da olanak tanır.

API gezginini aç

Temel URL

Willet Cloud'da her endpoint şunun altında yer alır: https://willet.bgenc.dev/api/v1. Kendi sunucunuzda barındırılan sunucular aynı API'yi şunun altında sunar: <your-server>/api/v1.

Ham OpenAPI 3.1 spec şu adreste sunulmaktadır: /api/v1/openapi.json kendi araçlarınıza içe aktarmak veya bir istemci oluşturmak isterseniz.

Kimlik Doğrulama

Her istekte taşıyıcı token olarak bir API gizli anahtarı gönderin: Authorization: Bearer <secret>.

curl -H "Authorization: Bearer $WILLET_API_TOKEN" \
  https://willet.bgenc.dev/api/v1/me

Willet Cloud'da, Gösterge Paneli'nde Ayarlar → API gizli anahtarları bölümünden bir gizli anahtar oluşturun. Her gizli anahtarın bir kapsamı ve erişim düzeyi vardır:

user / project tüm projelerinizi ya da yalnızca birini seçer.
read / read_write salt okunur ya da tam okuma/yazma erişimini seçer.

Hatalar

Hatalar, 2xx dışı bir durum kodu ve JSON gövdesi döndürür: { "error": "message", "details": [...] }.

`400`	İstek doğrulaması başarısız oldu.
`401`	Eksik, geçersiz, iptal edilmiş veya süresi dolmuş gizli anahtar.
`403`	Gizli anahtarın izni yok; örneğin, yalnızca okuma amaçlı veya projeye özgü bir gizli anahtar izin verilmeyen bir yerde kullanılmış.
`404`	Kaynak mevcut değil.
`501`	Yalnızca Cloud'a özel bir endpoint, self-hosted sunucuda çağrılmış.

İleri

Terminali tercih mi ediyorsun? CLI, tüm bu uç noktaları oturum açma, JSON çıktısı ve çıkış kodlarıyla birlikte sunar.

CLI referansı →