マーケットプレイス
アプリをマーケットプレイスに公開すると、他の Kazzle スペースで発見してインストールできるようになります。公開の効果
公開することで、アプリが他のスペースからインストール可能になります。ユーザーはアプリの名前、サブタイトル、アイコン、パブリッシャー、公開設定を確認してから、自分のスペースにインストールします。公開にはkazzle.config.ts に subtitle が必須です。これはアプリ名の下に表示される 1 行のタグラインです。
公開されたバージョンは main ブランチの最新コミットを使用します。公開アプリ用の別のリリースブランチはありません。
アプリ定義は、インストール済みアプリをクリックしたときにコンポーネントを開くか、埋め込み URL または外部 URL を開くか、起動画面を持たないかを明示的に選択します。アプリは Kazzle の認証を開く前に要求したり、ライフサイクル Webhook を受け取ったりすることもできます。
アプリの公開方法については、アプリを公開するを参照してください。
インストール
ユーザーが公開されたアプリをインストールすると、Kazzle はそのスペース内にインストールレコードを作成します。インストールを行ったスペースがインストールとそれに関連するすべてのデータを所有します。ユーザー認証
ログイン済みの Kazzle ユーザーがインストール済みアプリを開くと、Kazzle はそのアプリに現在のユーザーに関する情報を提供します。 Kazzle は短命の JWT をベアラートークンとして添付します。アプリは Kazzle の公開 JWKS に対してトークンを検証し、ユーザー、スペース、インストール情報を読み取ることができます。 トークンには以下のクレームが含まれます：
検証例：
launch：none、名前付きアプリコンポーネント、または明示的な埋め込みまたは外部ターゲットを持つ URL を選択します。kazzleAuth：requiredはログイン済みの Kazzle ユーザーのみがアプリを開くことができることを意味し、optionalは Kazzle 認証なしでアプリを開くことを許可します。
Webhook
アプリ定義にwebhookUrl が含まれている場合、Kazzle はアプリがインストールまたはアンインストールされたときに HTTP POST リクエストを送信します。
app.installed にはパブリッシャーのバックエンドがインストール単位の API に認証するために使用できるインストールキーが含まれます：
app.uninstalled にはイベント、インストール ID、アプリ ID、スペース ID、API URL が含まれます。パブリッシャーはこのイベントを受け取った後、インストールキーの使用を停止する必要があります。
インストール単位の API
各インストールはhttps://api.kazzle.app 上のスコープ付き API を呼び出すことができます。呼び出しはインストールキー（パブリッシャーのバックエンドから）またはユーザー認証トークン（ホストされた UI から）で認証されます。すべての操作は自動的にそのインストールにスコープされます。
利用可能なエンドポイント：
完全なリクエストとレスポンススキーマは、Kazzle OpenAPI スペック（https://api.kazzle.app/openapi.json）の以下のパスで公開されています。
この API を通じて書き込まれたシークレットは保存時に暗号化され、特定のインストールに分離されます。これらはスペースのボルトに保存されたシークレットとは別です。
次のステップ
- アプリを公開する — アプリを公開する方法とその後の流れ。