ファイルコメント添付ファイルアップロード開始 Tier 3

POST/api/files/:id/comment-attachments/upload.multipartCopied!

ファイルコメント添付ファイルのアップロードを作成し、パートアップロード用のPresigned URLを返します。パートは100 MB単位で生成され、添付ファイルの最大サイズは1 GBです。

コメントに紐づけられていないアップロードは、作成から24時間後に自動クリーンアップの対象になります。

管理型アップロードには、SDKの commentAttachments.uploadForFile ヘルパーまたはCLIの youvico comment-attachment upload コマンドを使用します。どちらもマルチパートアップロード全体を処理します。

CLIによる管理型アップロード

CLIの例はこのエンドポイントだけを呼び出すのではなく、管理型アップロードフロー全体を実行します。

例

SDK

const upload = await client.commentAttachments.startForFile("FX1234567890ABCD", {
  name: "review-note.pdf",
  size: 1250000,
});

CLI

youvico comment-attachment upload \
  --file FX1234567890ABCD \
  --path ./review-note.pdf

cURL

curl -X POST 'https://api.youvico.com/api/files/FX1234567890ABCD/comment-attachments/upload.multipart' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "name": "review-note.pdf", "size": 1250000 }'

{
  "data": {
    "id": "CA1234567890ABCD",
    "parts": [
      {
        "partNumber": 1,
        "url": "https://example.com/upload/1"
      }
    ]
  }
}

リクエスト

パス

idstringrequired

ファイルID

ボディ

namestringrequired

1-255 characters

添付ファイル名

sizenumberrequired

1-1000000000

添付ファイルサイズ（バイト）

レスポンス

201 Created を返します。

dataobject

アップロードセッション

data.idstring

作成されたコメント添付ファイルID

Example: CA1234567890ABCD

data.partsarray

アップロードパート

data.parts[].partNumbernumber

パート番号

Example: 1

data.parts[].urlstring

パートアップロード用Presigned URL

Example: https://example.com/upload/1