개발자를 수익 창출로 이전

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

Monetization으로 이전해야 하는 기존 개발자가 있는 경우 다음을 수행하세요.

  1. 이전하려는 개발자의 API 제품, API 패키지, 요금제를 만듭니다(아직 없는 경우) 자세한 내용은 다음을 참고하세요.
  2. 요금제 게시에서 설명된 대로 요금제를 게시합니다.
  3. 앱 개발자 등록에 설명된 대로 조직에 새 개발자를 추가합니다.
  4. 선불 계정 잔액 관리에 설명된 대로 각 개발자의 선불 잔액을 충전합니다.
  5. API를 사용하여 요금제 구매 에 설명된 대로 요금제를 수락합니다.

    참고: 개발자에게 이미 요금이 청구된 경우 설정 수수료를 면제하려면 waivefees 쿼리 매개변수를 true로 설정합니다.

  6. 이전하려는 개발자에게 기존 트랜잭션이 있는 경우 다음 리소스를 사용하여 트랜잭션 사용량을 수동으로 이전할 수 있습니다.
    /organizations/{org_name}/transactions 여기서 {org_name}은 조직의 이름입니다.

    참고: 개발자에게 기존 트랜잭션이 없는 경우 이 단계를 건너뛸 수 있습니다.

    transactions 리소스는 현재 트랜잭션 사용량을 반영하는 단일 트랜잭션을 삽입하고 이 새 값을 반영하도록 모든 내부 카운터를 업데이트합니다.

    예를 들어 개발자가 이전을 하기 전에 API를 1,000번 호출한 경우 현재 활동을 캡처하려면 transactions 리소스를 호출하고 요청 본문에서 batchSize 속성을 1,000으로 설정하여 트랜잭션 사용량을 1,000으로 설정할 수 있습니다.

    다음 표에서는 요청 본문에서 지정하여 트랜잭션 수, 기본값, 필수 여부를 수동으로 설정할 수 있는 구성 속성을 요약합니다.

    속성 설명 기본값 필수 여부
    application

    개발자 앱의 ID입니다.

    		 해당 사항 없음 예
    batchSize

    이전하려는 트랜잭션 수입니다.

    		 1 아니요
    custAttn

    트랜잭션 사용량을 계산하기 위해 batchSize와 함께 사용되는 맞춤 속성의 값입니다.

    메시지의 맞춤 속성 번호는 양의 정수 또는 소수점 이하 4자리까지의 십진수 값으로 지정해야 합니다. 음수 값은 허용되지 않습니다.

    맞춤 속성은 다음에서 정의해야 합니다.

    		 해당 사항 없음 예
    product

    API 제품의 ID입니다.

    		 해당 사항 없음 예
    type

    CHARGE (기본값)로 설정해야 합니다.

    		 CHARGE 아니요

    유효성 검사 단계를 건너뛰고 트랜잭션 수를 강제로 설정하려면 force 쿼리 매개변수를 true로 설정합니다 (예: ?force=true). 기본적으로 ?force=false이며 유효성 검사 단계가 실행됩니다. 예를 들어 선불 개발자의 잔액이 0이고 계정의 활동이 일시중지된 경우 ?force=false이면 유효성 검사 중에 요청이 실패합니다.

    예를 들어 다음 요청은 지정된 애플리케이션 및 API 제품의 트랜잭션 수를 50으로 설정합니다.

    $ curl -H "Content-Type:application/json" -X POST -d \
'{ 
   "application":{
     "id":"6a9b1afc-2110-43d6-bae7-1b137aecb05b"
   },
   "product":{
     "id":"testproduct"
   },
   "batchSize":50
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
-u email:password

    다음 요청은 지정된 애플리케이션 및 API 제품의 트랜잭션 사용량을 12.5로 설정합니다. 요청에서 batchSize는 125로 설정되고 API 제품에 정의된 첫 번째 맞춤 속성의 값은 0.1로 설정됩니다. 125 * 0.1은 12.5입니다.

    $ curl -H "Content-Type:application/json" -X POST -d \
'{ 
   "application":{
     "id":"6a9b1afc-2110-43d6-bae7-1b137aecb05b"
   },
   "product":{
     "id":"testproduct"
   },
   "batchSize": 125,
   "custAtt1" : 0.1
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
-u email:password
  7. 개발자에게 필요한 설정 또는 반복 수수료가 청구되지 않은 경우 다음 리소스를 사용하여 요금제의 설정 또는 반복 수수료를 수동으로 청구할 수 있습니다.
    /organizations/{org_name}/transactions, 여기서 {org_name}은 조직의 이름입니다.

    참고: 개발자에게 이미 설정 또는 반복 수수료가 청구된 경우 이 단계를 건너뛸 수 있습니다. transactions 리소스를 호출해도 요금제에 정의된 설정 또는 반복 수수료에는 영향을 미치지 않습니다.

    다음 표에서는 요청 본문에서 지정하여 요금제의 설정 또는 반복 수수료를 수동으로 청구할 수 있는 구성 속성, 기본값, 필수 여부를 요약합니다.

    속성 설명 기본값 필수 여부
    currency

    요금제에 사용되는 통화입니다. 통화의 ISO 4217 코드를 지정합니다(예: 미국 달러의 경우 usd, 스위스 프랑의 경우 chf).

    		 해당 사항 없음 예
    developer

    개발자의 ID입니다.

    		 해당 사항 없음 예
    rate

    청구할 설정 또는 반복 수수료입니다.

    		 해당 사항 없음 예
    ratePlan

    요금제의 ID입니다.

    		 해당 사항 없음 예
    type

    SETUPFEES 또는 RECURRINGFEES로 설정합니다.

    		 CHARGE 예

    유효성 검사 단계를 건너뛰고 수수료를 강제로 청구하려면 force 쿼리 매개변수를 true로 설정합니다 (예: ?force=true). 기본적으로 ?force=false이며 유효성 검사 단계가 실행됩니다. 예를 들어 선불 개발자의 잔액이 0이고 계정의 활동이 일시중지된 경우 ?force=false이면 유효성 검사 중에 요청이 실패합니다.

    예를 들어 다음 요청은 요금제를 구독한 개발자에게 미국 달러로 설정 수수료 10을 청구합니다. 

    $ curl -H "Content-Type:application/json" -X POST -d \
'{ 
   "developer":{
     "id":"dev1@myorg.com"
   },
   "currency":{
     "id":"usd"
   },
   "ratePlan":{
     "id":"mypackage_rateplan1"
   },   
   "rate":10,
   "type":"SETUPFEES"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
-u email:password