プロジェクト ID を取得する

プロジェクト ID を取得するには

1. 利用可能なプロジェクトのリストを取得します。

   curl -X GET \ 'https://example.youtrack.cloud/api/admin/projects?fields=id,name,shortName' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer <YouTrack_token>' \ -H 'Content-Type: application/json'

   fields リクエストパラメーターでは、各プロジェクトの id、name、shortName 属性を返すようにサーバーに指示します。

   そのようなリクエストの場合、次のボディを使用してサーバーからレスポンスを取得します。

   [ { "shortName": "GRP", "name": "GRA Project", "id": "0-7", "$type": "Project" }, { "shortName": "RAP", "name": "Rest Api Project", "id": "0-2", "$type": "Project" }, { "shortName": "RP", "name": "Rest Project", "id": "0-6", "$type": "Project" }, { "shortName": "SP", "name": "Sample Project", "id": "0-0", "$type": "Project" }, { "shortName": "SNBX", "name": "Sandbox", "id": "0-3", "$type": "Project" } ]

2. オプション。プロジェクト name または shortName でプロジェクトリストをフィルタリングします。

   プロジェクトの name によるフィルターを使用したサンプルリクエスト:

   curl -X GET \ 'https://example.youtrack.cloud/api/admin/projects?fields=id,name,shortName&query=Sample+Project' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer <YouTrack_token>' \ -H 'Content-Type: application/json'

   プロジェクトの shortName によるフィルターを使用したサンプルリクエスト:

   curl -X GET \ 'https://example.youtrack.cloud/api/admin/projects?fields=id,name,shortName&query=sp' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer <YouTrack_token>' \ -H 'Content-Type: application/json'

   query パラメーターを使用したサンプルリクエストの場合、応答本文には一致するプロジェクトのデータのみが含まれます。

   [ { "shortName": "SP", "name": "Sample Project", "id": "0-0", "$type": "Project" } ]

3. サーバーからの応答の中で、対象プロジェクトの id を探します。

   この例では、プロジェクトエンティティ ID は 0-0 です。