Langkah 4: Ubah endpoint target

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Baca dokumentasi Apigee Edge.

Proxy Apigee API memiliki dua endpoint: endpoint proxy dan endpoint target. Endpoint proxy adalah antarmuka klien. Server menerima permintaan dari klien dan mengirimkan respons kembali ke klien. Endpoint target adalah antarmuka produsen API. API ini berkomunikasi dari Apigee ke produsen API, seperti layanan backend atau API. Untuk mempelajari endpoint lebih lanjut, lihat Apa yang dimaksud dengan proxy API?

Pada langkah ini, Anda akan mengubah endpoint target proxy API menjadi https://mocktarget.apigee.net/xml, resource yang menampilkan data XML pengujian. Setelah melakukan perubahan, Anda akan men-deploy ulang dan menguji proxy API yang telah direvisi.

Catatan: Ada versi baru UI Apigee, yang terintegrasi dengan konsol Google Cloud. UI baru ini disebut Apigee di konsol Cloud. Petunjuk di dua tab pertama di bawah menjelaskan cara menggunakan Apigee di konsol Cloud atau UI Apigee klasik.

Konsol Apigee di Cloud

1. Buka UI Apigee di Cloud Console di browser.
2. Pastikan project Google Cloud yang sama tempat Anda membuat proxy API dipilih dari dropdown di bagian atas halaman.
3. Pilih Pengembangan proxy > Proxy API
4. Di tabel proxy, pilih proxy myproxy, yang Anda buat di Langkah 1: Membuat proxy API.
5. Klik tab Mengembangkan.

Menjelajahi tampilan Develop

Di panel sebelah kiri tampilan Develop, Anda dapat:

• Telusuri teks di proxy di kolom Telusuri proxy.
• Tambahkan kebijakan baru.
• Tambahkan endpoint proxy dan target.
• Tambahkan referensi lainnya.

Jika tidak ingin melihat panel sebelah kiri, Anda dapat menciutkan panel tersebut dengan mengklik tombol tutup .

Panel sebelah kanan tampilan Develop menampilkan editor visual dan teks untuk proxy:

• Editor visual memberikan tampilan grafis alur permintaan dan respons.
• Editor teks memungkinkan Anda mengedit XML untuk proxy atau target.

Catatan:

• Anda dapat mengklik dan menarik pemisah di antara kedua editor ke atas atau ke bawah untuk memperluas area tampilan editor mana pun.
• Anda dapat memperluas area tampilan editor visual dengan mengklik tombol tombol di sebelah kanan editor teks, yang akan menutup panel editor teks. Klik tombol tombol lagi untuk membuka kembali panel editor teks.

Mengubah endpoint target

Untuk mengubah endpoint target proxy:

1. Di panel Proxy revision, pilih Target Endpoints > default.

   

   Tindakan ini akan menampilkan diagram endpoint target di editor visual:

   

   Di bawah editor visual, kode XML untuk endpoint target ditampilkan di editor teks:

   

2. Di editor teks, ubah <URL> menjadi https://mocktarget.apigee.net/xml. (Tambahkan "/xml" ke URL yang ada.)

   URL baru ditampilkan di bawah ini:

   ...
   <HTTPTargetConnection>
     <Properties/>
     <URL>https://mocktarget.apigee.net/xml</URL>
   </HTTPTargetConnection>
   ...

3. Klik panah di samping Simpan di kanan atas Editor Proxy, lalu pilih Simpan sebagai revisi baru.
4. Untuk men-deploy perubahan, klik Deploy.
5. Pada dialog Deploy, pilih revisi dan lingkungan tempat deployment akan dilakukan, lalu klik Deploy.

UI Apigee Klasik

Untuk mengubah endpoint target proxy:

1. Login ke UI Apigee.
2. Pilih Develop > API Proxies.
3. Pilih proxy Anda dari daftar untuk menampilkan detail proxy API. Jika Anda tidak melihat proxy dalam daftar, pastikan Anda memilih organisasi yang tepat, seperti yang dijelaskan dalam Beralih antar-organisasi.

4. Klik tab Mengembangkan:

   

   Tindakan ini akan mengarahkan Anda ke Editor Proxy API. Editor Proxy memungkinkan Anda melihat struktur proxy API dan mengonfigurasi alur proxy. (Alur hanyalah jalur bertahap yang diambil permintaan proxy API melalui platform Apigee. Tutorial lainnya akan membahas konsep alur.)

5. Di panel Navigator, pilih Target Endpoints > default > PreFlow:

   

   Apigee menampilkan setelan endpoint di panel Code:

   <TargetEndpoint name="default">
     <Description/>
     <FaultRules/>
     <PreFlow name="PreFlow">
       <Request/>
       <Response/>
     </PreFlow>
     <PostFlow name="PostFlow">
       <Request/>
       <Response/>
     </PostFlow>
     <Flows/>
     <HTTPTargetConnection>
       <Properties/>
       <URL>https://mocktarget.apigee.net</URL>
     </HTTPTargetConnection>
   </TargetEndpoint>

   Endpoint target ditentukan oleh elemen <HTTPTargetConnection>.

6. Ubah URL menjadi "https://mocktarget.apigee.net/xml". (Tambahkan "/xml" ke URL yang ada.)

   URL baru menampilkan blok XML kecil dalam isi respons.

   Konfigurasi endpoint Anda sekarang akan terlihat seperti berikut:

   ...
   <HTTPTargetConnection>
     <Properties/>
     <URL>https://mocktarget.apigee.net/xml</URL>
   </HTTPTargetConnection>
   ...

7. Untuk menyimpan perubahan pada konfigurasi proxy, klik tombol Save.

   Apigee menyimpan perubahan Anda dalam revisi proxy baru.

8. Untuk men-deploy revisi baru, pilih Deploy to: test, lalu klik Deploy 2.
9. Pada dialog konfirmasi, klik Deploy.

   Jika terjadi error, Apigee akan menyimpan perubahan Anda, tetapi tidak men-deploy proxy. Jika terjadi error:

   1. Perbaiki konfigurasi proxy Anda. Apigee dapat memberikan panduan sintaksis sebagai pop-up.
   2. Deploy perubahan Anda secara manual ke lingkungan test dengan mengklik Deployment > test jika Apigee tidak men-deploynya secara otomatis.

   Anda dapat memeriksa apakah revisi proxy berhasil di-deploy dengan melihat status revisi deployment di samping drop-down Deploy. Contoh:

   

Menguji proxy

Untuk menguji revisi proxy API, panggil proxy seperti yang Anda lakukan di Memanggil proxy API.

Kali ini, endpoint mocktarget menampilkan XML dalam isi respons:

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <city>San Jose</city>
  <firstName>John</firstName>
  <lastName>Doe</lastName>
  <state>CA</state>
</root>

Setelah proxy API menampilkan data XML, pada langkah berikutnya, Anda akan menambahkan kebijakan yang mengonversi XML menjadi JSON.

1 2 3 4 (BERIKUTNYA) Langkah 5: Menambahkan kebijakan