Langkah 4: Ubah endpoint target

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat Dokumentasi Apigee Edge.

Kini setelah menguji proxy baru, Anda hampir siap untuk menambahkan kebijakan pada perusahaan tersebut. Namun, sebelum Anda melakukannya, ubah yang menghasilkan beberapa data.

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

Editor Proxy Baru

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

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

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

    Mengembangkan tampilan di Proxy Editor

Mengembangkan tampilan

Di panel sebelah kiri tampilan Develop, Anda dapat:

  • Telusuri teks di proxy di kolom Search proxy.
  • Tambahkan kebijakan baru.
  • Menambahkan proxy dan endpoint target.
  • Tambahkan resource lain.

Jika tidak ingin melihat panel sebelah kiri, Anda dapat menciutkannya dengan mengklik tombol tutup Tombol Tutup panel penelusuran..

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

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

Editor visual dan teks dengan pemisah yang dapat dipilih.

Catatan:

  • Klik dan tarik {i>divider<i} di antara dua editor ke atas atau ke bawah untuk memperluas area tampilan dari salah satu editor.
  • Anda dapat memperluas area tampilan editor visual dengan mengklik tombol pada sisi kanan editor teks, yang menutup panel editor teks. Klik tombol 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 tanda panah di samping Save di kanan atas Proxy Editor, lalu pilih Save as new revision.
  4. Untuk men-deploy perubahan, klik Deploy.
  5. Dalam dialog Deploy, pilih revisi dan lingkungan tempat deployment akan di-deploy, lalu klik Deploy.

Editor Proxy Klasik

Untuk mengubah endpoint target proxy:

  1. Login ke UI Apigee.
  2. Pilih Develop > Proxy API.
  3. Pilih proxy Anda dari daftar untuk menampilkan detail proxy API. Jika Anda tidak melihat {i>proxy<i} Anda dalam daftar, pastikan Anda memilih organisasi yang tepat, seperti yang dijelaskan di Beralih antarorganisasi.
  4. Klik tab Develop:

    Mengembangkan tab.

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

  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 <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 Save tombol.

    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. Di kolom terjadi error:

    1. Perbaiki konfigurasi proxy Anda. Apigee dapat memberikan panduan sintaksis sebagai pop-up.
    2. Deploy perubahan Anda secara manual pada lingkungan test dengan mengklik Penerapan > uji apakah Apigee tidak men-deploy-nya secara otomatis.

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

Menguji proxy

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

curl https://YOUR_ENV_GROUP_HOSTNAME/myproxy

dengan YOUR ENV_GROUP_HOSTNAME adalah nama host grup lingkungan. Lihat Temukan 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 ke JSON.

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