Memigrasikan developer ke monetisasi

Anda sedang 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 informasi lebih lanjut, lihat:
  2. Publikasikan paket tarif, seperti yang dijelaskan dalam Paket tarif publikasi.
  3. Tambahkan developer baru ke organisasi Anda, seperti yang dijelaskan dalam Mendaftarkan developer aplikasi.
  4. Isi saldo prabayar untuk setiap developer, seperti yang dijelaskan di Mengelola saldo akun prabayar.
  5. Setujui paket tarif, seperti yang dijelaskan dalam Paket tarif pembelian menggunakan API.

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

  6. Jika developer yang Anda migrasikan sudah memiliki transaksi, Anda dapat mentransfer penggunaan transaksi secara manual menggunakan resource berikut:
    /organizations/{org_name}/transactions, dengan {org_name} sebagai nama organisasi.

    Catatan: Jika developer belum memiliki transaksi, 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 merekam aktivitas saat ini, Anda dapat menetapkan penggunaan transaksi ke 1.000 dengan memanggil resource transactions dan menetapkan properti batchSize ke 1.000 dalam isi permintaan.

    Tabel di bawah ini merangkum properti konfigurasi yang dapat Anda tentukan dalam isi permintaan untuk menetapkan jumlah transaksi, nilai defaultnya, dan apakah diperlukan atau tidak secara manual.

    Properti Deskripsi Default Wajib diisi?
    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.

    Angka atribut khusus dalam pesan harus ditentukan sebagai nilai bilangan bulat atau desimal positif (maksimal empat angka di belakang koma). Nilai negatif tidak diizinkan.

    Atribut khusus harus ditentukan di:

    		 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 menetapkan jumlah transaksi secara paksa, tetapkan parameter kueri force ke true (misalnya, ?force=true). Secara default, ?force=false dan langkah validasi dijalankan. Misalnya, jika developer prabayar memiliki saldo nol dan aktivitas di akun tersebut ditangguhkan, jika ?force=false permintaan akan gagal selama validasi.

    Misalnya, permintaan berikut menetapkan jumlah transaksi ke 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 ke 12,5 untuk aplikasi dan produk API yang ditentukan. Dalam permintaan, batchSize disetel ke 125 dan nilai untuk atribut khusus pertama yang ditentukan untuk produk API ditetapkan ke 0.1. Jika 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
  7. Jika developer belum ditagih untuk penyiapan yang diperlukan atau biaya berulang, Anda dapat menagih biaya penyiapan atau berulang secara manual untuk paket tarif menggunakan referensi berikut:
    /organizations/{org_name}/transactions, dengan {org_name} sebagai nama organisasi.

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

    Tabel di bawah merangkum properti konfigurasi yang dapat Anda tentukan dalam isi permintaan untuk menagih biaya penyiapan atau berulang secara manual untuk paket tarif, nilai defaultnya, dan apakah nilai tersebut diperlukan atau tidak.

    Properti Deskripsi Default Wajib diisi?
    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 akan ditagih.

    		 T/A Ya
    ratePlan

    ID paket tarif.

    		 T/A Ya
    type

    Tetapkan ke SETUPFEES atau RECURRINGFEES.

    		 CHARGE Ya

    Untuk melewati langkah validasi dan menagih biaya secara paksa, tetapkan parameter kueri force ke true (misalnya, ?force=true). Secara default, ?force=false dan langkah validasi dijalankan. 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