コメント作成 Tier 4

POST/api/files/:id/commentsCopied!

コメント、または既存コメントへの返信を作成します。

例

SDK

const comment = await client.comments.create("FX1234567890ABCD", {
  content: "Looks great, approved.",
  anchor: 12000,
  duration: 3000,
  parent: { id: "0efee6f8-5829-41c9-bb4d-90dd7e72cc58" },
});

CLI

youvico comment create \
  --file FX1234567890ABCD \
  --content "Looks great, approved." \
  --anchor 12000 \
  --duration 3000 \
  --parent 0efee6f8-5829-41c9-bb4d-90dd7e72cc58

cURL

curl -X POST 'https://api.youvico.com/api/files/FX1234567890ABCD/comments' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "content": "Looks great, approved.", "anchor": 12000, "duration": 3000, "parent": { "id": "0efee6f8-5829-41c9-bb4d-90dd7e72cc58" } }'

{
  "data": {
    "id": "2fb4e60b-0d9a-46f3-a4dc-cb9fe8ad9be6"
  }
}

リクエスト

パス

idstringrequired

ファイルID

ボディ

contentstringrequired

1–1000 characters

コメント本文

anchornumber

動画ではミリ秒単位のタイムスタンプ、ドキュメントでは1から始まるページ番号

durationnumber

anchor と同じ単位のコメント継続時間

parentobject?

親コメントオブジェクト

parent.idstring

親コメントID

Example: 0efee6f8-5829-41c9-bb4d-90dd7e72cc58

parentIdstringdeprecated

親コメントID

WARNING

返信への返信は作成できません。parent.id はトップレベルコメントを指す必要があります。

レスポンス

201 Created を返します。

dataobject

作成されたコメント

data.idstring

作成されたコメントのID

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