プロジェクトおよび組織データを取得する

プロジェクトおよび組織データを取得する

1. 取得したいデータのプロジェクトの ID を取得します。手順については、プロジェクト ID を取得するを参照してください。このサンプルでは、プロジェクト ID 0-6 を使用します。

2. データベースエンティティ ID を使用して、特定のプロジェクトのデータを取得します。

   curl -X GET \ 'https://example.youtrack.cloud/api/admin/projects/0-6?fields=id,name,timeTrackingEnabled,shortName,leader(login,name,id),description,createdBy(login,name,id)' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer <YouTrack_token>'

   それに対し、サーバーは要求されたプロジェクトのデータを返します。

   { "description": "A project created using REST API", "leader": { "login": "root", "name": "John Smith", "id": "1-1", "$type": "User" }, "shortName": "RP", "createdBy": { "login": "john.doe", "name": "John Doe", "id": "1-2", "$type": "User" }, "name": "Rest Project", "id": "0-6", "$type": "Project" }

3. 組織とその組織が所属するプロジェクトの一覧を入手します。

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

   これに対し、サーバーは projects(id,name,shortName) で要求されたネストされたプロジェクトデータを含む組織データを返します。

   [ { "id": "120-1", "key": "92da6595-c398-481d-9071-c821ff49772b", "name": "JetBrains", "projects": [ { "id": "0-0", "name": "Sample Project", "shortName": "SP", "$type": "Project" } ], "$type": "Organization" }, { "id": "120-2", "key": "V2x9UNmH_L-5PHQ71qd0S", "name": "Acme Corp", "projects": [], "$type": "Organization" } ]

4. オプション。特定の組織のデータを取得します。

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

   それに対し、サーバーは要求された組織のデータを返します。

   { "id": "120-1", "key": "92da6595-c398-481d-9071-c821ff49772b", "name": "JetBrains", "projects": [ { "id": "0-0", "name": "Sample Project", "shortName": "SP", "$type": "Project" } ], "$type": "Organization" }