Halaman ini diterjemahkan oleh Cloud Translation API.

Langkah 4: Ubah endpoint target

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Baca dokumentasi Apigee Edge.

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

Ingat bahwa di Langkah 1: Buat proxy API, tetapkan endpoint target (di kolom Existing API) ke https://mocktarget.apigee.net. Misalkan endpoint tidak menampilkan data yang menarik. Kemudian, Anda dapat mengubah endpoint menjadi endpoint yang menampilkan beberapa XML 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:

Pilih Develop > API Proxies dan pada panel Proxies, pilih lingkungan untuk proxy.
Di daftar proxy, pilih proxy myproxy, yang Anda buat di Langkah 1: Buat proxy API.
Klik tab Develop untuk menampilkan tampilan Develop:

{i>Develop view <i}(tampilan)

Di panel kiri tampilan Develop, Anda dapat:

Telusuri teks di proxy di kolom Search proxy.
Tambahkan kebijakan baru.
Tambahkan proxy dan endpoint target.
Tambahkan resource lainnya.

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

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:

Anda dapat mengklik dan menarik pemisah di antara kedua editor ke atas atau ke bawah untuk memperluas area tampilan dari salah satu editor.
Anda dapat meluaskan area tampilan editor visual dengan mengklik tombol di sisi kanan editor teks, yang menutup panel editor teks. Klik tombol lagi untuk membuka kembali panel editor teks.

Mengubah endpoint target

Untuk mengubah endpoint target proxy:

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:
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>
...
```
Klik tanda panah di samping Save di kanan atas Proxy Editor, lalu pilih Save as new revision.
Untuk men-deploy perubahan, klik Deploy.
Dalam dialog Deploy, pilih revisi dan lingkungan tempat deployment, lalu klik Deploy.

Editor Proxy Klasik

Untuk mengubah endpoint target proxy:

Login ke UI Apigee.
Pilih Develop > API Proxies.
Pilih proxy Anda dari daftar untuk menampilkan detail proxy API. Jika tidak melihat proxy dalam daftar, pastikan Anda memilih organisasi yang tepat, seperti yang dijelaskan dalam Beralih di antara organisasi Anda.
Klik tab Develop:

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

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

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>
...
```
Untuk menyimpan perubahan pada konfigurasi proxy, klik tombol Save.

Apigee menyimpan perubahan dalam revisi proxy baru.
Untuk men-deploy revisi baru, pilih Deploy to: test, lalu klik Deploy 2.
Dalam 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 secara manual ke lingkungan test dengan mengklik Deployment > test jika Apigee tidak men-deploy-nya secara otomatis.
Anda dapat memeriksa apakah revisi proxy Anda berhasil di-deploy dengan melihat status revisi deployment di sebelah drop-down Deploy. Contoh:

Menguji proxy

Anda dapat menguji perubahan dengan mengirimkan 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 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, di langkah berikutnya Anda akan menambahkan kebijakan yang mengonversi XML ke JSON.

1 2 3 4 (NEXT) Langkah 5: Tambahkan kebijakan