Page Import 作成

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

公開 URL から再利用可能な capture を 1 件作成します。この endpoint が作成するのは page_import row のみで、送信するのも page_import worker message のみです。Code2Des の作成・dispatch は行いません。

Project Write 権限が必要です。

{
  "url": "https://example.com/",
  "viewport": { "width": 1440, "height": 900, "deviceScaleFactor": 1 },
  "readySelector": "main"
}

viewport の default は 1440×900、scale 1 です。Width／height はそれぞれ 240–7680 CSS pixel、deviceScaleFactor は 0.5–4 です。readySelector は optional で、最大 512 文字です。URL は HTTP(S)、credential なし、port 80 または 443、public IP address のみに resolve する hostname を許可し、fragment は保存前に削除します。

201 response

{
  "pageImportId": "019ffa75-01c0-75a2-8123-456789abcdef",
  "organizationId": 1,
  "projectId": 7,
  "sourceKind": "public_url",
  "sourceUrl": "https://example.com/",
  "viewport": { "width": 1440, "height": 900, "deviceScaleFactor": 1 },
  "readySelector": "main",
  "status": "0",
  "attempt": 1,
  "resultUrl": null,
  "captureHash": null,
  "screenshotUrl": null,
  "error": null,
  "createdAt": "2026-08-21T00:00:00.000Z",
  "updatedAt": "2026-08-21T00:00:00.000Z"
}

Status は "0" processing、"1" completed、"2" failed です。Queue dispatch が失敗した場合は Page Import row を failed にして error を返します。

完了後、同じ pageImportId を複数の Code2Des trigger で再利用できます。