現在、Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご確認ください。 情報
Monetization には、以下のセクションで説明するように、以前に停止されたデベロッパーの停止解除に使用できる一連の API が用意されています。構成された上限に達すると、デベロッパーが停止される可能性があります。たとえば、トランザクション数が上限に達した、前払いアカウントの残高が不足しているなど。理由コードの一覧については、停止中のデベロッパーの理由コードの概要をご覧ください。
API を使用して、停止中のすべてのデベロッパーを表示する
リソース /organizations/{org_name}/suspended-developers
に GET リクエストを発行して、組織の停止中のすべてのデベロッパーを表示します。
ここで
{org_name}
には、組織の名前を指定します。
たとえば、次の cURL 呼び出しは、myorg
で停止中のすべてのデベロッパーを一覧表示します。
curl -H "Content-Type: application/json" -X GET \ "https://api.enterprise.apigee.com/v1/mint/organizations/myorg/suspended-developers" \ -u email:password
以下は、レスポンスの例です。
[ { "creationDate": 1464388723633, "devId": "myorg@@@6Vro7VnjUhpGVn3p", "id": "myorg-myorg@@@6Vro7VnjUhpGVn3p-myorg@@@myproduct-null-RATE_PLAN_RATE_BAND_EXCEEDED", "message": "mint.productHasBeenSuspended for myorg@@@6Vro7VnjUhpGVn3p myorg@@@myproduct due to RATE_PLAN_RATE_BAND_EXCEEDED", "orgId": "myorg", "prodId": "myorg@@@myproduct", "reasonCode": "RATE_PLAN_RATE_BAND_EXCEEDED" }, { "creationDate": 1464022846293, "devId": "myorg@@@vXh7LXxtUy9COVdy", "id": "myorg-myorg@@@vXh7LXxtUy9COVdy-myorg@@@myproduct-null-NO_CURRENT_PUBLISHABLE_ENTITY", "message": "mint.productHasBeenSuspended for myorg@@@vXh7LXxtUy9COVdy myorg@@@myproduct due to mint.noCurrentPublishableEntity", "orgId": "myorg", "prodId": "myorg@@@myproduct", "reasonCode": "NO_CURRENT_PUBLISHABLE_ENTITY" } ]
API を使用して停止中のデベロッパーを表示する
組織の停止中のデベロッパーを表示するには、GET リクエストをリソース /organizations/{org_name}/suspended-developers/{developer_email_or_id}
に送信します。
ここで
{org_name}
には、組織の名前を指定します。{developer_email_or_id}
には、デベロッパーの ID を指定します。デベロッパーのリストを確認するには、デベロッパーの一覧表示をご覧ください。
たとえば、次の cURL 呼び出しリストは、停止中のデベロッパー joe@example.com
の詳細を示しています。
curl -H "Content-Type: application/json" -X GET \ "https://api.enterprise.apigee.com/v1/mint/organizations/myorg/suspended-developers/joe@example.com" \ -u email:password
以下は、レスポンスの例です。
[ { "creationDate": 1464388723633, "devId": "myorg@@@6Vro7VnjUhpGVn3p", "id": "myorg-myorg@@@6Vro7VnjUhpGVn3p-myorg@@@myproduct-null-RATE_PLAN_RATE_BAND_EXCEEDED", "message": "mint.productHasBeenSuspended for myorg@@@6Vro7VnjUhpGVn3p myorg@@@myproduct due to RATE_PLAN_RATE_BAND_EXCEEDED", "orgId": "myorg", "prodId": "myorg@@@myproduct", "reasonCode": "RATE_PLAN_RATE_BAND_EXCEEDED" } ]
API を使用して、API プロダクトのすべてのデベロッパーの停止を解除する
API プロダクトの使用が停止されているすべてのデベロッパーの停止を解除するには、リソース /organizations/{org_name}/suspended-developers/unsuspend-by-product/{suspendedProduct_id}
に POST リクエストを発行します。
ここで
{org_name}
には、組織の名前を指定します。{suspendedProduct_id}
には、{org_id}@@@{product_id}
のような形式を使用して API プロダクトの ID を指定します。この値は、すべてまたは特定の停止中のデベロッパーを表示するとprodId
として返されます。詳細については、API を使用してすべての停止中のデベロッパーを表示すると API を使用して停止中のデベロッパーを表示するをご覧ください。
たとえば、次の cURL 呼び出しでは、API プロダクト myorg@@@myproduct
のすべてのデベロッパーの停止が解除されます。
curl -H "Content-Type: application/json" -X POST \ "https://api.enterprise.apigee.com/v1/mint/organizations/myorg/suspended-developers/unsuspend-by-product/myorg@@@myproduct" \ -u email:password
API を使用してデベロッパーの停止を解除する
停止中の特定のデベロッパーの停止を解除するには、リソース /organizations/{org_name}/suspended-developers/{suspendedDev_id} に DELETE リクエストを発行します。
ここで
{org_name}
には、組織の名前を指定します。{suspendedDev_id}
には、停止中のデベロッパーの ID を{org_id}@@@{dev_id}
のような形式で指定します。この値は、すべてまたは特定の停止中のデベロッパーを表示するとdevId
として返されます。詳細については、API を使用してすべての停止中のデベロッパーを表示すると API を使用して停止中のデベロッパーを表示するをご覧ください。
必要に応じて、次のクエリ パラメータを渡すことができます。
クエリ パラメータ | 説明 |
---|---|
suspendedProduct_id |
API プロダクトの ID。形式は {org_id}@@@{product_id} です。この値は、すべてまたは特定の停止中のデベロッパーを表示すると prodId として返されます。詳細については、API を使用してすべての停止中のデベロッパーを表示すると API を使用して停止中のデベロッパーを表示するをご覧ください。 |
たとえば、次の cURL 呼び出しでは、API プロダクト myorg@@@myproduct
の ID が myorg@@@6Vro7VnjUhpGVn3p
のデベロッパーの停止が解除されます。
curl -H "Content-Type: application/json" -X DELETE \ "https://api.enterprise.apigee.com/v1/mint/organizations/myorg/suspended-developers/myorg@@@6Vro7VnjUhpGVn3p?productId=myorg@@@myproduct" \ -u email:password
停止中のデベロッパーの理由コードの概要
次の表に、デベロッパーが停止された理由コードを示します。
理由コード | 説明 |
---|---|
INSUFFICIENT_FUNDS |
デベロッパー アカウントが不足しています。 |
LIMIT_VIOLATED |
デベロッパー アカウントに構成済みの上限に達しました。 |
NO_CURRENT_PUBLISHABLE_ENTITY |
デベロッパーが料金プランを承諾(登録)していない。 |
RATE_PLAN_RATE_BAND_EXCEEDED |
最終的な音量帯域の構成が上限に達しました。 |