Geliştiricileri para kazanmaya taşıma

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

Para Kazanma'ya taşımanız gereken mevcut geliştiricileriniz varsa:

  1. Taşıdığınız geliştiriciler için API ürünleri, API paketleri ve ücret planları oluşturun (zaten mevcut değillerse). Daha fazla bilgi için şu makalelere bakın:
  2. Ücret planlarını, Ücret planlarını yayınlama konusunda açıklandığı şekilde yayınlayın.
  3. Yeni geliştiricileri, Uygulama geliştiricilerini kaydetme başlıklı makalede açıklandığı şekilde kuruluşunuza ekleyin.
  4. Ön ödemeli hesap bakiyelerini yönetme bölümünde açıklandığı şekilde her geliştirici için ön ödeme bakiyesine para ekleyin.
  5. API'yi kullanan satın alma ücreti planları bölümünde açıklandığı gibi, ücret planını kabul edin.

    Not: Kurulum ücretlerinden feragat etmek için geliştiriciden ödeme alındıysa waivefees sorgu parametresini true olarak ayarlayın.

  6. Taşıdığınız bir geliştiricinin mevcut işlemleri varsa aşağıdaki kaynağı kullanarak işlem kullanımını 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ı yayınlamışsa mevcut etkinliği yakalamak için transactions kaynağını çağırıp batchSize özelliğini istek gövdesinde 1000 olarak ayarlayarak işlem kullanımını 1.000 olarak ayarlayabilirsiniz.

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

    Özellik Açıklama Varsayılan Zorunlu mu?
    application

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

    Yok Evet
    batchSize

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

    1 Hayır
    custAttn

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

    Mesajdaki özel özellik numarası, pozitif tam veya ondalık (en fazla dört ondalık basamak) değeriyle belirtilmelidir. Negatif değerlere izin verilmez.

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

    Yok Evet
    product

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

    Yok Evet
    type

    CHARGE olarak ayarlanmalıdır (varsayılan).

    CHARGE Hayır

    Doğrulama adımlarını atlamak ve işlem sayısını zorla ayarlamak için force sorgu parametresini true (örneğin, ?force=true) olarak ayarlayın. Varsayılan olarak ?force=false ve doğrulama adımları yürütülür. Örneğin, ön ödemeli geliştiricinin bakiyesi sıfırsa ve hesaptaki etkinlik askıya alınırsa ?force=false, doğrulama sırasında istek 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 ayarlar:

    $ 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 ayarlar. İstekte batchSize, 125 olarak ve API ürünü için tanımlanan ilk özel özelliğin değeri 0.1 olarak ayarlandı. 125 x 0,1 birbiriyle çarpıldığında 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 aşağıdaki kaynağı kullanarak ücret planı için kurulum veya yinelenen ücreti manuel olarak alabilirsiniz:
    /organizations/{org_name}/transactions. Burada {org_name}, kuruluşun adıdır.

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

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

    Özellik Açıklama Varsayılan Zorunlu mu?
    currency

    Ücret planı için kullanılan para birimidir. Para biriminin ISO 4217 kodunu belirtin. Örneğin, ABD doları için usd, İsviçre frangı için chf.

    Yok Evet
    developer

    Geliştiricinin kimliği.

    Yok Evet
    rate

    Alınacak kurulum ücreti veya yinelenen ücret.

    Yok Evet
    ratePlan

    Ücret planının kimliğidir.

    Yok Evet
    type

    SETUPFEES veya RECURRINGFEES olarak ayarlayın.

    CHARGE Evet

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

    Örneğin, aşağıdaki istek, ücret planına abone olan geliştiriciden ABD doları olarak 10 ABD doları kurulum ücreti alı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