コメント一覧を取得する Tier 4

GET/api/versions/:id/commentsCopied!

バージョンのトップレベルコメントを作成日時順に返します。カーソルページネーションを使用します。

リクエスト

パス

idstringrequired

バージョン ID

クエリ

nextstring

次ページ用カーソル

prevstring

前ページ用カーソル

INFO

next と prev をどちらも指定しない場合、最新のコメント 25 件が返されます。

レスポンス

200 OK を返します。

dataarray

コメント一覧

data[].idstring

コメント ID

Example: 2fb4e60b-0d9a-46f3-a4dc-cb9fe8ad9be6

data[].contentstring?

コメントのテキスト

Example: Please tighten the logo safe area.

data[].startTimenumber?

開始タイムスタンプ。動画・YouTubeはミリ秒、PDF・Imageはページ番号

Example: 12400

data[].endTimenumber?

終了タイムスタンプ。動画・YouTubeはミリ秒、PDF・Imageはページ番号

Example: 18900

data[].drawingboolean?

描画が添付されているか

Example: true

data[].createdAtstring

コメント作成日時

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

data[].updatedAtstring

コメント最終更新日時

Example: 2026-04-10 08:10:00.000000

data[].versionobject

親バージョン

data[].version.idstring

親バージョン ID

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

data[].authorobject?

コメントの作成者

data[].author.idstring

投稿者のユーザー ID

Example: f6035d1a-29df-4d80-8d72-f1bbdddfb6ff

data[].author.namestring

投稿者の表示名

Example: Jin Seo

data[].author.avatarUrlstring?

投稿者のアバター URL

Example: https://cdn.youvico.com/avatar/jin.png

pageobject

ページネーションカーソル

page.nextstring?

次ページ用カーソル

Example: null

page.prevstring?

前ページ用カーソル

Example: MjAyNi0wNC0xMFQwODowMDowMC4wMDBa

例

curl 'https://api.youvico.com/api/versions/8fe89e5a-1d8f-4302-8437-fb0390ecf8eb/comments' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "data": [
    {
      "id": "2fb4e60b-0d9a-46f3-a4dc-cb9fe8ad9be6",
      "content": "Please tighten the logo safe area.",
      "startTime": 12400,
      "endTime": 18900,
      "drawing": true,
      "createdAt": "2026-04-10 08:00:00.000000",
      "updatedAt": "2026-04-10 08:10:00.000000",
      "version": {
        "id": "8fe89e5a-1d8f-4302-8437-fb0390ecf8eb"
      },
      "author": {
        "id": "f6035d1a-29df-4d80-8d72-f1bbdddfb6ff",
        "name": "Jin Seo",
        "avatarUrl": "https://cdn.youvico.com/avatar/jin.png"
      }
    }
  ],
  "page": {
    "next": null,
    "prev": "MjAyNi0wNC0xMFQwODowMDowMC4wMDBa"
  }
}

INFO

削除済みのトップレベルコメントでも、返信が残っている場合は引き続き返されることがあります。削除済みコメントが返された場合、content、startTime、endTime、drawing、author はすべて null になります。