Marketplace

Bir uygulamayı marketplace’e yayınlamak, diğer Kazzle alanlarının onu keşfetmesini ve yüklemesini sağlar.

Yayınlama ne yapar

Yayınlama, uygulamayı diğer alanlar tarafından yüklenebilir hale getirir. Kullanıcılar uygulamanın adını, alt başlığını, simgesini, yayıncısını ve görünürlüğünü görür, ardından kendi alanlarına yüklerler. Yayınlama, kazzle.config.ts dosyasında bir subtitle gerektirir — uygulama adının altında tek satırlık bir slogan. Yayınlanan sürüm, main üzerindeki en son commit’i kullanır. Yayınlanan uygulamalar için ayrı bir release branch’i yoktur. Varsayılan olarak, yayınlanan bir uygulamaya tıklamak, dağıtılan UI’sini açar. Uygulamalar isteğe bağlı olarak özel bir başlatma URL’si ayarlayabilir, açılmadan önce Kazzle kimliği gerektirebilir veya yükleme ve kaldırma webhook’ları alabilir. Bir uygulamayı yayınlamak için Uygulamanızı yayınlayın bölümüne bakın.

Yüklemeler

Birisi yayınlanan bir uygulamayı yüklediğinde, Kazzle kendi alanlarında bir yükleme kaydı oluşturur. Yükleyen alan, yüklemeyi ve onunla ilişkili tüm verileri sahiplenmiştir.

Kullanıcı kimliği

Oturum açmış bir Kazzle kullanıcısı yüklü bir uygulamayı açtığında, Kazzle uygulamaya geçerli kullanıcı hakkında bilgi sağlar. Kazzle, bir taşıyıcı token olarak kısa ömürlü bir JWT ekler. Uygulama, token’ı Kazzle’nin genel JWKS’sine karşı doğrulayarak kullanıcı, alan ve yükleme bilgilerini okuyabilir. Token şu talepleri içerir:

Talep	Anlamı
`aud`	`kazzle:app`
`iss`	`https://api.kazzle.app`
`sub`	Kazzle kullanıcı kimliği
`user`	Kullanıcının `{ id, email }` bilgisi
`space`	Uygulamanın yüklendiği alanın kimliği
`install`	Bu belirli yüklemenin kimliği

Doğrulama örneği:

import { jwtVerify, createRemoteJWKSet } from 'jose';

const JWKS = createRemoteJWKSet(new URL('https://api.kazzle.app/auth/.well-known/jwks.json'));

async function getUserFromToken(token: string) {
  const { payload } = await jwtVerify(token, JWKS, {
    audience: 'kazzle:app',
    issuer: 'https://api.kazzle.app',
  });
  return payload;
}

Uygulama manifestindeki iki alan, yayınlanan uygulamalar için başlatma davranışını kontrol eder:

kazzleAuth: required yalnızca oturum açmış Kazzle kullanıcılarının uygulamayı açabileceği anlamına gelir; optional uygulamanın Kazzle kimliği olmadan açılmasına izin verir.
launchUrl: bir kullanıcı uygulamaya tıkladığında açılan giriş noktasını geçersiz kılar.

Webhook’lar

Manifest bir webhookUrl içeriyorsa, Kazzle uygulama yüklendiğinde veya kaldırıldığında buna HTTP POST istekleri gönderir. app.installed yayıncının arka ucunun yükleme başına API’ye kimlik doğrulaması yapmak için kullanabileceği yükleme anahtarını içerir:

{
  "event": "app.installed",
  "installId": "...",
  "appId": "...",
  "spaceId": "...",
  "apiUrl": "https://api.kazzle.app",
  "installKey": "kzl_inst_...",
  "user": { "id": "...", "email": "..." }
}

app.uninstalled olayı, yükleme kimliğini, uygulama kimliğini, alan kimliğini ve API URL’sini içerir. Yayıncı bu olayı aldıktan sonra yükleme anahtarını kullanmayı durdurmalıdır.

Yükleme başına API

Her yükleme, https://api.kazzle.app üzerinde kapsamlı bir API’yi çağırabilir. Çağrılar, yükleme anahtarı (yayıncının arka ucundan) veya kullanıcı kimliği token’ı (barındırılan UI’den) ile kimlik doğrulaması yapılır. Tüm işlemler otomatik olarak bu yüklemeye kapsamlandırılır. Kullanılabilir uç noktalar: Tam istek ve yanıt şemaları, Kazzle OpenAPI spec’inde https://api.kazzle.app/openapi.json adresinde bu yollar altında yayınlanmıştır.

Yöntem	Yol	Açıklama
GET	`/apps/secrets`	Yükleme için depolanan gizli adlarını listele
GET	`/apps/secrets/:name`	Gizli değeri oku
PUT	`/apps/secrets/:name`	Gizli değeri depola
DELETE	`/apps/secrets/:name`	Gizli sil
GET	`/apps/metadata`	Yükleme için gizli olmayan metaveriyi oku
PUT	`/apps/metadata`	Yüklemenin metaverisine güncellemeleri birleştir

Bu API aracılığıyla yazılan gizliler, beklemede şifrelenir ve belirli yüklemeye izole edilir. Bunlar, bir alanın vault’unda depolanan gizlilerden ayrıdır.

Sonraki adımlar

Uygulamanızı yayınlayın — bir uygulamayı yayınlamak ve sonrasında ne olacağı.
Yapılandırma — tam manifest referansı, kazzleAuth, launchUrl ve webhookUrl dahil.

Başlarken

Oluşturma

Kullanıcılar ve veriler

Yayınlama

Kazzle kullanımı

Güvenlik

Referans

Marketplace

Marketplace

Yayınlama ne yapar

Yüklemeler

Kullanıcı kimliği

Webhook’lar

Yükleme başına API

Sonraki adımlar

​Marketplace

​Yayınlama ne yapar

​Yüklemeler

​Kullanıcı kimliği

​Webhook’lar

​Yükleme başına API

​Sonraki adımlar

Marketplace

Yayınlama ne yapar

Yüklemeler

Kullanıcı kimliği

Webhook’lar

Yükleme başına API

Sonraki adımlar