Langkah 4: Uji API Anda

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Baca dokumentasi Apigee Edge.

Untuk menguji helloworld API yang di-deploy, klik tab Terminal di Apigee di Cloud Code dan masukkan panggilan curl berikut:

curl 0:8998/helloworld

Pesan error berikut akan ditampilkan:

Memanggil API di tab terminal dan mendapatkan error otorisasi

Karena Anda telah mengaktifkan autentikasi berbasis kunci API saat membuat proxy API, Anda harus meneruskan kunci API menggunakan parameter kueri apikey saat memanggil API.

Untuk mendapatkan kunci API, Anda harus membuat paket pengujian dan mengonfigurasi resource pengujian berikut:

  • Produk API yang digunakan untuk memaketkan API dan menyediakannya bagi developer

  • Developer yang akan membuat aplikasi untuk mengakses API

  • Aplikasi developer yang akan mengaktifkan akses ke API menggunakan kunci API

Build dan ekspor resource pengujian, dapatkan kunci API, dan uji ulang API Anda.

  1. Buat paket pengujian:
    1. Arahkan kursor ke folder tests di bagian Apigee, lalu klik Buat ikon.

      + ditampilkan saat Anda menempatkan kursor di atas folder pengujian

      Wizard Create test bundle akan terbuka.

    2. Masukkan mytestbundle untuk nama paket pengujian, lalu tekan Enter.

      Paket pengujian dibuat.

    3. Luaskan folder mytestbundle di bagian Apigee untuk melihat isinya.

      Folder pengujian dengan file developerapps.json, developers.json, maps.json, dan products.json

  2. Konfigurasi resource pengujian produk API:
    1. Arahkan kursor ke file products.json di bagian Apigee, lalu klik Buat ikon.

      + ditampilkan saat Anda menempatkan kursor di atas products.json

      Wizard produk Create API akan terbuka.

      Halaman pertama wizard produk Create API

    2. Masukkan myproduct untuk nama produk API, lalu tekan Enter untuk mengonfirmasi dan melanjutkan.
    3. Masukkan myproduct untuk deskripsi produk API, lalu tekan Enter untuk mengonfirmasi dan melanjutkan.
    4. Pilih helloworld untuk menambahkan proxy API ke produk API, lalu klik OK.

      File products.json dibuka di editor dengan produk API baru yang dikonfigurasi, seperti yang ditunjukkan di bawah:

      [
        {
          "attributes": [
            {
              "name": "sample_attribute_0",
              "value": "sample_attribute_value_0"
            }
          ],
          "scopes": [],
          "environments": [],
          "apiResources": [
            "/",
            "/*",
            "/**"
          ],
          "quota": "100",
          "quotaInterval": "1",
          "quotaTimeUnit": "minute",
          "name": "myproduct",
          "displayName": "myproduct",
          "proxies": [
            "helloworld"
          ]
        }
      ]
  3. Konfigurasi resource pengujian developer:
    1. Arahkan kursor ke file developers.json di bagian Apigee, lalu klik Buat ikon.

      + ditampilkan saat Anda menempatkan kursor di atas developers.json

      Wizard Buat developer akan terbuka.

      Halaman pertama wizard produk Create API

    2. Masukkan nilai berikut pada perintah, lalu tekan Enter untuk mengonfirmasi dan melanjutkan:
      • Email developer: ahamilton@example.com
      • Nama pengguna: ahamilton
      • Nama depan: Alex
      • Nama belakang: Hamilton

      File developers.json dibuka di editor dengan developer baru yang dikonfigurasi, seperti yang ditunjukkan di bawah:

      [
        {
          "attributes": [
            {
              "name": "sample_attribute_0",
              "value": "sample_attribute_value_0"
            }
          ],
          "email": "ahamilton@example.com",
          "userName": "ahamilton",
          "firstName": "Alex",
          "lastName": "Hamilton"
        }
      ]
  4. Konfigurasi referensi pengujian aplikasi developer:
    1. Arahkan kursor ke file developerapps.json di bagian Apigee, lalu klik Buat ikon.

      + ditampilkan saat Anda memosisikan kursor di atas developerapps.json

      Wizard Buat aplikasi developer akan terbuka.

      Halaman pertama wizard produk Create API

    2. Pilih ahamilton@example.com sebagai pemilik aplikasi.
    3. Masukkan nilai berikut pada rangkaian perintah berikutnya, lalu tekan Enter untuk mengonfirmasi dan melanjutkan:
      • Nama aplikasi: myapp
      • Deskripsi: myapp
      • URL callback: Biarkan kosong
    4. Pilih myproduct untuk menambahkannya ke aplikasi, lalu klik OK.
    5. Pilih never untuk nilai masa berlaku.

      File developerapps.json dibuka di editor dengan aplikasi baru yang dikonfigurasi, seperti yang ditunjukkan di bawah:

      [
        {
          "attributes": [
            {
              "name": "sample_attribute_0",
              "value": "sample_attribute_value_0"
            }
          ],
          "developerEmail": "ahamilton@example.com",
          "name": "myapp",
          "displayName": "myapp",
          "callbackUrl": "",
          "apiProducts": [
            "myproduct"
          ],
          "expiryType": "never"
        }
      ]
  5. Ekspor resource pengujian ke Emulator Apigee.

    Di bagian Apigee, posisikan kursor di atas paket pengujian mytestbundle dan klik Ikon ekspor pengujian.

    Referensi pengujian aktif, termasuk produk API, developer, dan aplikasi developer

    Resource pengujian aktif akan muncul di bagian Emulator Apigee, seperti yang ditampilkan dalam gambar berikut.

    Referensi pengujian aktif, termasuk produk API, developer, dan aplikasi developer

  6. Di bagian Emulator Apigee, di bagian Active test resources, klik Active developer apps.

    File konfigurasi aplikasi developer yang aktif dibuka di editor. File ini berisi kredensial untuk myproduct, seperti yang ditandai dalam gambar berikut.

    Aplikasi developer dengan nilai consumerKey yang ditandai.

  7. Salin nilai consumerKey (tanpa tanda kutip) untuk produk myproduct API.
  8. Teruskan kunci API dalam panggilan curl Anda menggunakan parameter kueri apikey, sebagai berikut:
    curl 0:8998/helloworld?apikey=ZQA5euYtNeJ7ZCGCJMpvd6F2BZOmxOzY

    Respons berikut ditampilkan:

    Hello, Guest!

Selamat! Anda telah berhasil menjalankan API di lingkungan lokal.

Pada langkah berikutnya, Anda akan mempelajari cara mengubah endpoint target.

1 2 3 4 (NEXT) Langkah 5: Ubah endpoint target