Memigrasikan developer ke monetisasi

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

Jika Anda memiliki developer yang sudah ada dan perlu dimigrasikan ke Monetisasi:

  1. Buat produk API, paket API, dan paket tarif untuk developer yang Anda migrasikan, jika belum ada. Untuk 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. Tambahkan saldo prabayar untuk setiap developer, seperti yang dijelaskan dalam Mengelola saldo akun prabayar.
  5. Setujui paket tarif, seperti yang dijelaskan dalam Membeli paket tarif menggunakan API.

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

  6. 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 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 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 berikut merangkum properti konfigurasi yang dapat Anda tentukan dalam isi permintaan untuk menetapkan jumlah transaksi secara manual, nilai defaultnya, dan apakah diperlukan 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 khusus dalam pesan harus ditentukan sebagai nilai bilangan bulat positif atau desimal (maksimal empat angka desimal). 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 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 ke 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 ditagih biaya penyiapan atau biaya berulang yang diperlukan, Anda dapat menagih biaya penyiapan atau biaya berulang untuk paket tarif secara manual 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 berulang yang ditentukan oleh paket tarif.

    Tabel berikut meringkas properti konfigurasi yang dapat Anda tentukan dalam isi permintaan untuk menagih biaya penyiapan atau berulang secara manual untuk paket tarif, nilai defaultnya, dan apakah keduanya 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 biaya 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 akan 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 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