バージョン一覧を取得する Tier 4

GET/api/projects/:id/versionsCopied!

プロジェクトに属するバージョンのページネーション付き一覧を返します。

リクエスト

パス

idstringrequired

プロジェクト ID

クエリ

pagenumber

1〜100

ページ番号

Default: 1

sort.typestring

ソートフィールド

Possible values: namecreatedAt

Default: createdAt

sort.directionstring

ソート方向

Possible values: ascdesc

Default: desc

レスポンス

200 OK を返します。

dataarray

バージョン一覧

data[].idstring

バージョン ID

Example: 8fe89e5a-1d8f-4302-8437-fb0390ecf8eb

data[].namestring

バージョン名

Example: v12

data[].descriptionstring?

バージョンの説明

Example: Final review cut

data[].statusstring

レビューステータス

Example: NEED_REVIEW

data[].createdAtstring

バージョン作成日時

Example: 2026-04-09 18:00:00.000000

data[].updatedAtstring

バージョン最終更新日時

Example: 2026-04-10 02:00:00.000000

data[].projectobject

親プロジェクト

data[].project.idstring

親プロジェクト ID

Example: bdbff5de-96d7-468f-9db0-85fe28bd6b62

pageobject

ページネーション

page.currentnumber

現在のページ番号

Example: 1

page.hasNextboolean

次のページが存在するか

Example: false

例

curl 'https://api.youvico.com/api/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/versions' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "data": [
    {
      "id": "8fe89e5a-1d8f-4302-8437-fb0390ecf8eb",
      "name": "v12",
      "description": "Final review cut",
      "status": "NEED_REVIEW",
      "createdAt": "2026-04-09 18:00:00.000000",
      "updatedAt": "2026-04-10 02:00:00.000000",
      "project": {
        "id": "bdbff5de-96d7-468f-9db0-85fe28bd6b62"
      }
    }
  ],
  "page": {
    "current": 1,
    "hasNext": false
  }
}

INFO

制限付きレビュアーには、制限アクセス対象として明示的にマークされたバージョンのみが返されます。