メインコンテンツまでスキップ

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

リソースAPI必要な権限
usersユーザー一覧の取得
GET /system/users
コスト閲覧(コスト単価情報取得時)
ユーザーの取得
GET /system/users/{userIds}
コスト閲覧(コスト単価情報取得時)
ユーザーの追加
POST /system/users
システム管理
ユーザーの更新
PUT /system/users/{userIds}
システム管理
ユーザーの削除
DELETE /system/users/{userIds}
システム管理
meログインユーザーの取得
GET /system/users/me
なし
timeEntries実績工数一覧の取得
GET /system/users/{userId}/timeEntries
タイムシートの閲覧
実績工数の取得
GET /system/users/{userId}/
timeEntries/{timeEntryIds}
タイムシートの閲覧
実績工数の追加
POST /system/users/{userId}/
timeEntries/
タイムシートの編集
実績工数の更新
PUT /system/users/{userId}/
timeEntries/{timeEntryIds}
タイムシートの編集
実績工数の削除
DELETE /system/users/{userId}/
timeEntries/{timeEntryIds}
タイムシートの編集
preference設定情報の取得
GET /system/users/{userIds}/preference
アカウント設定の変更
設定情報の更新
PUT /system/users/{userIds}/preference
アカウント設定の変更
notificationsユーザー通知一覧の取得
GET /system/users/{userId}/notifications
なし
userGroupsユーザーグループ一覧の取得
GET /system/userGroups
なし
subGroupsサブユーザーグループ一覧の取得
GET /system/userGroups/
{userGroupId}/subGroups
なし
organizations組織一覧の取得
GET /system/organizations
なし
subOrganizationsサブ組織一覧の取得
GET /system/organizations/
{organizationId}/subOrganizations
なし
users組織に所属するユーザーの取得
GET /system/organizations/
{organizationId}/users
なし
allassignedusers組織の子孫に所属するユーザーの取得
GET /system/organizations/
{organizationId}/allassignedusers
なし
fieldTypesフィールドタイプ一覧の取得
GET /system/fieldTypes
なし
itemTypesアイテムタイプ一覧の取得
GET /system/itemTypes
なし
statusTypesステータスタイプ一覧の取得
GET /system/statusTypes
なし
processCategories工程分類一覧の取得
GET /system/processCategories
なし
timeEntryCategories作業分類一覧の取得
GET /system/timeEntryCategories
なし
projectCategoriesプロジェクトカテゴリー一覧の取得
GET /system/projectCategories
なし
profilesプロファイル一覧の取得
GET /system/profiles
なし
プロファイルの取得
GET /system/profiles/{profileIds}
なし
latest最新プロファイルの一覧取得
GET /system/profiles/latest
なし
systemRolesシステムロール一覧の取得
GET /system/systemRoles
なし

project

リソースAPI必要な権限
projectsプロジェクト一覧の取得
GET /project/projects
プロジェクトの閲覧
プロジェクトの取得
GET /project/projects/{projectIds}
プロジェクトの閲覧
プロジェクトの追加
POST /project/projects
プロジェクトの作成
プロジェクトの更新
PUT /project/projects/{projectIds}
プロジェクトの管理
profileプロジェクトのプロファイルの取得
GET /project/projects/{projectId}/profile
なし
workCalendarプロジェクトカレンダーの取得
GET /project/projects/{projectId}/workCalendar
なし
プロジェクトカレンダーの更新
PUT /project/projects/{projectId}/workCalendar
なし
aclプロジェクトの権限の取得
GET /project/projects/{projectId}/acl
なし
プロジェクトの権限の追加
POST /project/projects/{projectId}/acl
プロジェクトの管理
プロジェクトの権限の更新
PUT /project/projects/{projectId}/acl/{aclId}
プロジェクトの管理
プロジェクトの権限の削除
DELETE /project/projects/{projectId}/acl/{aclId}
プロジェクトの管理

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
プロジェクトの編集
timeEntriesexport実績工数のエクスポート
GET /workitem/workItems/timeEntries/export
実績エクスポート

analytics

リソースAPI必要な権限
timeEntities工数分析
POST /analytics/timeEntities
なし
itemCountsアイテム件数分析
POST /analytics/itemCounts
なし
備考

analytics APIは、Standard Editionでは利用できません。