개발자 카테고리 관리

Apigee Edge 문서입니다.
Apigee X 문서로 이동 정보

개발자 카테고리는 유사한 특성을 가진 개발자 또는 회사의 그룹으로, 특정 카테고리에서 작동하도록 수익 창출을 구성할 수 있습니다. 예를 들어 'revenue_sharing'이라는 개발자 카테고리를 만들고 개발자를 추가하여 수익 공유 앱을 개발하는 모든 개발자에게 적용되는 요금제를 만들 수 있습니다. 개발자 카테고리를 사용하여 요금제를 만드는 방법에 관한 자세한 내용은 요금제 만들기를 참고하세요.

개발자 카테고리 페이지 살펴보기

다음 섹션에 설명된 대로 Edge UI 또는 기존 Edge UI를 사용하여 개발자 카테고리 페이지에 액세스합니다.

Edge UI

카테고리 개발 페이지에 액세스하려면 다음 단계를 따르세요.

  1. apigee.com/edge에 로그인합니다.
  2. 왼쪽 탐색 메뉴에서 게시 > 수익 창출 > 개발자 카테고리를 선택합니다.

개발자 카테고리 페이지가 표시됩니다.

그림에 강조 표시된 것처럼 개발자 카테고리 페이지에서 다음을 수행할 수 있습니다.

  • 현재 개발자 카테고리 보기
  • 개발자 카테고리 추가, 수정 또는 삭제

Classic Edge (Private Cloud)

기존 Edge UI를 사용하여 카테고리 개발 페이지에 액세스하려면 다음 단계를 따르세요.

  1. http://ms-ip:9000에 로그인합니다. 여기서 ms-ip는 관리 서버 노드의 IP 주소 또는 DNS 이름입니다.
  2. 상단 탐색 메뉴에서 게시 > 개발자 카테고리를 선택합니다.

개발자 카테고리 페이지가 표시됩니다.

개발자 카테고리 페이지에서는 다음을 수행할 수 있습니다.

  • 현재 개발자 카테고리 보기
  • 개발자 카테고리 추가, 수정 또는 삭제

개발자 카테고리 추가

UI를 사용하여 개발자 카테고리를 추가하려면 다음 안내를 따르세요.

  1. 개발 카테고리 페이지에 액세스합니다.
  2. + 개발자 카테고리를 클릭합니다.
  3. 새 카테고리의 이름과 간단한 설명을 입력합니다.
  4. 개발자 카테고리 만들기를 클릭합니다.

개발자 카테고리에 회사 추가하기

개발자 카테고리에 회사를 추가합니다. 회사는 하나의 개발자 카테고리에만 속할 수 있습니다.

개발자 카테고리에 회사를 추가하려면 다음 단계를 따르세요.

  1. 상단 탐색 메뉴에서 게시 > 회사를 선택합니다.
  2. 개발자 카테고리에 추가할 회사를 선택합니다.
  3. 회사 페이지에서 수정을 클릭합니다.
  4. 회사의 개발자 카테고리를 선택합니다.
  5. 저장을 클릭합니다.

개발자 카테고리 수정

UI를 사용하여 개발자 카테고리를 수정하려면 다음 안내를 따르세요.

  1. 카테고리 개발 페이지에 액세스합니다.
  2. 수정하려는 개발자 카테고리 위에 커서를 놓고 아이콘을 클릭합니다.
  3. 개발자 카테고리를 입력합니다.
  4. 개발자 카테고리 업데이트를 클릭합니다.

개발자 카테고리 삭제

UI를 사용하여 개발자 카테고리를 삭제하려면 다음 단계를 따르세요.

  1. 카테고리 개발 페이지에 액세스합니다.
  2. 수정하려는 개발자 카테고리 위에 커서를 놓습니다.
  3. 을 클릭합니다.
  4. 삭제를 클릭하여 작업을 확인합니다.

API를 사용하여 개발자 카테고리 관리

다음 섹션에 설명된 대로 API를 사용하여 개발자 카테고리를 관리합니다.

API를 사용하여 개발자 카테고리 추가

/mint/organizations/{org_name}/developer-categories에 POST 요청을 실행하여 개발자 카테고리를 추가합니다.

요청을 실행할 때 페이로드에 카테고리 name 및 description를 지정합니다. 예를 들면 다음과 같습니다.

curl -X POST "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories" \
  -H "Content-Type:application/json"  \
  -d '{
    "name": "Gold",
    "description": "Gold membership"
  }' \
  -u email:password

다음과 유사한 응답이 표시되어야 합니다.

{
  "description" : "Gold membership",
  "id" : "aa6f960a-d9fd-416e-be39-c071418aabd0",
  "name" : "Gold"
}

API를 사용하여 개발자 카테고리에 개발자 또는 회사 추가

