개발자 카테고리 관리

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

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

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

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

Edge UI

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

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

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

그림에 강조표시된 것처럼 개발자 카테고리 페이지에서 할 수 있는 작업은 다음과 같습니다.

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

Classic Edge (Private Cloud)

Classic 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 요청을 실행하여 개발자 카테고리를 추가합니다.

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

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}

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

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

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입니다 (개발자 카테고리를 추가하면 응답에서 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입니다. 업데이트된 설정과 개발자 카테고리의 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}는 삭제할 개발자 카테고리의 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로 설정합니다.

N/A 지원됨
value

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

N/A 예. 개발자 카테고리를 설정하기 위해 필요합니다.