変更API V1のサポート終了のお知らせ
※本ナレッジは「End-of-Life (EOL) Announcement for Change V1 APIs」をもとに作成しております。
2024年1月31日より、ServiceDesk Plusの変更API V1のサポートが終了（EOL）となります。
これにより、以降のServiceDesk Plusのリリースでは、変更のAPI V1へアクセスできなくなります。
ビルド14503以下のServiceDesk Plusでは、引き続き変更API V1をご利用いただけます。
影響
API V1（特に変更のAPI V1）を利用して、ServiceDesk Plusと連携している
外部の製品/Webクライアント/デスクトップアプリが影響を受けます。
すなわち、API V1で設定しているクライアント連携/カスタムスクリプト/カスタム関数などで該当の機能が動作しなくなります。
推奨事項
API V1を使用して設定されている前述の機能を、API V3に更新することを強く推奨いたします。
なお、以下は廃止される変更のAPI V1および、それに対応するAPI V3の一覧です。
API名 | API V1 URL | V1オペレーション名 | 対応するAPI V3 URL | V3 HTTPメソッド |
GET Change （変更の取得） | /sdpapi/change/{変更ID} | GET | /api/v3/changes/{変更ID} | GET |
GET All Changes （すべての変更の取得） | /sdpapi/change | GET_ALL | /api/v3/changes | GET |
ADD Change （変更の追加） | /sdpapi/change | ADD | /api/v3/changes | POST |
UPDATE Change （変更の更新） | /sdpapi/change/{変更ID} | UPDATE | /api/v3/changes/{変更ID} | PUT |
DELETE Change （変更の削除） | /sdpapi/change/{変更ID} | DELETE | /api/v3/changes/{変更ID}/move_to_trash | DELETE |
ADD Attachment in Change （変更への添付ファイルの追加） | /sdpapi/change/{変更ID}/attachment | ADD_ATTACHMENT | /api/v3/changes/{変更ID}/upload （ここでの入力データはファイルデータとなります） | PUT |
なお、ServiceDesk Plus内では、以下の機能で変更APIを用いたスクリプトをサポートしています。
そのため、以下機能も確認/更新することを強く推奨いたします。
- ［管理］→［自動化］→［カスタムトリガー］→［変更］の［スクリプトを実行］オプション
- ［管理］→［自動化］→［カスタムスケジュール］の「実行対象」セクション
- ［管理］→［開発者スペース］→［カスタム関数］→［変更］のカスタム関数
- ［管理］→［開発者スペース］→［ページスクリプト］
- ［管理］→［開発者スペース］→［Webhook］→［新規変更］
- ＜インストールディレクトリ＞\ManageEngine\ServiceDesk\integration\custom_scripts 内にあるカスタムスクリプト
API V3ドキュメント
APIの更新に伴い、ServiceDesk PlusのAPI V3ドキュメントツールを確認されたい場合、
ServiceDesk Plusの製品画面にて、［管理］→［開発者スペース］→［API］からご利用ください。
また、グローバル本社で公開している「デモサイト」を利用して、API V3のドキュメントをご参照いただけます。
デモ版のServiceDesk Plusへログインしてから再度アクセスしてください。
その他ご不明な点等ございましたら「技術サポート」までお問い合わせください。