Heartbeat API v2 移行ガイド

2018 年 4 月 2 日以降、Heartbeat API v1 にアクセスできなくなります。このドキュメントは、新しい Heartbeat API へ移行するのをサポートすることを目的としています。

ベース URL

新しいハートビート ベース URL は、https://api.opsgenie.com/v2/heartbeats です。

API キーの使用法

API キーがすべてのペイロードから削除されました。次のドキュメントに示すように、新しいリクエストでは API キーは認証ヘッダーで指定されます。

https://docs.opsgenie.com/docs/authentication

Heartbeat 追加リクエスト

  • 現在、ペイロード フィールド "interval"、"intervalUnit"、"enabled" は、必須フィールドです。"description" フィールドはオプションのままです。

  • コンテンツ タイプのヘッダーは「application/json」として提供される必要があります。

  • For changes in response, see new Heartbeat API document.

Heartbeat 取得クエスト

  • “name” field in previous version is now provided as URL path variable, see new Heartbeat API document for example request url and response.

ハートビート更新リクエスト

  • 更新リクエストの HTTP メソッドが POST から PATCH に変更されました。

  • コンテンツ タイプのヘッダーは「application/json」として提供される必要があります。

  • “name” field in previous version is now provided as URL path variable, see new Heartbeat API document for example request url and response.

ハートビート削除リクエスト

  • “name” field in previous version is now provided as URL path variable, see new Heartbeat API document for example request url and response.

Heartbeat リクエストを有効/無効化する

  • これらのリクエストで使用される HTTP メソッドは、POST に加えて PUT と PATCH をサポートするようになりました。

  • “name” field in previous version is now provided as URL path variable, see new Heartbeat API document for example request urls and responses.

ハートビート送信リクエスト (新規バージョンではハートビート Ping 送信)

  • 現在、以前のバージョンのハートビート送信リクエストは、ハートビート Ping 送信と呼ばれます。この変更は、このリクエストの URL にも適用されます。

  • このリクエストで使用される HTTP メソッドは、POST に加えて GET、PUT、PATCH をサポートするようになりました。

  • この要求は非同期的に処理されるため、問題が発生した場合は、手動でログをチェックする必要があります。

  • “name” field in previous version is now provided as URL path variable, see new Heartbeat API document for example request url and response.

Heartbeat リクエストをリストする

  • Heartbeat API v2では、ハートビート リクエストのリストはサポートされていません。



さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。