Langkah 6: Lampirkan kebijakan

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Kebijakan Apigee dapat mengubah format pesan, menerapkan kontrol akses, memanggil layanan jarak jauh, memberikan otorisasi kepada pengguna, memeriksa konten pesan untuk menemukan potensi ancaman, dan melakukan banyak hal lainnya. 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. Alur adalah tahap berurutan di sepanjang jalur pemrosesan permintaan API. Kebijakan dilampirkan di berbagai titik dalam alur pesan permintaan dan respons sebagai langkah pemrosesan.

Pada langkah-langkah berikut, Anda akan membuat kebijakan baru dan melampirkan kebijakan tersebut ke proxy API dalam alur respons PreFlow untuk memastikan kebijakan diterapkan sebelum pemrosesan lainnya dilakukan. 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, posisikan kursor ke folder policies, lalu klik .

      

      Wizard Create policy 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 ditambahkan ke folder /policies untuk proxy API dan dibuka di editor.

   5. Klik XMLtoJSON.xml untuk mengedit kebijakan. Tetapkan elemen <OutputVariable> dan <Source> ke response, lalu simpan perubahan.
      Catatan: Anda akan melampirkan kebijakan ke alur respons di PreFlow proxy API pada 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, lalu klik default.xml untuk membuka file di editor.
   2. Tambahkan elemen <Step> yang mereferensikan kebijakan XMLtoJSON ke alur <Response> di proxy API <PreFlow>:

      <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. Simpan perubahan ke file.
3. Untuk men-deploy ulang lingkungan, posisikan kursor ke folder lingkungan dev, lalu klik .

   

4. Saat diminta untuk 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 0:8998/helloworld?apikey=ZQA5euYtNeJ7ZCGCJMpvd6F2BZOmxOzY

   Respons XML dikonversi ke JSON, sebagai berikut:

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

Selamat! Anda berhasil melampirkan 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