API
ARAYA Public APIは、プロジェクト、アップロード、字幕シーン、レンダリング、credits、Webhook、APIキーを扱うREST APIです。
OpenAPI仕様はapps/web/openapi/v1.yamlを単一の入力として管理し、このVitePressサイトのAPI Referenceをビルド時に生成します。
Webhook の署名と鍵更新
受信時は生の HTTP body を保持し、X-Araya-Signature をカンマで区切って すべての v1 値を配列として保持してください。通常は t=<unix>,v1=<hex>、鍵更新後24時間は t=<unix>,v1=<new>,v1=<previous> です。単一値の map に変換すると旧署名だけが残り、新鍵での検証が失敗します。
TLS を使い、署名内の t と X-Araya-Timestamp の一致・現在時刻から5分以内を確認します。受信側の鍵で HMAC-SHA256("<timestamp>.<raw body>", key) を計算し、全 v1 候補と定数時間で比較して、1つでも一致すれば受理します。24時間後は旧鍵の署名がなくなります。
鍵は登録/更新直後の一回だけ返ります。Idempotency-Key の replay からは取得できません。紛失時は対象を DELETE /v1/webhooks/{webhook_uuid} で無効化して POST /v1/webhooks で新規登録し、新しい鍵を受信側へ設定してください。無効化した対象の配信は停止します。猶予期間中と無効化済みの対象の更新は422 webhook_rotation_unavailable です。