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şımakta olduğunuz geliştiriciler için henüz mevcut değilse API ürünlerini, API paketlerini ve ücret planlarını oluşturun. Daha fazla bilgi için aşağıdaki makalelere göz atın:
  2. Ücret planlarını yayınlama bölümünde açıklandığı şekilde ücret planlarını yayınlayın.
  3. Uygulama geliştiricilerini kaydetme bölümünde açıklandığı gibi, yeni geliştiricileri kuruluşunuza ekleyin.
  4. Ön ödemeli hesap bakiyelerini yönetme başlıklı makalede açıklandığı gibi, her geliştiricinin ön ödemeli bakiyesine para ekleyin.
  5. API'yi kullanarak ücret planları satın alma bölümünde açıklandığı şekilde ücret planını kabul edin.

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

  6. Taşımakta olduğunuz 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: Bir 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ğırıp istek gövdesinde batchSize özelliğini 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ıklarını manuel olarak ayarlamak için istek gövdesinde belirtebileceğiniz yapılandırma özellikleri özetlenmektedir.

    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 kullanılan özel özelliğin değeri.

    İletideki özel özellik numarası, pozitif tam sayı veya ondalık (en fazla dört ondalık basamak) değer olarak belirtilmelidir. Negatif değerlere izin verilmez.

    Özel özellik şu konumlarda tanımlanmalıdır:

    Yok Evet
    product

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

    Yok Evet
    type

    CHARGE (varsayılan değer) olarak ayarlanmalıdır.

    CHARGE Hayır

    Doğrulama adımlarını atlamak ve işlem sayısını zorunlu olarak 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 hesabında bakiye yoksa 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 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. İstek içinde batchSize, 125 olarak ayarlanır ve API ürünü için tanımlanan ilk özel özelliğin değeri 0.1 olarak ayarlanır. Birbirleriyle çarpıldığında 125 * 0,1 = 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. Bir geliştiriciden gerekli kurulum veya yinelenen ücretler alınmadıysa aşağıdaki kaynağı kullanarak bir ü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 veya yinelenen ücretler zaten alındıysa bu adımı atlayabilirsiniz. transactions kaynağının çağrılması, kurulumu veya ücret planı tarafından tanımlanan yinelenen ücretleri etkilemez.

    Aşağıdaki tabloda, bir ücret planı için kurulum veya yinelenen ücreti manuel olarak tahsil etmek üzere 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

    Alınacak kurulum veya yinelenen ücret.

    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 zorunlu olarak 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 hesabında bakiye yoksa ve hesaptaki etkinlik askıya alınmışsa ?force=false isteği doğrulama sırasında başarısız olur.

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