개발자를 수익 창출로 이전

<ph type="x-smartling-placeholder"></ph> 현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서.
정보

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

  1. 참여할 개발자를 위한 API 제품, API 패키지, 요금제를 만듭니다. 아직 존재하지 않는 경우 자세한 내용은 다음을 참고하세요. <ph type="x-smartling-placeholder">
  2. 요금제 게시에 설명된 대로 요금제를 게시합니다.
  3. 앱 개발자 등록에 설명된 대로 조직에 새 개발자를 추가합니다.
  4. 선불 계정 관리의 설명에 따라 각 개발자의 선불 잔액을 충전합니다. 잔액.
  5. 구매율에 설명된 대로 요금제에 동의합니다. 요금제에 가입할 수 있습니다.

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

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

    참고: 개발자에게 기존 거래가 없는 경우 이 단계를 건너뛸 수 있습니다. 단계를 거칩니다.

    transactions 리소스는 모든 내부 카운터를 업데이트하여 이 새 값을 반영합니다.

    예를 들어 개발자가 이전 전에 API를 1,000회 호출한 경우 현재 활동을 캡처합니다. transactions 리소스와 batchSize 속성을 1,000 요청 본문입니다.

    다음 표에는 거래 수, 기본값 및 필수는 아닙니다

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

    개발자 앱의 ID입니다.

    해당 사항 없음
    batchSize

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

    1 아니요
    custAttn

    batchSize와 함께 사용하여 트랜잭션 사용량

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

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

    해당 사항 없음
    product

    API 제품의 ID입니다.

    해당 사항 없음
    type

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

    CHARGE 아니요

    유효성 검사 단계를 건너뛰고 트랜잭션 수를 강제로 설정하려면 force 쿼리 매개변수를 true로 설정합니다 (예: ?force=true)을 입력합니다. 기본적으로 ?force=false 및 유효성 검사 단계는 다음과 같습니다. 실행됩니다 예: 선불 개발자의 계정에 잔액이 없고 활동 내역이 없는 경우 정지되며 ?force=false인 경우 유효성 검사 중에 요청이 실패합니다.

    예를 들어 다음 요청은 지정된 API 제품입니다.

    $ 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
    

    다음 요청은 지정된 애플리케이션의 트랜잭션 사용량을 12.5로 설정하고 API 제품입니다 요청에서 batchSize125로 설정되고 값은 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 검증 중에 요청이 실패합니다.

    예를 들어 다음 요청은 개발자가 다음 요금제를 구독했습니다.

    $ 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