개발자를 수익 창출로 이전

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입니다.

    		 N/A 예
    batchSize

    이전하려는 거래 수입니다.

    		 1 아니요
    custAttn

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

    메시지의 커스텀 속성 번호는 양의 정수 또는 소수 (소수점 이하 최대 4자리)로 지정해야 합니다. 음수 값은 허용되지 않습니다.

    맞춤 속성은 다음 위치에 정의되어야 합니다.

    		 N/A 예
    product

    API 제품의 ID입니다.

    		 N/A 예
    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).

    		 N/A 예
    developer

    개발자의 ID입니다.

    		 N/A 예
    rate

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

    		 N/A 예
    ratePlan

    요금제의 ID입니다.

    		 N/A 예
    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