課題にファイルを添付する

ターゲットプロジェクトの課題のリストを取得します。

query リクエストパラメーターを使用すると、検索クエリで課題のリストをフィルタリングできます。このサンプルでは、クエリを使用して、ターゲットプロジェクト（NP）に属する課題のみを取得します。

この特定の例では、返される課題のリストを短縮するために、$top=3 パラメーターを使用して、最初に見つかった 3 つの課題のみを取得します。

fields リクエストパラメーターでは、見つかった課題ごとに次の属性を返すようサーバーに指示します。

• id および idReadable - データベースエンティティ ID とプロジェクト内の課題の ID の両方。

• summary - 課題の概要は、対象の課題を特定できます。

このリクエストへの応答で、サーバーは次のデータを返します。

対象の課題の ID を見つけます。この場合、データベース ID 99-500 の課題 NP-77 を取り上げましょう。

課題にファイルを添付するには、ファイルの内容を含む POST リクエストを以下のエンドポイントに送信してください。

このエンドポイントは、multipart/form-data 形式のファイルアップロードデータを想定しています。multipart/form-data 形式（たとえば cURL -F upload1=@... オプション）を使用してファイルをアップロードする場合は、このリクエストパターンを使用してください。1 つのリクエストで複数のファイルをアップロードする場合は、ファイルごとに個別のマルチパートフォームフィールド名を使用してください。

このユースケースでは、以下の cURL コマンドを使用します。

この要請の要点は以下のとおりです。

• -F upload1=@/Users/jetbrains/Downloads/youtrack.txt は、upload1 という名前のマルチパートフォームフィールドとしてファイルをアップロードします。

• 1 つのリクエストに複数のファイルを添付するには、各ファイルに固有のフォームフィールド名を指定した -F オプションを追加します。

  -F upload1=@/Users/jetbrains/Downloads/youtrack.txt \ -F upload2=@/Users/jetbrains/Downloads/youtrack_new.jpeg

• @ という接頭辞は、cURL に対してローカルファイルシステムからファイルの内容を読み取るように指示します。

• Content-Type: multipart/form-data は、このアップロードパターンに適したコンテンツタイプです。

応答で、サーバーは name と添付ファイルのデータベースエンティティ ID を返します。