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 | プロジェクトの編集 |
export | 実績工数のエクスポート | GET /workitem/workItems/timeEntries/export | 実績エクスポート |
analytics
リソース | 操作 | API | 必要な権限 |
---|---|---|---|
timeEntities | 工数分析 | POST /analytics/timeEntities | なし |
itemCounts | アイテム件数分析 | POST /analytics/itemCounts | なし |
Note
analytics APIは、Standard Editionでは利用できません。