課題の添付ファイルをダウンロードする
REST API を使用して、特定の課題の添付ファイルをダウンロードします。
要約
このタスクを解決するには、基本的に、特定の課題の添付ファイルの完全なダウンロード URl を取得する必要があります。そうするには:
使用可能な添付ファイルとその属性のリストを取得します。
返された URL で添付ファイルを取得します。
ステップバイステップ
課題の添付ファイル一覧を取得する
課題の添付ファイルのリストを取得するには、GET リクエストを次のエンドポイントに送信します。
/api/issues/{issue_ID}/attachments
添付ファイルのダウンロード URL を作成するには、fields 要求パラメーターで url 属性を指定していることを確認してください。ターゲットアタッチメントの識別を容易にするために、少なくとも name 属性も追加します。
例:
curl -X GET \
'https://example.youtrack.cloud/api/issues/2-6/attachments?fields=name,size,mimeType,extension,charset,url' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <YouTrack_token>'
[
{
"charset": null,
"extension": "png",
"url": "/youtrack/api/files/7-2?sign=MTYxMzE2OTAwMDAwMHwxLTF8Ny0yfHdrRzJCYzA2cnZEclFLUzBLWEp6NXZGNE5kczA5eGVIVUUw%0D%0AbF9BVHZ3V3MNCg%0D%0A&updated=1569436739288",
"mimeType": "image/png",
"name": "orphan-modules.png",
"size": 208788,
"$type": "IssueAttachment"
},
{
"charset": null,
"extension": "png",
"url": "/youtrack/api/files/7-3?sign=MTYxMzE2OTAwMDAwMHwxLTF8Ny0zfFMxNW12bkFfNmhWZTFrWjhGa3lNZmF4Umt2MmFXWU1UWUFu%0D%0AUDJhalhITHMNCg%0D%0A&updated=1554209920719",
"mimeType": "image/png",
"name": "older-versions.png",
"size": 23812,
"$type": "IssueAttachment"
}
]
添付ファイルを取得する
これで、添付ファイルの url 属性で受け取ったリンクをたどり、結果をファイルとして保存するだけです。
次の形式でリクエストを行います。
curl -X GET --output picture.png 'https://{HOST:PORT}{URL from previous request}' -H 'Cache-Control: no-cache'
例:
curl -X GET --output orphan-modules.png \
'https://example.youtrack.cloud/api/files/7-2?sign=MTYxMzE2OTAwMDAwMHwxLTF8Ny0yfHdrRzJCYzA2cnZEclFLUzBLWEp6NXZGNE5kczA5eGVIVUUw%0D%0AbF9BVHZ3V3MNCg%0D%0A&updated=1569436739288' \
-H 'Cache-Control: no-cache'
クライアントは sign= 要求パラメーターを使用して識別されるため、ここでの Authorization ヘッダーは不要であることに注意してください。
2026 年 10 月 02 日
