Geliştiricileri para kazanmaya taşıma

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin.
bilgi

Para kazanmaya taşımanız gereken mevcut geliştiricileriniz varsa:

  1. Taşıma işlemini yaptığınız geliştiriciler için API ürünlerini, API paketlerini ve ücret planlarını oluşturun (henüz yoksa). Daha fazla bilgi için şu makaleleri inceleyin:
  2. Ücret planlarını yayınlama bölümünde açıklandığı şekilde ücret planlarını yayınlayın.
  3. Yeni geliştiricileri Uygulama geliştiricileri kaydetme bölümünde açıklandığı şekilde kuruluşunuza ekleyin.
  4. Ön ödemeli hesap bakiyelerini yönetme bölümünde açıklandığı şekilde her geliştiricinin ön ödemeli bakiyesine para ekleyin.
  5. API kullanan satın alma oranı planları başlıklı makalede açıklandığı şekilde ücret planını kabul edin.

    Not: Kurulum ücretlerinden muaf olmak için, geliştiriciden ödeme alınmışsa waivefees sorgu parametresini true olarak ayarlayın.

  6. Taşıdığınız bir geliştiricinin mevcut işlemleri varsa işlem kullanımını şu kaynağı kullanarak manuel olarak aktarabilirsiniz:
    /organizations/{org_name}/transactions. Burada {org_name}, kuruluşun adıdır.

    Not: Geliştiricinin mevcut işlemleri yoksa bu adımı atlayabilirsiniz.

    transactions kaynağı, mevcut işlem kullanımını yansıtan tek bir işlem ekler ve tüm dahili sayaçları bu yeni değeri yansıtacak şekilde günceller.

    Örneğin, geliştirici taşıma işleminden önce API'ye 1.000 çağrı gönderdiyse mevcut etkinliği yakalamak için transactions kaynağını çağırarak ve istek gövdesinde batchSize mülkünü 1.000 olarak ayarlayarak işlem kullanımını 1.000 olarak ayarlayabilirsiniz.

    Aşağıdaki tabloda, işlem sayısını, varsayılan değerlerini ve zorunlu olup olmadığını manuel olarak ayarlamak için istek gövdesinde belirtebileceğiniz yapılandırma özellikleri özetlenmiştir.

    Mülk Açıklama Varsayılan Zorunlu mu?
    application

    Geliştirici uygulamasının kimliği.

    Yok Evet
    batchSize

    Aktarmak istediğiniz işlem sayısı.

    1 Hayır
    custAttn

    İşlem kullanımını hesaplamak için batchSize ile birlikte kullanılan özel özelliğin değeri.

    Mesajdaki özel özellik numarası, pozitif bir tam sayı veya ondalık (dört ondalık basamağa kadar) değer olarak belirtilmelidir. Negatif değerlere izin verilmez.

    Özel özellik şurada tanımlanmalıdır:

    Yok Evet
    product

    API ürününün kimliği.

    Yok Evet
    type

    Varsayılan değer CHARGE olarak ayarlanmalıdır.

    CHARGE Hayır

    Doğrulama adımlarını atlamak ve işlem sayısını zorla ayarlamak için force sorgu parametresini true olarak ayarlayın (örneğin, ?force=true). Varsayılan olarak ?force=false ve doğrulama adımları yürütülür. Örneğin, ön ödemeli bir geliştiricinin bakiyesi sıfırsa ve hesaptaki etkinlik askıya alınmışsa ?force=false istek doğrulama sırasında başarısız olur.

    Örneğin, aşağıdaki istek, belirtilen uygulama ve API ürünü için işlem sayısını 50 olarak belirler:

    $ 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
    

    Aşağıdaki istek, belirtilen uygulama ve API ürünü için işlem kullanımını 12,5 olarak belirler. İstekte batchSize, 125 olarak ayarlanır ve API ürünü için tanımlanan ilk özel özelliğin değeri 0.1 olarak ayarlanır. 125 x 0,1 çarpımı 12,5 olur.

    $ 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. Geliştiriciden gerekli kurulum ücreti veya yinelenen ücretler alınmadıysa şu kaynağı kullanarak ücret planı için manuel olarak kurulum ya da yinelenen ücret alabilirsiniz:
    /organizations/{org_name}/transactions; burada {org_name}, kuruluşun adıdır.

    Not: Geliştiriciden kurulum veya yinelenen ücretler alınmışsa bu adımı atlayabilirsiniz. transactions kaynağının çağrılması, ücret planı tarafından tanımlanan kurulum veya yinelenen ücretleri etkilemez.

    Aşağıdaki tabloda, bir ücret planı için kurulum veya yinelenen ücreti manuel olarak tahsil etmek amacıyla istek gövdesinde belirtebileceğiniz yapılandırma özellikleri, varsayılan değerleri ve zorunlu olup olmadıkları özetlenmiştir.

    Mülk Açıklama Varsayılan Zorunlu mu?
    currency

    Ücret planı için kullanılan para birimi. Para biriminin ISO 4217 kodunu belirtin (ör. ABD doları için usd veya İsviçre frangı için chf).

    Yok Evet
    developer

    Geliştiricinin kimliği.

    Yok Evet
    rate

    Kurulum veya yinelenen ödeme.

    Yok Evet
    ratePlan

    Ücret planının kimliği.

    Yok Evet
    type

    SETUPFEES veya RECURRINGFEES olarak ayarlayın.

    CHARGE Evet

    Doğrulama adımlarını atlamak ve ücreti zorla tahsil etmek için force sorgu parametresini true olarak ayarlayın (örneğin, ?force=true). Varsayılan olarak ?force=false ve doğrulama adımları yürütülür. Örneğin, ön ödemeli bir geliştiricinin bakiyesi sıfırsa ve hesaptaki etkinlik askıya alınırsa ?force=false durumunda istek doğrulama sırasında başarısız olur.

    Örneğin, aşağıdaki istekte ücret planına abone olan geliştiriciden 10 ABD doları tutarında bir kurulum ücreti alınır:

    $ 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