キー/値ストレージ API

昇順のキー順で最大200件返します。next_cursorは最後に返されたキーで、次ページ取得時にafterとして渡します。エントリーがない場合next_cursorはnullです。ダッシュボードセッションは、ウェブアプリのプレビューのため、ここでプロジェクトのエントリーを読み取ります。ダッシュボードには KV 書き込みがありません。

アプリケーションの受信キー/バリューWebhookを最も古いものから最大20件リストします。各Webhookは書き込むキー、取り込みURL、書き込み済みのlast_used_atを含みます。シークレットはここでは決して返されません。

受信キー/バリューWebhookを作成します：このアプリケーションの1つのキーに書き込む1つのURLで、外部システム（Zapier、Make、POS、cronジョブ、curl）が1つのHTTP POSTでスクリーンにデータをプッシュします。詳細はPOST /api/applications/{application_id}/kv-webhooks/{webhook_id}/write.を参照してください。キーはまだ存在していなくてもかまいません。

回答はシークレットが表示される唯一の場所です（回転回答と共に）：送信システムにすぐに保存してください。サーバーはダイジェストを保持します。アプリケーションは最大20の webhook を持てます（kv_webhook_limit_reached）。kv_webhook.created を追加します。同じ Idempotency-Key での正確な再試行は24時間この同じ回答（シークレット含む）を返します。

Webhook を削除します。URLは即座に無効になりますが、書き込んだキーは値を保持します。kv_webhook.deleted を追加します。

Webhookのシークレットを置き換え、一度だけ新しいものを返します。古いシークレットは即座に無効になります。送信システムを更新してください。kv_webhook.secret_rotatedを追加します。同じIdempotency-Keyでの正確な再試行は24時間この回答（シークレット含む）を返します。

外部システムが1つのキーの新しい値を投稿するURLです。AuthorizationヘッダーでWebhook固有のシークレットを使って認証します：Bearer <secret>、またはWebhook IDをユーザー名、シークレットをパスワードとするHTTP Basic認証です。URLやクエリ内のシークレットは受け付けません。

不明なWebhook、別のアプリケーションのWebhook、誤ったシークレットはすべて同じ401を返します。最大1MiBの生の本文はWebhookのキーの値となり、Content-Typeヘッダーはcontent_typeになります（ヘッダーがない場合はapplication/octet-stream。1つのメディアタイプでないヘッダーはinvalid_requestです）。

書き込みは If-Match なしの PUT /api/applications/{application_id}/kv/{key} です。値を置き換え、リビジョンを増やし、他の K/V 書き込みと同様に計測とクォータチェックを受け、残高を理由に拒否されることのない課金対象の API リクエスト 1 回として扱われ、kv.updated を追加します。

Idempotency-Key（8〜200文字）は、送信元による1回の書き込みの再試行を24時間重複排除します。同じキーで本文やコンテンツタイプが異なる場合は idempotency_mismatch です。キーがない場合、すべての送信が新しい書き込みになります。応答はキーの新しいメタデータであり、値は返されません。

Webhook あたり毎分最大120回の書き込みです。各書き込みは、組織とキーの書き込みレートにも計上されます（PUT /api/card-data/{key}）。