Langkah 4: Ubah endpoint target

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Setelah menguji proxy baru, Anda hampir siap untuk menambahkan kebijakan ke proxy tersebut. Namun, sebelum melakukannya, ubah endpoint target proxy Anda menjadi endpoint yang menampilkan beberapa data.

Ingat bahwa di Langkah 1: Membuat proxy API, Anda menetapkan endpoint target (di kolom API yang Ada) ke https://mocktarget.apigee.net. Misalkan endpoint tersebut tidak menampilkan data yang menarik. Kemudian, Anda dapat mengubah endpoint ke endpoint yang menampilkan beberapa XML yang berguna. Bagian ini menjelaskan cara melakukannya.

Editor Proxy Baru

Anda dapat mengubah endpoint target proxy di tampilan Develop pada Editor Proxy. Untuk membuka tampilan Develop:

  1. Pilih Develop > API Proxies dan di panel Proxies, pilih lingkungan untuk proxy.

  2. Dalam daftar proxy, pilih proxy myproxy, yang Anda buat di Langkah 1: Membuat proxy API.
  3. Klik tab Develop untuk menampilkan tampilan Develop:

    Mengembangkan tampilan di Editor Proxy

Tampilan pengembangan

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 Tombol tutup panel penelusuran..

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.

Editor visual dan teks dengan pemisah yang dapat dipilih.

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.

    Endpoint target yang dipilih di Proxy Explorer.

    Tindakan ini akan menampilkan diagram endpoint target di editor visual:

    Endpoint target yang dipilih di Proxy Explorer.

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

    XML untuk endpoint target yang 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.

Editor Proxy 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:

    Tab Develop.

    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

Anda dapat menguji perubahan dengan mengirim permintaan ke proxy, seperti yang Anda lakukan di Memanggil proxy API. Contoh berikut mengasumsikan bahwa proxy bernama myproxy:

curl https://YOUR_ENV_GROUP_HOSTNAME/myproxy

dengan YOUR ENV_GROUP_HOSTNAME adalah nama host grup lingkungan. Lihat Menemukan nama host grup lingkungan.

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