Menerapkan batas monetisasi di proxy API

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Terapkan batas monetisasi dengan melampirkan kebijakan ke proxy API yang terkait dengan produk API yang dimonetisasi seperti yang dijelaskan di bagian berikut.

Menambahkan kebijakan autentikasi

Monetisasi Apigee menggunakan kebijakan VerifyAPIKey atau VerifyAccessToken untuk menentukan apakah permintaan masuk dapat dimonetisasi dengan memeriksa paket tarif yang dipublikasikan dan aktif.

Lampirkan kebijakan VerifyAPIKey atau kebijakan VerifyAccessToken ke proxy API dengan salah satu cara berikut:

  • Saat membuat proxy API menggunakan wizard Buat proxy, pilih Kunci API atau OAuth 2.0 di bagian Keamanan: Otorisasi di halaman Kebijakan umum. Contoh:

    Halaman kebijakan umum dari wizard Buat proxy dengan Kunci API dipilih

  • Saat mengembangkan proxy API, lampirkan kebijakan VerifyAPIKey atau kebijakan VerifyAccessToken ke alur permintaan sebagai kebijakan pertama di PreFlow proxy API. Contoh:

    Tab Developer di editor proxy API yang menampilkan kebijakan VerifyAPIKey yang dilampirkan
                                                                                     ke PreFlow

Untuk informasi selengkapnya, lihat:

Menerapkan langganan developer ke produk API

Lampirkan kebijakan MonetizationLimitsCheck ke proxy API untuk menerapkan langganan developer ke produk API. Secara khusus, kebijakan ini dipicu jika developer aplikasi yang mengakses API belum membeli langganan ke produk API terkait. Dalam hal ini, kebijakan MonetizationLimitsCheck akan memunculkan error dan memblokir panggilan API.

Jika tidak ada paket tarif monetisasi untuk produk API yang diambil selama eksekusi panggilan proxy, produk tersebut dianggap tidak dimonetisasi, kebijakan MonetizationLimitsCheck tidak mengambil data lebih lanjut, dan kebijakan tersebut tidak berpengaruh.

Saat Anda melampirkan kebijakan MonetizationLimitsCheck ke proxy API, variabel alur mint.limitscheck.* dan mint.subscription_* akan diisi, seperti yang dijelaskan dalam Men-debug kebijakan MonetizationLimitsCheck dan referensi variabel alur mint.

Lampirkan kebijakan MonetizationLimitsCheck ke proxy API dengan salah satu cara berikut:

  • Saat membuat proxy API menggunakan wizard Buat proxy, pilih Terapkan batas monetisasi di halaman Kebijakan umum, seperti yang ditunjukkan pada gambar berikut.

    Halaman kebijakan umum di wizard Buat proxy dengan Pemeriksaan Penerapan Batas dipilih

  • Saat mengembangkan proxy API, lampirkan MonetizationLimitsCheckPolicy ke alur permintaan di PreFlow proxy API setelah kebijakan VerifyAPIKey atau VerifyAccessToken, seperti yang ditunjukkan pada gambar berikut.

    Tab Developer di editor proxy API yang menampilkan kebijakan MonetizationLimitsCheck yang dilampirkan
                                                                                     ke PreFlow setelah kebijakan VerifyAPI

Untuk informasi selengkapnya, lihat:

Menerapkan kuota monetisasi di proxy API

Kuota menentukan jumlah permintaan yang diizinkan untuk produk API selama jangka waktu tertentu. Untuk menerapkan kuota monetisasi, sebaiknya Anda menetapkan nilai kuota saat membuat produk API.

Menentukan nilai kuota untuk produk API tidak otomatis menerapkan batasan pada jumlah panggilan yang dapat dilakukan melalui produk API. Anda juga harus menambahkan kebijakan Kuota ke proxy API yang dirujuk oleh produk API untuk memastikan nilai kuota yang ditentukan di tingkat produk API diterapkan.

Lampirkan kebijakan Kuota ke proxy API dengan salah satu cara berikut:

  • Saat membuat proxy API menggunakan wizard Buat proxy, pilih Terapkan kuota per aplikasi di bagian Kuota pada halaman Kebijakan umum, seperti yang ditunjukkan pada gambar berikut.

    Halaman kebijakan umum di wizard Buat proxy dengan Impose quotas per app selected

  • Saat mengembangkan proxy API, lampirkan kebijakan Kuota ke alur permintaan di PreFlow proxy API setelah kebijakan VerifyAPIKey atau VerifyAccessToken, seperti yang ditunjukkan pada gambar berikut.

    Tab Developer di editor proxy API yang menampilkan kebijakan Kuota yang dilampirkan
                                                                                 ke PreFlow

Edit kebijakan Kuota untuk mengaktifkan elemen <UseQuotaConfigInAPIProduct> agar dapat menggunakan konfigurasi kuota yang ditentukan di tingkat produk API.

Contoh:

<Quota continueOnError="false" enabled="true" name="impose-quota">
    <DisplayName>Impose Quota</DisplayName>
    <UseQuotaConfigInAPIProduct stepName="verify-api-key">
        <DefaultConfig>
            <Allow>10000</Allow>
            <Interval>1</Interval>
            <TimeUnit>week</TimeUnit>
        </DefaultConfig>
    </UseQuotaConfigInAPIProduct>
    <Distributed>true</Distributed>
    <Synchronous>true</Synchronous>
    <StartTime>2021-01-01 12:00:00</StartTime>
</Quota>

Saat Anda melampirkan kebijakan Kuota ke proxy API, variabel alur ratelimit.* akan diisi, seperti yang dijelaskan dalam Men-debug kebijakan Kuota dan referensi variabel alur kebijakan Kuota.

Untuk informasi selengkapnya, lihat: