Page Batch 作成

POST /api/v1/organizations/{organization_id}/projects/{project_id}/page-batches

1～500 件の Page Import または Code2Des を受け付けます。プロジェクトの Write 権限が必要です。PostgreSQL に保存し、処理前に 202 を返します。

探索はtype: "page_discovery"を指定し、itemsに1件のみを渡します。urlにはホームページまたは.xmlサイトマップを指定でき、サイトマップ記載ページへはアクセスしません。任意項目はmaxPages（1～1,000、デフォルト500）、maxDepth（0～5、デフォルト3）、includePaths、excludePaths（/で始まるプレフィックス各20件まで）です。GET /page-batches/{batch_id}/discoveryでstatus、pages、パスgroups、warnings、truncated、updated_atを取得します。取得にはプロジェクトのRead権限が必要です。URL選択ではインポートされず、最大500件を別のpage_importバッチとして作成します。

{
  "batchId": "00000000-0000-4000-8000-000000000001",
  "type": "page_import",
  "items": [{ "name": "Home", "url": "https://example.com/", "captureMode": "static" }]
}

生成時は type: "code2des" とし、各項目に pageImportId、figmaFileKey、screenId、任意の stateId / placementTarget を指定します。バリエーションごとに 1 項目です。インポートと生成は別バッチです。

同じ UUID・同じ正規化済み入力の再送は既存バッチを返します。同じ UUID で内容が異なる場合は 409 です。権限・ソース検証はディスパッチ時に項目単位で行い、失敗を分離します。

コードベースでは単一 Page Import と同じマニフェスト情報を使います。バッチ送信前にアセットを S3 へ直接アップロードしてください。

202 レスポンス

batchId、type、createdAt、集計 counts、順序付き items を返します。新規項目は queued です。