Memigrasikan developer ke monetisasi

Anda melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

Jika Anda memiliki developer yang perlu dimigrasikan ke Monetisasi:

  1. Buat produk API, paket API, dan paket tarif untuk developer yang Anda migrasikan, jika belum ada. Untuk mengetahui informasi selengkapnya, lihat:
  2. Publikasikan paket tarif, seperti yang dijelaskan dalam Memublikasikan paket tarif.
  3. Tambahkan developer baru ke organisasi Anda, seperti yang dijelaskan dalam Mendaftarkan developer aplikasi.
  4. Tambah saldo prabayar untuk setiap developer, seperti yang dijelaskan dalam Mengelola saldo akun prabayar.
  5. Terima paket tarif, seperti yang dijelaskan dalam Membeli paket tarif menggunakan API.

    Catatan: Untuk menghapus biaya penyiapan, jika developer telah dikenai biaya, tetapkan waivefees parameter kueri ke true.

  6. Jika developer yang Anda migrasikan memiliki transaksi yang 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 ada, Anda dapat melewati langkah 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 mengeluarkan 1.000 panggilan ke API sebelum migrasi, untuk menangkap aktivitas saat ini, Anda dapat menetapkan penggunaan transaksi ke 1.000 dengan memanggil transactions resource dan menetapkan properti batchSize ke 1.000 di isi permintaan.

    Tabel berikut merangkum properti konfigurasi yang dapat Anda tentukan dalam isi permintaan untuk menetapkan jumlah transaksi secara manual, nilai defaultnya, dan apakah properti tersebut wajib atau tidak.

    Properti Deskripsi Default Wajib?
    application

    ID aplikasi developer.

    		 T/A Ya
    batchSize

    Jumlah transaksi yang ingin Anda transfer.

    		 1 Tidak
    custAttn

    Nilai atribut kustom yang digunakan dengan batchSize untuk menghitung penggunaan transaksi.

    Nomor atribut kustom dalam pesan harus ditentukan sebagai nilai bilangan bulat positif atau desimal (hingga empat tempat desimal). Nilai negatif tidak diizinkan.

    Atribut kustom harus ditentukan di:

    		 T/A Ya
    product

    ID produk API.

    		 T/A Ya
    type

    Harus ditetapkan ke CHARGE (yang merupakan nilai default).

    		 CHARGE Tidak

    Untuk melewati langkah validasi dan menetapkan jumlah transaksi secara paksa, tetapkan parameter kueri force ke true (misalnya, ?force=true). Secara default, ?force=false dan langkah validasi akan dieksekusi. Misalnya, jika developer prabayar memiliki saldo nol dan aktivitas di akun ditangguhkan, jika ?force=false permintaan akan gagal selama validasi.

    Misalnya, permintaan berikut menetapkan jumlah transaksi menjadi 50 untuk aplikasi dan produk API yang ditentukan:

    $ 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 dan produk API yang ditentukan. Dalam permintaan, batchSize ditetapkan ke 125 dan nilai untuk atribut kustom pertama yang ditentukan untuk produk API ditetapkan ke 0.1. Jika dikalikan, 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
  7. Jika developer belum dikenai biaya penyiapan atau biaya berulang yang diperlukan, Anda dapat mengenakan biaya penyiapan atau biaya berulang secara manual untuk paket tarif menggunakan resource berikut:
    /organizations/{org_name}/transactions, dengan {org_name} adalah nama organisasi.

    Catatan: Jika developer telah dikenai biaya penyiapan atau biaya berulang, Anda dapat melewati langkah ini. Memanggil resource transactions tidak akan memengaruhi biaya penyiapan atau biaya berulang yang ditentukan oleh paket tarif.

    Tabel berikut merangkum properti konfigurasi yang dapat Anda tentukan dalam isi permintaan untuk mengenakan biaya penyiapan atau biaya berulang secara manual untuk paket tarif, nilai defaultnya, dan apakah properti tersebut wajib 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 biaya berulang yang akan dikenakan.

    		 T/A Ya
    ratePlan

    ID paket tarif.

    		 T/A Ya
    type

    Tetapkan ke SETUPFEES atau RECURRINGFEES.

    		 CHARGE Ya

    Untuk melewati langkah validasi dan mengenakan biaya secara paksa, tetapkan parameter kueri force ke true (misalnya, ?force=true). Secara default, ?force=false dan langkah validasi akan dieksekusi. Misalnya, jika developer prabayar memiliki saldo nol dan aktivitas di akun ditangguhkan, jika ?force=false permintaan akan gagal selama validasi.

    Misalnya, permintaan berikut mengenakan biaya penyiapan sebesar 10 dalam dolar AS kepada 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