Web API一覧
エリアとリソース
エリアはAPIの分類を意味し、リソースは実際の操作対象となるデータ(オブジェクト)を示します。エリアとリソースを組み合わせることで、各APIの対象データを一意に示すことができます。 TimeTracker NX Web APIに含まれるエリアは以下のとおりです。
| 名称 | 説明 |
|---|---|
| auth | 認証 |
| system | システムデータ(マスターデータ) |
| project | プロジェクト |
| workitem | ワークアイテム |
| analytics | 分析 |
エリア毎のWeb API
エリア毎のWeb APIの一覧を以下に示します。 API中の {} は必須のパラメーター(パスパラメーター)で、対象オブジェクト(データ)のIDを指定します。
auth
| リソース | 操作 | API | 必要な権限 |
|---|---|---|---|
| token | 認証用トークンを発行する | POST /auth/token | なし |
| 認証用トークンを無効にする | DELETE /auth/token | なし |
system
project
| リソース | 操作 | API | 必要な権限 | |
|---|---|---|---|---|
| projects | プロジェクト一覧の取得 | GET /project/projects | プロジェクトの閲覧 | |
| プロジェクトの取得 | GET /project/projects/{projectIds} | プロジェクトの閲覧 | ||
| プロジェクトの追加 | POST /project/projects | プロジェクトの作成 | ||
| プロジェクトの更新 | PUT /project/projects/{projectIds} | プロジェクトの管理 | ||
| workCalendar | プロジェクトカレンダーの取得 | GET /project/projects/{projectId}/workCalendar | プロジェクトの閲覧 | |
| プロジェクトカレンダーの更新 | PUT /project/projects/{projectId}/workCalendar | プロジェクトの管理 |
workitem
| リソース | 操作 | API | 必要な権限 | ||
|---|---|---|---|---|---|
| workItems | ワークアイテムの取得 | GET /workitem/workItems/{workItemIds} | プロジェクトの閲覧 | ||
| ワークアイテムの更新 | PUT /workitem/workItems/{workItemIds} | プロジェクトの編集 | |||
| ワークアイテムの削除 | DELETE /workitem/workItems/{workItemIds} | プロジェクトの編集 | |||
| subItems | 指定ワークアイテム一覧の取得 | GET /workitem/workItems/{workItemId}/subItems | プロジェクトの閲覧 | ||
| ワークアイテムの追加 | POST /workitem/workItems/{workItemId}/subItems | プロジェクトの編集 | |||
| duplicate | ワークアイテムの複製 | POST /workitem/workItems/{workItemId}/subItems/duplicate | プロジェクトの編集 | ||
| timeEntries | export | 実績工数のエクスポート | GET /workitem/workItems/timeEntries/export | 実績エクスポート |
analytics
| リソース | 操作 | API | 必要な権限 |
|---|---|---|---|
| timeEntities | 工数分析 | POST /analytics/timeEntities | なし |
| itemCounts | アイテム件数分析 | POST /analytics/itemCounts | なし |
Note
analytics APIは、Standard Editionでは利用できません。