개발자 계정 정지 해제

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보

수익 창출은 다음 섹션의 설명처럼 이전에 정지된 개발자의 정지를 해제하는 데 사용할 수 있는 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를 사용하여 정지된 개발자 보기

/organizations/{org_name}/suspended-developers/{developer_email_or_id} 리소스에 GET 요청을 전송하여 조직의 정지된 개발자를 확인합니다.

각 항목의 의미는 다음과 같습니다.

  • {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 제품의 모든 개발자 정지 해제

/organizations/{org_name}/suspended-developers/unsuspend-by-product/{suspendedProduct_id} 리소스에 POST 요청을 실행하여 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 요청을 실행하여 정지된 특정 개발자의 정지를 해제합니다.

각 항목의 의미는 다음과 같습니다.

원하는 경우 다음 쿼리 매개변수를 전달할 수 있습니다.

쿼리 매개변수 설명
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 최종 볼륨 밴드의 구성된 한도에 도달했습니다.