コメント一覧 Tier 4

GET/api/files/: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[].anchorobject?

ファイル内の時刻、ページ、または領域を示すアンカーデータ

data[].durationnumber?

コメントに関連付けられたタイムスタンプまたは期間の値

Example: 12400

data[].createdAtstring

コメント作成日時

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

data[].updatedAtstring

コメント最終更新日時

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

data[].fileobject

親ファイル

data[].file.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

例

bash

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

json

{
  "data": [
    {
      "id": "2fb4e60b-0d9a-46f3-a4dc-cb9fe8ad9be6",
      "content": "Please tighten the logo safe area.",
      "anchor": null,
      "duration": 12400,
      "createdAt": "2026-04-10 08:00:00.000000",
      "updatedAt": "2026-04-10 08:10:00.000000",
      "file": {
        "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、anchor、duration、author は null になります。

コメント一覧 Tier 4 ​

リクエスト ​

パス ​

クエリ ​

レスポンス ​

例 ​

コメント一覧 Tier 4

リクエスト

パス

クエリ

レスポンス

例