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. Membuat produk API, paket API, dan paket tarif untuk developer yang Anda yang bermigrasi, 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. Menambah saldo prabayar untuk setiap developer, seperti yang dijelaskan dalam Mengelola akun prabayar saldo.
  5. 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 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 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 properti batchSize 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:

    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 ke true (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 ke 125 dan nilainya untuk atribut khusus pertama yang ditetapkan untuk produk API disetel ke 0.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
    
  7. 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 atau RECURRINGFEES.

    CHARGE Ya

    Untuk melewati langkah validasi dan menagih biaya secara paksa, setel kueri force ke true (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