Langkah 6: Lampirkan kebijakan

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat Dokumentasi Apigee Edge.

Kebijakan dapat mengubah format pesan, menerapkan kontrol akses, memanggil layanan jarak jauh, memberi otorisasi kepada pengguna, memeriksa konten pesan untuk menemukan potensi ancaman, dan melakukan banyak hal lainnya. Untuk mengetahui 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 di berbagai titik dalam alur pesan permintaan dan respons sebagai langkah-langkah pemrosesan.

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

1. Buat kebijakan XMLtoJSON.
   1. Luaskan paket proxy API helloworld di bagian Apigee, posisikan kursor ke 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 respons 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 proxies di paket proxy API helloworld dan klik default.xml untuk membuka file di editor.
   2. Tambahkan elemen &lt;Step&gt; yang mereferensikan kebijakan &lt;Step&gt; ke alur &lt;Step&gt; di proxy API &lt;Step&gt;, seperti ditunjukkan 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 ke 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 telah diekspor.

   

5. Panggil API Anda di tab Terminal.

   curl localhost:8998/helloworld?apikey=ZQA5euYtNeJ7ZCGCJMpvd6F2BZOmxOzY

   Respons XML dikonversi menjadi JSON, sebagai berikut:

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

Selamat! Anda berhasil memasang kebijakan XMLtoJSON ke proxy API.

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

1 2 3 4 5 6 (BERIKUTNYA) Langkah 7: Men-deploy ke lingkungan Apigee 8