デベロッパーの停止を解除する

Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントに移動します。 情報

収益化には、次のセクションで説明するように、以前に停止されたデベロッパーの停止を解除するために使用できる一連の API が用意されています。設定された上限に達すると、デベロッパーが一時停止されることがあります。たとえば、取引数が上限に達した、前払いアカウントの残高がなくなったなどです。理由コードの完全なリストについては、停止されたデベロッパーの理由コードの概要をご覧ください。

API を使用して一時停止中のすべてのデベロッパーを表示する

組織のすべての停止中のデベロッパーを表示するには、次のリソースに GET リクエストを発行します。/organizations/{org_name}/suspended-developers

ここで

  • {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 プロダクトで停止されたすべてのデベロッパーの停止を解除するには、次のリソースに POST リクエストを発行します。/organizations/{org_name}/suspended-developers/unsuspend-by-product/{suspendedProduct_id}

ここで

たとえば、次の 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 を使用してデベロッパーの利用停止を解除する

停止された特定のデベロッパーの停止を解除するには、次のリソースに DELETE リクエストを発行します。/organizations/{org_name}/suspended-developers/{suspendedDev_id}。

ここで

必要に応じて、次のクエリ パラメータを渡すことができます。

クエリ パラメータ 説明
suspendedProduct_id API プロダクトの ID。形式は {org_id}@@@{product_id} のようになります。この値は、API を使用してすべての停止されたデベロッパーを表示すると API を使用して停止されたデベロッパーを表示するで説明されているように、停止されたすべてのデベロッパーまたは特定のデベロッパーを表示するときに prodId として返されます。

たとえば、次の 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 最終音量帯域の構成済み上限に達しました。