Edge를 사용하는 회사 및 개발자 관리

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

수익 창출 API 프로그램에 참여하는 회사 및 개발자를 더 세부적으로 관리하려는 경우(예: 테스트 목적으로 자체 회사 및 개발자를 만들려는 경우) 관리 UI 및 API를 사용하여 회사 및 개발자를 수동으로 만들 수 있습니다.

회사 및 개발자를 수동으로 만들어야 하는지 여부를 결정하는 주요 고려사항은 개발자가 관리 UI에 로그인하거나, Edge 관리 API 호출에서 사용자 인증 정보를 전송하거나, 개발자 포털에 로그인하는 데 사용자 인증 정보가 필요한지 여부입니다.

• 수익 창출 개발자가 Edge UI 또는 API에 액세스하는 데 로그인 사용자 인증 정보가 필요한 경우 먼저 자체 Apigee 관리자 계정이 있어야 합니다.
• 사용자 인증 정보가 필요하지 않은 테스트 개발자를 간단히 만들기만 하면 되는 경우 (예: 가상의 테스트 개발자로 API를 호출하려는 경우) Apigee 계정이 필요하지 않습니다.

UI를 사용하여 앱 개발자 관리

앱 개발자 관리에 설명된 대로 Edge UI를 사용하여 앱 개발자를 만들고, 관리하고, 활성화합니다. 앱 개발자를 만든 후 다음 섹션에 설명된 대로 회사에 추가할 수 있습니다.

UI를 사용하여 회사 관리

다음 섹션에 설명된 대로 회사를 만들고, 관리하고, 활성화합니다.

회사 페이지 살펴보기

아래 설명에 따라 회사 페이지에 액세스합니다.

회사 추가

회사를 추가하려면 다음 단계를 따르세요.

1. 회사 페이지에 액세스합니다.
2. + 회사를 클릭합니다.
3. 회사 세부정보를 입력합니다.

   다음 필드가 있어야 합니다.

   • 회사 이름
   • 관리자 (기본 회사 관리자인 사용자)
   • 결제 유형

   수익 창출 결제 구성에 따라 결제 유형이 기본적으로 PREPAID 또는 POSTPAID로 설정될 수 있습니다. 자세한 내용은 API를 사용하여 선불 및 후불 결제 유형 구성을 참고하세요.

4. 회사에 개발자를 하나 이상 추가합니다.
   1. 개발자 섹션의 개발자 추가 필드에 문자열을 입력하여 문자열과 일치하는 개발자 목록을 표시합니다.
   2. 드롭다운 목록에서 개발자를 선택합니다.
   3. 회사에 개발자를 추가하려면 이 단계를 반복합니다.
5. 맞춤 속성을 하나 이상 추가합니다.
   1. 맞춤 속성 섹션에서 + 새 항목을 클릭합니다.
   2. 커스텀 속성의 이름과 값을 입력합니다.
   3. 회사에 맞춤 속성을 추가하려면 이 단계를 반복합니다.
6. 회사 만들기를 클릭합니다.

회사 활성화 및 비활성화

회사를 활성화 및 비활성화하려면 다음 단계를 따르세요.

1. 회사 페이지에 액세스합니다.
2. 활성화하려는 회사 위에 커서를 놓고 작업 메뉴에서 를 사용 설정합니다.
   전환 버튼을 사용 중지하여 회사를 비활성화합니다.

회사 수정

회사를 수정하려면 다음 단계를 따르세요.

1. 회사 페이지에 액세스합니다.
2. 수정하려는 회사 위에 커서를 놓고 작업 메뉴에서 를 클릭합니다.
3. 필요에 따라 회사 세부정보를 업데이트합니다.
4. 회사 업데이트를 클릭하여 변경사항을 저장합니다.

회사 삭제

회사를 삭제하려면 다음 단계를 따르세요.

1. 회사 페이지에 액세스합니다.
2. 삭제하려는 회사 위에 커서를 놓고 작업 메뉴에서 를 클릭합니다.
3. 삭제를 클릭하여 삭제 작업을 확인합니다.

API를 사용하여 회사 및 개발자 관리

API를 사용하여 회사 및 개발자를 관리하는 방법은 다음 섹션에 설명되어 있습니다.

API를 사용하여 회사 및 개발자 만들기 및 업데이트

API Edge Management API로 회사 및 개발자를 관리하려면 다음 API 섹션을 참고하세요.

• 회사 만들기
• 개발자 만들기
  참고: 맞춤 속성을 전달하여 개발자를 만들 때 수익 창출 정보를 구성합니다.
• 회사 개발자 추가 또는 업데이트
  참고: 원하는 경우 개발자에게 역할을 할당할 수 있지만 필수는 아닙니다. 개발자 역할 목록을 보려면 개발자 역할 검색을 참고하세요.
• 모든 개발자 또는 단일 개발자의 수익 창출 구성을 나열합니다.
  참고: 개발자를 만들거나 업데이트할 때 맞춤 속성을 전달하여 수익 창출 정보를 정의합니다. 표준 (수익 창출 외) API를 사용하여 수익 창출 맞춤 속성 세트를 확인하고 모든 개발자 또는 단일 개발자를 나열할 수 있습니다.

API를 사용하여 개발자 역할 관리

수익 창출 API를 사용하여 역할을 만들 수 있습니다. 이렇게 하면 파트너의 역할을 설정할 수 있습니다. 예를 들어 파트너에 대한 관리자 및 애플리케이션 개발자 역할을 설정할 수 있습니다. 그런 다음 이러한 역할을 특정 파트너 직원에게 할당할 수 있습니다.

개발자 역할 만들기

개발자 역할을 만들려면 organizations/{org_name}/developer-roles에 POST 요청을 보냅니다. 요청할 때 요청 본문에서 역할의 이름과 설명, 조직의 식별을 지정해야 합니다. 예를 들면 다음과 같습니다.

$ curl -H "Content-Type:application/json" -X POST -d \
'{
   "name": "appDeveloper",
   "description": "App Developer",
   "organization": {
       "id": "{org_name}"
   }
 }' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-roles" \
-u email:password

개발자 역할 검색

개발자 역할을 가져오려면 organizations/{org_id}/developer-roles에 GET 요청을 실행합니다. 예를 들면 다음과 같습니다.

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

응답은 다음과 같아야 합니다(응답의 일부만 표시됨).

{
  "description" : "App Developer",
  "id" : "appdeveloper",
  "name" : "appDeveloper",
  "organization" : {
   ...
  }
}

API의 개발자 역할 구성 설정

다음 개발자 역할 구성 옵션이 API에 노출됩니다.

API를 사용하여 개발자의 세율 검색

organizations/{org_name}/tax-engine에 GET 요청을 실행하여 개발자의 현재 세율을 가져올 수 있습니다. 요청할 때 개발자의 식별을 쿼리 매개변수로 지정해야 합니다. 예를 들면 다음과 같습니다.

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tax-engine?developerId=dev7@myorg.com" \
-u email:password

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

0.09

API를 사용하여 다른 개발자별 작업 실행

요금제 만들기, 알림 조건 만들기 등 조직을 위해 수행할 수 있는 수익 창출 관련 작업의 대부분은 개인 개발자를 위해 수행할 수도 있습니다. 예를 들어 특정 개발자의 은행 계좌를 만들거나 특정 개발자의 수익 보고서를 생성할 수 있습니다.

다음 표에는 수익 창출 API를 사용하여 수행할 수 있는 개발자별 작업이 나와 있습니다. 또한 표에는 이러한 작업을 실행하는 방법에 관한 자세한 안내를 찾을 수 있는 위치도 나와 있습니다.