Anda sedang melihat dokumentasi Apigee Edge.
Buka
Dokumentasi Apigee X. info
Jika Anda memiliki developer yang perlu dimigrasikan ke Monetisasi:
- Membuat produk API, paket API, dan paket tarif untuk developer yang Anda yang bermigrasi, jika belum ada. Untuk informasi selengkapnya, lihat:
- Publikasikan paket tarif, seperti yang dijelaskan dalam Memublikasikan paket tarif.
- Tambahkan developer baru ke organisasi Anda, seperti yang dijelaskan dalam Mendaftarkan developer aplikasi.
- Menambah saldo prabayar untuk setiap developer, seperti yang dijelaskan dalam Mengelola akun prabayar saldo.
- Setujui paket tarif, seperti yang dijelaskan di Rasio pembelian
menggunakan API ini.
Catatan: Untuk meniadakan biaya penyiapan, jika developer telah ditagih, tetapkan
waivefees
parameter kueri ketrue
. - Jika developer yang Anda migrasikan memiliki transaksi yang sudah ada,
Anda dapat mentransfer penggunaan transaksi secara manual menggunakan resource berikut:
/organizations/{org_name}/transactions
, dengan{org_name}
adalah nama organisasi.Catatan: Jika developer tidak memiliki transaksi yang sudah ada, Anda dapat melewatinya langkah waktu ini.
Resource
transactions
menyisipkan satu transaksi yang mencerminkan penggunaan transaksi saat ini dan memperbarui semua penghitung internal untuk mencerminkan nilai baru ini.Misalnya, jika developer telah melakukan 1.000 panggilan ke API sebelum migrasi, untuk merekam aktivitas saat ini. Anda dapat mengatur penggunaan transaksi ke 1000 dengan memanggil Resource
transactions
dan menyetel propertibatchSize
ke 1.000 inci isi permintaan.Tabel berikut meringkas properti konfigurasi yang dapat Anda tetapkan dalam untuk mengatur jumlah transaksi, nilai {i>default-<i}nya, dan apakah tidak wajib.
Properti Deskripsi Default Wajib? application
ID aplikasi developer.
T/A Ya batchSize
Jumlah transaksi yang ingin Anda transfer.
1 Tidak custAttn
Nilai atribut khusus yang digunakan dengan batchSize untuk menghitung penggunaan transaksi.
Nomor atribut khusus dalam pesan harus ditentukan sebagai bilangan bulat positif atau desimal (hingga empat angka desimal). Nilai negatif tidak diizinkan.
Atribut khusus harus ditentukan di:
- Kebijakan pencatatan transaksi untuk produk API. Lihat Mengonfigurasi kebijakan pencatatan transaksi.
- Paket tarif aktif untuk produk API. Lihat Mengonfigurasi paket tarif dengan atribut khusus.
T/A Ya product
ID produk API.
T/A Ya type
Harus ditetapkan ke
CHARGE
(yang merupakan default).CHARGE
Tidak Untuk melewati langkah validasi dan secara paksa mengatur jumlah transaksi, atur
force
ketrue
(misalnya,?force=true
). Secara default,?force=false
dan langkah validasi telah dijalankan. Misalnya, jika developer prabayar memiliki saldo dan aktivitas nol di akun ditangguhkan, jika?force=false
permintaan akan gagal selama validasi.Misalnya, permintaan berikut menetapkan jumlah transaksi ke 50 untuk transaksi aplikasi dan produk 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
Permintaan berikut menetapkan penggunaan transaksi menjadi 12,5 untuk aplikasi yang ditentukan dan produk API. Dalam permintaan,
batchSize
ditetapkan ke125
dan nilainya untuk atribut khusus pertama yang ditetapkan untuk produk API disetel ke0.1
. Kapan dikalikan bersama, 125 * 0,1 adalah 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
- Jika developer belum ditagih biaya penyiapan atau berulang yang diperlukan, Anda dapat
kenakan biaya penyiapan atau biaya berulang untuk paket tarif menggunakan referensi berikut:
/organizations/{org_name}/transactions
, dengan{org_name}
adalah nama organisasi.Catatan: Jika developer telah ditagih biaya penyiapan atau berulang, Anda dapat lewati langkah ini. Memanggil resource
transactions
tidak akan memengaruhi penyiapan atau biaya berulang yang ditentukan oleh paket tarif.Tabel berikut meringkas properti konfigurasi yang dapat Anda tetapkan dalam isi permintaan untuk menagih biaya penyiapan atau biaya berulang secara manual untuk paket tarif, dan apakah nilai itu diperlukan atau tidak.
Properti Deskripsi Default Wajib? currency
Mata uang yang digunakan untuk paket tarif. Tentukan kode ISO 4217 untuk mata uang, seperti usd untuk dolar Amerika Serikat atau chf untuk franc Swiss.
T/A Ya developer
ID developer.
T/A Ya rate
Biaya penyiapan atau berulang yang harus ditagih.
T/A Ya ratePlan
ID paket tarif.
T/A Ya type
Tetapkan ke
SETUPFEES
atauRECURRINGFEES
.CHARGE
Ya Untuk melewati langkah validasi dan menagih biaya secara paksa, setel kueri
force
ketrue
(misalnya,?force=true
). Secara {i>default<i},?force=false
dan langkah validasi dijalankan. Misalnya, jika prabayar developer memiliki saldo nol dan aktivitas di akun tersebut ditangguhkan, jika?force=false
permintaan akan gagal selama validasi.Misalnya, permintaan berikut mengenakan biaya penyiapan sebesar 10 dalam dolar AS ke developer yang berlangganan paket tarif:
$ 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