Anda sedang melihat dokumentasi Apigee Edge.
Lihat dokumentasi Apigee X.
Topik ini mencantumkan beberapa karakteristik dasar dari proxy API, beserta link ke informasi selengkapnya.
API adalah titik entri bagi satu aplikasi untuk menggunakan kemampuan aplikasi lainnya. Anda menerapkan proxy API untuk membuat API
Di Apigee Edge, Anda menerapkan proxy API dengan mengonfigurasi logika proxy API sebagai urutan langkah-langkah yang dieksekusi sebagai respons terhadap permintaan dari kode klien. Anda mengekspos proxy API kepada klien dengan menentukan endpoint yang menyertakan URL dengan jalur resource, kata kerja HTTP, persyaratan isi, dan sebagainya.
Meskipun disebut sebagai proxy API, dari perspektif kode klien, ini adalah API.
Untuk ringkasan proxy API, lihat Memahami API dan proxy API.
Anda menyusun urutan logika proxy API menggunakan flow
Dalam aplikasi apa pun, data mengalir melalui aplikasi yang dipandu oleh logika kondisi. Di Apigee Edge, jalur pemrosesan terdiri dari alur. Flow adalah urutan tahapan (atau "langkah") yang membentuk jalur pemrosesan proxy API. Flow adalah cara Apigee Edge menyediakan tempat bagi Anda untuk menerapkan logika dan perilaku di tempat tertentu dari klien ke resource backend, lalu kembali ke klien.
Untuk informasi selengkapnya tentang alur, lihat Mengontrol cara proxy dieksekusi dengan flow
Anda mengakses data status melalui variabel flow yang dibuat oleh proxy API
Proxy API memiliki akses ke variabel yang mewakili status eksekusi. Anda dapat mengakses variabel ini dari XML yang mengonfigurasi proxy dan kebijakan API Anda. Anda juga dapat mengaksesnya saat memperluas proxy API dengan bahasa prosedural, seperti Java, JavaScript, atau Python.
Variabel ini dipegang oleh Apigee Edge. Beberapa ada secara default, biasanya karena sama dengan yang dilakukan proxy API (seperti karena merupakan bagian dari permintaan HTTP). Anda juga dapat membuat variabel sendiri untuk memenuhi persyaratan logika.
Untuk informasi selengkapnya tentang variabel, lihat Mengelola status proxy dengan variabel flow.
Anda dapat menjalankan proxy API secara kondisional
Sama seperti di sebagian besar bahasa pemrograman, di proxy API Anda dapat mengeksekusi kode secara bersyarat. Kondisi sering kali didasarkan pada status proxy API, yang dapat Anda akses melalui variabel flow. Misalnya, Anda dapat memiliki kondisi yang memeriksa agen pengguna, lalu memproses permintaan sebagaimana mestinya.
Untuk mengetahui informasi selengkapnya tentang eksekusi bersyarat, lihat Variabel dan kondisi alur.
Anda menerapkan sebagian besar logika di proxy API menggunakan kebijakan
Sebagian besar logika yang Anda tambahkan ke proxy API dikemas sebagai kebijakan. Kebijakan adalah komponen Apigee Edge yang mencakup logika untuk area fungsional, seperti keamanan atau pengelolaan traffic. Anda mengonfigurasi kebijakan dengan XML yang menyetel properti untuk logika yang mendasarinya. Anda menyusun kebijakan dalam urutan "langkah" dalam flow, sehingga proxy API Anda akan menjalankan logika dalam urutan terbaik untuk sasaran proxy Anda.
Untuk informasi selengkapnya tentang kebijakan, lihat Apa itu kebijakan?.
Anda dapat menyertakan kumpulan fungsi yang dapat digunakan kembali
Jika proxy API Anda menyertakan logika yang akan digunakan dari beberapa tempat di kode Anda -- seperti proxy API lainnya -- Anda dapat mengumpulkan logika tersebut untuk panggilan dari beberapa tempat. Misalnya, Anda dapat mengelompokkan logika keamanan dalam alur bersama yang dipanggil oleh proxy API lain, sehingga mengurangi duplikasi di seluruh proxy API.
Untuk informasi selengkapnya tentang alur bersama, lihat Alur bersama yang dapat digunakan kembali. Untuk informasi lebih lanjut tentang rantai proxy API, lihat Membuat rantai proxy API bersama-sama.
Anda dapat men-debug proxy dengan alat Trace
Apigee Edge menyertakan alat Trace yang dapat Anda gunakan untuk memeriksa alur eksekusi proxy API Anda saat men-debug dan menguji. Alat ini secara visual menyajikan setiap langkah proxy API yang dijalankan untuk permintaan. Seperti pada debugger, di setiap langkah, Anda dapat melihat daftar nilai variabel yang membentuk status proxy API.
Untuk informasi selengkapnya tentang proses debug dengan Trace, lihat Menggunakan alat Trace.
Anda menangani error proxy API sebagai kesalahan
Dengan mengonfigurasi pengendali kesalahan, Anda dapat menyesuaikan error yang ditampilkan ke klien API. Pengendali error memberi Anda kontrol atas pesan error, apakah error tersebut berasal dari kode Anda sendiri atau dari komponen yang disertakan (seperti kebijakan).
Untuk mengetahui detailnya, lihat Menangani error.