다음 리소스에 각각 POST 요청을 실행하여 회사 또는 개발자를 추가하거나 수정할 때 개발자 카테고리에 개발자 또는 회사를 추가합니다.

  • /organizations/{org_name}/companies
  • /organizations/{org_name}/developers

회사 또는 개발자를 수정할 때 개발자 또는 회사를 개발자 카테고리에 추가하려면 다음 리소스에 각각 PUT 요청을 실행합니다.

  • /organizations/{org_name}/companies/{company_id}
  • /organizations/{org_name}/developers/{developer_id}

회사 또는 개발자는 하나의 개발자 카테고리에만 속할 수 있습니다.

요청 본문에서 MINT_DEVELOPER_CATEGORY를 카테고리 내부 ID를 값으로 사용하여 속성으로 지정합니다. 예를 들어 다음 요청은 ID가 aa6f960a-d9fd-416e-be39-c071418aabd0인 '골드'라는 개발자 카테고리에 이미 있는 개발자를 추가합니다.

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/K4jW2QLjZ1h8GFA8" \
  -H "Content-Type: application/json" \
  -d '{
   "email" : "developer@apigee.com",
    "developerId" : "K4jW2QLjZ1h8GFA8",
    "firstName" : "Dev",
    "lastName" : "One",
    "userName" : "devone",    
    "attributes" : [ {
      "name" : "MINT_REGISTRATION_ID",
      "value" : "dev1"
    }, {
      "name" : "MINT_DEVELOPER_LEGAL_NAME",
      "value" : "DEV ONE"
    }, {
      "name" : "MINT_DEVELOPER_TYPE",
      "value" : "TRUSTED"
    }, {
      "name" : "MINT_BILLING_TYPE",
      "value" : "PREPAID"
    }, {
      "name" : "MINT_IS_BROKER",
      "value" : "TRUE"
    }, {
      "name" : "MINT_DEVELOPER_CATEGORY",
      "value" : "aa6f960a-d9fd-416e-be39-c071418aabd0"
    }, {
      "name" : "MINT_DEVELOPER_ADDRESS",
      "value" : "{
                   "address1": "Dev One Address",
                   "city": "Pleasanton",
                   "country": "US",
                   "isPrimary": "true",
                   "state": "CA",
                   "zip": "94588"
                }"
    }
  }' \
  -u email:password

API를 사용하여 개발자 카테고리 보기

조직의 특정 개발자 카테고리 또는 모든 개발자 카테고리를 확인합니다.

/mint/organizations/{org_name}/developer-categories/{category_id}에 GET 요청을 실행하여 특정 개발자 카테고리를 확인합니다. 여기서 {category_id}는 개발자 카테고리의 식별자입니다. 개발자 카테고리를 추가하면 응답에 ID가 반환됩니다. 예를 들면 다음과 같습니다.

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories/aa6f960a-d9fd-416e-be39-c071418aabd0" \
  -H "Accept:application/json" \
  -u email:password

/mint/organizations/{org_id}/developer-categories에 GET 요청을 실행하여 조직의 모든 API 개발자 카테고리를 확인합니다. 예를 들면 다음과 같습니다.

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories" \
  -H "Accept:application/json" \
  -u email:password

API를 사용하여 개발자 카테고리 수정

/mint/organizations/{org_name}/developer-categories/{category_id}에 PUT 요청을 실행하여 개발자 카테고리를 수정합니다. 여기서 {category_id}는 업데이트할 카테고리의 식별자입니다. 요청 본문에서 업데이트된 설정과 개발자 카테고리의 ID를 지정해야 합니다. 예를 들어 다음 요청은 개발자 카테고리의 설명을 수정합니다.

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories/aa6f960a-d9fd-416e-be39-c071418aabd0" \
  -H "Content-Type: application/json"  \
  -d '{
    "id": "aa6f960a-d9fd-416e-be39-c071418aabd0",
    "description": "Premium membership"
  }' \
  -u email:password

API를 사용하여 개발자 카테고리 삭제

/mint/organizations/{org_name}/developer-categories/{category_id}에 DELETE 요청을 실행하여 개발자 카테고리를 삭제합니다. 여기서 {category_id}는 삭제할 개발자 카테고리의 식별자입니다. 예를 들면 다음과 같습니다.

curl -X DELETE "https://api.enterprise.apigee.com /v1/mint/organizations/{org_name}/developer-categories/aa6f960a-d9fd-416e-be39-c071418aabd0" \
  -H "Accept:application/json" \
  -u email:password

API의 개발자 카테고리 구성 속성

다음 표에는 API를 사용하여 설정할 수 있는 구성 속성이 요약되어 있습니다.

이름 설명 기본값 필수 여부
name

속성 이름 MINT_DEVELOPER_CATEGORY로 설정합니다.

 해당 사항 없음 예
value

개발자가 추가된 개발자 카테고리의 ID입니다.

 해당 사항 없음 예, 개발자 카테고리를 설정하기 위해