Langkah 4: Uji API Anda

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat 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 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 perlu 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.

Mem-build dan Mengekspor resource pengujian

  1. Buat paket pengujian:
    1. Arahkan kursor ke folder tests, lalu klik Membuat ikon paket pengujian.

      + ditampilkan saat Anda memosisikan kursor ke 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 untuk melihat kontennya.

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

  2. Konfigurasikan resource pengujian produk API:
    1. Arahkan kursor ke file products.json, lalu klik Membuat ikon produk API.

      + ditampilkan saat Anda memosisikan kursor ke produk.json

      Wizard Create API product akan terbuka.

      Halaman pertama wizard Buat produk 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 akan terbuka di editor dengan produk API baru yang dikonfigurasi:

      [
        {
          "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. Konfigurasikan resource pengujian developer:
    1. Arahkan kursor ke file developers.json, lalu klik Membuat ikon developer Apigee.

      + ditampilkan saat Anda memosisikan kursor ke developers.json

      Wizard Create developer akan terbuka.

      Halaman pertama wizard Buat produk API

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

      File developers.json akan terbuka di editor dengan developer baru yang dikonfigurasi:

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

      + ditampilkan saat Anda memosisikan kursor ke developerapps.json

      Wizard Create developer app akan terbuka.

      Halaman pertama wizard Buat produk API

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

      File developerapps.json akan terbuka di editor dengan aplikasi baru yang dikonfigurasi:

      [
        {
          "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 Apigee Emulator.

    Arahkan kursor ke paket pengujian mytestbundle, lalu klik Mengekspor ikon resource pengujian.

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

    Resource pengujian aktif muncul di bagian Apigee Emulators, seperti yang ditunjukkan pada gambar berikut.

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

Mendapatkan kunci API

Dapatkan kredensial kunci API untuk aplikasi developer Anda:

  1. Di bagian emulator, pada bagian Active test data, klik Active developer apps.

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

    <p><img src="/apigee/docs/api-platform/images/vscode-consumerkey.png" alt="Developer apps with the consumerKey value highlighted."></p>
    

  2. Salin nilai consumerKey (tanpa tanda petik) untuk produk myproduct API.

Menguji API

Uji API Anda dengan kunci API:

  1. Teruskan kunci API dalam panggilan curl Anda menggunakan parameter kueri apikey, sebagai berikut:
    curl 0:8998/helloworld?apikey=API_KEY

    Respons berikut akan 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 (BERIKUTNYA) Langkah 5: Ubah endpoint target 6 7 8