Antipola: Menentukan beberapa ProxyEndpoints di proxy API

Anda sedang melihat dokumentasi Apigee dan Apigee Hybrid.
Lihat dokumentasi Apigee Edge.

Konfigurasi ProxyEndpoint menentukan cara aplikasi klien menggunakan API melalui Apigee. ProxyEndpoint menentukan URL proxy API dan cara kerja proxy: kebijakan yang akan diterapkan dan endpoint target yang akan dirutekan, serta kondisi yang harus dipenuhi agar kebijakan atau aturan rute ini dapat dieksekusi.

Singkatnya, konfigurasi ProxyEndpoint menentukan semua yang perlu dilakukan untuk menerapkan API.

Antipola

Proxy API dapat memiliki satu atau beberapa endpoint proxy. Menentukan beberapa ProxyEndpoint adalah mekanisme yang mudah dan sederhana untuk menerapkan beberapa API dalam satu proxy. Hal ini memungkinkan Anda menggunakan kembali kebijakan dan/atau logika bisnis sebelum dan setelah pemanggilan TargetEndpoint.

Di sisi lain, saat menentukan beberapa ProxyEndpoint dalam satu proxy API, Anda akhirnya menggabungkan banyak API yang tidak terkait secara konseptual ke dalam satu artefak. Hal ini membuat proxy API lebih sulit dibaca, dipahami, di-debug, dan dikelola. Hal ini mengalahkan filosofi utama proxy API: memudahkan developer membuat dan mengelola API.

Dampak

Beberapa ProxyEndpoint dalam proxy API dapat:

  • Membuat developer sulit memahami dan mengelola proxy API.
  • Mengaburkan analisis. Secara default, data analisis digabungkan di tingkat proxy. Tidak ada perincian metrik menurut endpoint proxy kecuali jika Anda membuat laporan kustom.
  • Membuat pemecahan masalah pada proxy API menjadi sulit.

Praktik terbaik

Saat menerapkan proxy API baru atau mendesain ulang proxy API yang sudah ada, gunakan praktik terbaik berikut:

  1. Terapkan satu proxy API dengan satu ProxyEndpoint.
  2. Jika ada beberapa API yang berbagi server target umum dan/atau memerlukan logika yang sama sebelum atau setelah pemanggilan server target, pertimbangkan untuk menggunakan alur bersama guna menerapkan logika tersebut di proxy API yang berbeda.
  3. Jika ada beberapa API yang memiliki jalur dasar awal yang sama, tetapi berbeda di akhiran, gunakan alur bersyarat dalam satu ProxyEndpoint.
  4. Jika ada proxy API dengan beberapa ProxyEndpoint dan tidak ada masalah dengannya, maka Anda tidak perlu melakukan tindakan apa pun.

Menggunakan satu ProxyEndpoint per proxy API akan menghasilkan:

  1. Proxy yang lebih sederhana dan mudah dikelola
  2. Informasi yang lebih baik di Analytics, seperti performa proxy dan waktu respons target, akan dilaporkan secara terpisah, bukan digabungkan untuk semua ProxyEndpoint
  3. Pemecahan masalah dan penyelesaian masalah yang lebih cepat

Bacaan lebih lanjut