リクエストのAdmin API V3について
本ナレッジは、「Upcoming End-of-Life of Request Admin V1 APls」を参考に記載しています。
ServiceDesk Plusビルド13005において、リクエストのAdmin API V1およびWorklog API V1のサポートが終了となります。
API V1からAPI V3に変更しない場合、API V1に基づくすべてのクライアントとの連携は動作しなくなります。
そのため、API V1からAPI V3へ変更することを推奨いたします。
サポート終了となるAPI V1とそれに対応するAPI V3の一覧
- レベル
| 操作 | V1 URL | 対応するV3 URL |
|---|---|---|
| GET | /sdpapi/admin/level/{level-id} | /api/v3/levels/{level_id} |
| GET_ALL | /sdpapi/admin/level | /api/v3/levels |
- モード
| 操作 | V1 URL | 対応するV3 URL |
|---|---|---|
| GET | /sdpapi/admin/mode/{mode-id} | /api/v3/modes/{mode_id} |
| GET_ALL | /sdpapi/admin/mode | /api/v3/modes |
- カテゴリー
| 操作 | V1 URL | 対応するV3 URL |
|---|---|---|
| GET | /sdpapi/admin/category/{category-id} | /api/v3/categories/{category_id} |
| GET_ALL | /sdpapi/admin/category | /api/v3/categories |
- サブカテゴリー
| 操作 | V1 URL | 対応するV3 URL |
|---|---|---|
| GET | /sdpapi/admin/subcategory/{subcategory-id} | /api/v3/subcategories/{subcategory_id} |
| GET_ALL | /sdpapi/admin/subcategory/category/{category-id} | /api/v3/categories/{category_id}/subcategories または api/v3/subcategories |
- 項目
| 操作 | V1 URL | 対応するV3 URL |
|---|---|---|
| GET | /sdpapi/admin/item/{item-id} | /api/v3/items/{item_id} |
| GET_ALL | /sdpapi/admin/item/subcategory/{subcategory-id} | /api/v3/items または /api/v3/subcategories/{subcategory-id}/items |
- インパクト
| 操作 | V1 URL | 対応するV3 URL |
|---|---|---|
| GET | /sdpapi/admin/impact/{impact-id} | /api/v3/impacts/{impact_id} |
| GET_ALL | /sdpapi/admin/impact | /api/v3/impacts |
- 緊急度
| 操作 | V1 URL | 対応するV3 URL |
|---|---|---|
| GET | /sdpapi/admin/urgency/{urgency-id} | /api/v3/urgencies/{urgency_id} |
| GET_ALL | /sdpapi/admin/urgency | /api/v3/urgencies |
- ステータス
| 操作 | V1 URL | 対応するV3 URL |
|---|---|---|
| GET | /sdpapi/admin/status/{status-id} | /api/v3/statuses/{status_id} |
| GET_ALL | /sdpapi/admin/status | /api/v3/statuses |
- 優先度
| 操作 | V1 URL | 対応するV3 URL |
|---|---|---|
| GET | /sdpapi/admin/priority/{priority-id} | /api/v3/priorities/{priority_id} |
| GET_ALL | /sdpapi/admin/priority | /api/v3/priorities |
- 作業ログ
| 操作 | V1 URL | 対応するV3 URL |
|---|---|---|
| GET_WORKLOG | /sdpapi/request/{request-id}/worklogs/{worklog-id} | /api/v3/requests/{request_id}/worklogs/{worklog_id} |
| GET_WORKLOGS | /sdpapi/request/{request-id}/worklogs/{worklog-id} | /api/v3/requests/{request_id}/worklogs |
| ADD_WORKLOG | sdpapi/request/{request-id}/worklogs | /api/v3/requests/{request_id}/worklogs |
| EDIT_WORKLOG | /sdpapi/request/{request-id}/worklogs/{worklog-id} | /api/v3/requests/{request_id}/worklogs/{worklog_id} |
| DELETE_WORKLOG | /sdpapi/request/{request-id}/worklogs/{worklog-id} | /api/v3/requests/{request_id}/worklogs/{worklog_id} |
- リクエストテンプレート
| 操作 | V1 URL | 対応するV3 URL |
|---|---|---|
| GET | /sdpapi/admin/request_template/{template-id} | /api/v3/request_templates/{template-id} |
| GET_ALL | /sdpapi/admin/request_template | /api/v3/request_templates |
関連するドキュメント
API V3に関するドキュメントはServiceDesk Plusの［管理］→［一般設定/開発者スペース］→［API］→［ヘルプドキュメント］をご覧ください。