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, mengizinkan pengguna, memeriksa konten pesan untuk mendeteksi potensi ancaman, dan melakukan banyak hal lainnya. Untuk mengetahui informasi selengkapnya, lihat Apa itu 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 melampirkannya 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. Perluas paket proxy API helloworld, arahkan kursor ke folder policies, lalu klik Buat ikon untuk kebijakan baru.

      File endpoint target default.xml

      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 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 Anda.
      <?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. Perluas 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 <PreFlow> proxy API:
      <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 pada file.
  3. Untuk men-deploy ulang lingkungan, arahkan kursor ke folder lingkungan dev, lalu klik Ikon deployment untuk lingkungan.

    Ikon deploy ditampilkan saat Anda memosisikan kursor di atas folder lingkungan dev

  4. Saat diminta untuk memilih paket pengujian yang akan diekspor, klik Deploy tanpa paket pengujian karena paket pengujian telah diekspor.

    Perintah untuk mengekspor paket pengujian

  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 telah 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: Deploy ke lingkungan Apigee 8