Skip to content

コメント一覧 Tier 4

GET/api/files/:id/commentsCopied!

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

リクエスト

パス

idstringrequired
ファイルID

クエリ

nextstring
次ページ用カーソル
prevstring
前ページ用カーソル

INFO

nextprev のどちらも指定しない場合、直近に作成された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

削除済みのトップレベルコメントでも、残っている返信がある場合は返されることがあります。削除済みコメントが返される場合、contentanchordurationauthornull になります。