개발자 일시중지 해제

Apigee Edge 문서입니다.
Go to the Apigee X 문서로 이동합니다. info

수익 창출은 이전에 정지된 개발자를 정지 해제하는 데 사용할 수 있는 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 최종 볼륨 대역의 구성된 한도에 도달했습니다.