Langkah 6: Lampirkan kebijakan

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Baca dokumentasi Apigee Edge.

Kebijakan dapat mengubah format pesan, menerapkan kontrol akses, memanggil layanan jarak jauh, mengizinkan pengguna, memeriksa konten pesan untuk mencari potensi ancaman, dan banyak lagi. Untuk informasi selengkapnya, lihat Apa yang dimaksud dengan kebijakan?

Endpoint proxy dan target menentukan pipeline untuk pemrosesan pesan permintaan dan respons yang disebut sebagai alur permintaan dan respons. Flow adalah tahapan berurutan di sepanjang jalur pemrosesan permintaan API. Kebijakan dilampirkan pada poin yang berbeda dalam alur pesan permintaan dan respons saat memproses langkah.

Pada langkah berikut, Anda akan membuat kebijakan baru dan melampirkannya ke proxy API dalam alur respons PreFlow untuk memastikan kebijakan tersebut diterapkan sebelum pemrosesan lainnya dilakukan. Kebijakan XMLtoJSON yang digunakan dalam tutorial ini mengonversi payload pesan respons API dari XML ke JSON.

1. Membuat kebijakan XMLtoJSON.
   1. Luaskan paket proxy API helloworld di bagian Apigee, posisikan kursor di atas folder policies, lalu klik .

      

      Wizard Buat kebijakan akan terbuka.

   2. Pilih Mediasi sebagai kategori kebijakan.
   3. Pilih XML to JSON sebagai jenis kebijakan.
   4. Masukkan XMLtoJSON sebagai nama kebijakan, lalu klik Enter

      Kebijakan ini ditambahkan ke folder /policies untuk proxy API di bagian Apigee dan dibuka di editor.

   5. Edit kebijakan untuk menetapkan elemen <OutputVariable> dan <Source> ke response.
      Catatan: Anda akan melampirkan kebijakan ke alur response di proxy API <PreFlow> di langkah berikutnya.

      <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
      <XMLToJSON async="false" continueOnError="false" enabled="true" name="XMLtoJSON">
          <DisplayName>XMLtoJSON</DisplayName>
          <Properties/>
          <Format>yahoo</Format>
          <OutputVariable>response</OutputVariable>
          <Source>response</Source>
      </XMLToJSON>

2. Lampirkan kebijakan ke endpoint proxy default.
   1. Luaskan folder proxy dalam paket proxy API helloworld lalu klik default.xml untuk membuka file di editor.
   2. Tambahkan elemen <Step> yang merujuk kebijakan XMLtoJSON ke alur <Response> di proxy API <PreFlow>, seperti yang ditampilkan di bawah ini.

      <ProxyEndpoint name="default">
         <PreFlow name="PreFlow">
            <Request>
               <Step>
                  <Name>verify-api-key</Name>
               </Step>
               <Step>
                  <Name>remove-query-param-apikey</Name>
               </Step>
               <Step>
                  <Name>impose-quota</Name>
               </Step>
            </Request>
            <Response>
               <Step>
                  <Name>XMLtoJSON</Name>
               </Step>
            </Response>
         </PreFlow>
       ...
      </ProxyEndpoint>

3. Untuk men-deploy ulang lingkungan, posisikan kursor di atas folder lingkungan dev di bagian Apigee, lalu klik .

   

4. Saat diminta memilih paket pengujian yang akan diekspor, klik Deploy without a test bundle karena paket pengujian sudah diekspor.

   

5. Panggil API Anda di tab Terminal.

   curl localhost:8998/helloworld?apikey=ZQA5euYtNeJ7ZCGCJMpvd6F2BZOmxOzY

   Respons XML dikonversi ke JSON, seperti berikut:

   {
     "root": {
       "city": "San Jose",
       "firstName": "John",
       "lastName": "Doe",
       "state": "CA"
     }
   }

Selamat! Anda berhasil melampirkan kebijakan XMLtoJSON ke proxy API Anda.

Selanjutnya, Anda akan men-deploy API sebagai arsip ke lingkungan Apigee untuk pengujian integrasi dan rilis produksi.

1 2 3 4 5 6