Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi
Para kazanmaya taşımanız gereken mevcut geliştiricileriniz varsa:
- 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:
- Ücret planlarını yayınlama bölümünde açıklandığı şekilde ücret planlarını yayınlayın.
- Yeni geliştiricileri Uygulama geliştiricileri kaydetme bölümünde açıklandığı şekilde kuruluşunuza ekleyin.
- Ön ödemeli hesap bakiyelerini yönetme bölümünde açıklandığı şekilde her geliştiricinin ön ödemeli bakiyesine para ekleyin.
- 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 parametresinitrue
olarak ayarlayın. - 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övdesindebatchSize
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:
- API ürünü için işlem kaydetme politikası. İşlem kaydı politikası oluşturma başlıklı makaleyi inceleyin.
- API ürünü için etkin ücret planı. Özel özelliklerle ücret planını yapılandırma başlıklı makaleyi inceleyin.
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 parametresinitrue
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ğeri0.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
- 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
veyaRECURRINGFEES
olarak ayarlayın.CHARGE
Evet Doğrulama adımlarını atlamak ve ücreti zorla tahsil etmek için
force
sorgu parametresinitrue
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