New Relic の Partnership API には、パートナー様がお客様の既存のサブスクリプションを新しいものに置き換えたり、New Relic のパートナーアカウントの請求書情報を更新したりするための機能が含まれています。この機能は、New Relic アカウントの再販業者やマネージドサービスプロバイダーとして活動するパートナー様にとって特に便利です。
たとえば、New Relic のリセラーパートナーのお客様が、New Relic のセールスチームからより高いサブスクリプションレベルを購入すると、New Relic は古いサブスクリプションを新しいサブスクリプションに置き換えます。そして、New Relic はこの情報をパートナーに伝えるために API を使用します。
要件 パートナーシップAPIは、New Relicの担当者から使用するように特に指示されていない限り、組織では利用できません。
このオブジェクトを使用する前に、 Partnership API requirements を読んでください。
通信の終点 パートナーは、パートナーの URL とPARTNER_ID
を識別する課金通信エンドポイントを実装する必要があります。New Relic はこのエンドポイントを使用して、New Relic がパートナー アカウントのサブスクリプションまたは請求書情報を変更したことをパートナーに通知します。エンドポイントは HTTPS をサポートする必要があります。
URL のパートナー指定部分は、New Relic の Partner Portal の Settings タブから特定されます。 PARTNER_ID
は、このアカウントのパートナーの外部 ID です。partner_external_identifier
パラメーターを使用してアカウントを作成するときに、この値を渡す必要があります。 Billing API Partnership billing APIでサポートされている機能は以下の通りです。
カスタマーサブスクリプション通知API 顧客のサブスクリプションに関する変更をパートナーに伝えるために、New Relic はこの URI で POST メソッドを使用します。
https://partner-specified/partner-specified/PARTNER_ID.json
認証は、パートナーの REST API キーまたは Admin ユーザーの API キー を含むヘッダーによって行われます。Partnership API は、結果を JSON として返します。
パラメーター:
名前
タイプ
説明
id
弦
お客様のNew RelicアカウントID
subscription_id
整数
サブスクリプションの数字的なID
subscription_string
弦
ディスプレイ用サブスクリプションの説明
price
整数
サブスクリプションの月額価格(単位:セント
number_of_hosts
整数
ホストの数
starts
日付
サブスクリプションの開始日(yyyymmdd)
expires
日付
サブスクリプションの終了日(yyyymmdd)
リターンコードです。
200: アップデートに成功しました。 404:アカウントが見つかりません。 422:パラメータがない、または無効です。 認証に失敗しました。 インボイス通知API New Relic はこのエンドポイントを使用して、パートナーアカウントのサブスクリプションレベルや請求書情報の変更をパートナーに通知します。New Relic は、この URI で PUT メソッドを使用します。
https://partner-specified/partner-specified/PARTNER_ID.json
また
https://partner-specified/partner-specified/PARTNER_ID.xml
Partnership API は、JSON または XML として結果を返します。
パラメーター:
名前
タイプ
説明
id
ストリング
お客様のNew RelicアカウントID
subscription_id
整数
サブスクリプションの数字的なID
subscription_string
ストリング
ディスプレイ用サブスクリプションの説明
price
整数
サブスクリプションの月額価格(単位:セント
リターンコードです。
200: アップデートに成功しました。 404:アカウントが見つかりません。 422:パラメータがない、または無効です。 認証に失敗しました。