개발자를 수익 창출로 이전

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

수익 창출로 이전해야 하는 기존 개발자가 있는 경우:

  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