Halaman ini berlaku untuk Apigee dan Apigee hybrid.
Lihat Dokumentasi Apigee Edge.
Sebelum menguji API, Anda mungkin perlu membangun sekumpulan resource pengujian, seperti produk, developer, atau aplikasi API, yang mewakili resource yang sama, yang mungkin ada di lingkungan produksi di organisasi Apigee Anda.
Bangun dan ekspor resource pengujian seperti yang dijelaskan di bagian berikut. Lihat juga Mengelola folder dan file di ruang kerja Apigee.
Membuat resource pengujian
Untuk membuat resource pengujian, buat paket pengujian dan edit resource pengujian yang ditentukan dalam tabel berikut.
Resource pengujian | Deskripsi |
---|---|
Produk API (products.json ) |
Tentukan produk API yang digunakan untuk memaketkan API dan sediakan bagi developer. |
Developer (developers.json ) |
Daftarkan developer yang akan mengakses API Anda. |
Aplikasi developer (developerapps.json ) |
Daftarkan aplikasi untuk mengontrol akses ke API Anda. |
Peta nilai kunci (maps.json ) |
Tentukan peta nilai kunci (KVM) yang digunakan oleh API Anda untuk menyimpan data yang akan diambil saat runtime. |
Membuat paket pengujian
Untuk membuat paket pengujian di Cloud Code:
Lakukan salah satu tindakan berikut:
Posisikan kursor ke folder tests di bagian Apigee, lalu klik .
Pilih Lihat > Command Palette untuk membuka palet Command, lalu pilih Cloud Code: Create Apigee test bundle.
Masukkan nama unik untuk paket pengujian dan tekan Enter.
Paket pengujian ditambahkan ke folder tests di bagian Apigee.
Konfigurasi resource pengujian, seperti yang dijelaskan di bagian berikut.
Menentukan produk API (products.json)
Tentukan produk API yang digunakan untuk memaketkan API dan sediakan bagi developer. Untuk informasi selengkapnya tentang produk API, lihat Apa yang dimaksud dengan produk API?
Untuk menentukan produk API, perbarui file products.json
menggunakan wizard konfigurasi (dijelaskan di bawah) atau dengan mengedit file konfigurasi product.json
secara langsung. Untuk deskripsi kolom dalam file products.json
, lihat Resource: ApiProduct.
Untuk menentukan produk API menggunakan wizard konfigurasi:
Posisikan kursor ke file products.json untuk paket pengujian, lalu klik . Wizard produk Create API akan terbuka.
Telusuri wizard konfigurasi untuk mengisi kolom secara otomatis dalam file
products.json
.
Fileproducts.json
dibuka di editor.Edit informasi konfigurasi, sesuai yang diperlukan.
Pilih File > Simpan atau ⌘S untuk menyimpan hasil edit.
Contoh berikut menentukan produk myapiproduct
API yang berisi proxy API helloworld
.
[ { "apiResources": [ "/", "/*", "/**" ], "quota": "100", "quotaInterval": "1", "quotaTimeUnit": "minute", "name": "myapiproduct", "displayName": "My first API product", "proxies": [ "helloworld" ] } ]
Mendaftarkan developer (developers.json)
Daftarkan developer yang akan mengakses API Anda. Untuk informasi selengkapnya tentang developer, lihat Mendaftarkan developer aplikasi.
Untuk mendaftarkan developer, perbarui file developers.json
menggunakan wizard konfigurasi (dijelaskan di bawah) atau dengan mengedit file konfigurasi developers.json
secara langsung. Untuk deskripsi kolom dalam file products.json
, lihat Resource: Developer.
Untuk mendaftarkan developer menggunakan wizard konfigurasi:
- Posisikan kursor ke file developers.json untuk paket pengujian, lalu klik .
- Melewati wizard konfigurasi untuk mengisi kolom secara otomatis dalam file
developers.json
.
Filedevelopers.json
dibuka di editor. - Edit konfigurasi sesuai yang diperlukan.
- Pilih File > Simpan atau ⌘S untuk menyimpan hasil edit.
Contoh berikut menentukan ahamilton@example.com
developer:
[ { "email": "ahamilton@example.com", "userName": "ahamilton", "firstName": "Alex", "lastName": "Hamilton" } ]
Mendaftarkan aplikasi developer (developerapps.json)
Daftarkan aplikasi developer untuk mengontrol akses ke API Anda. Untuk informasi selengkapnya tentang mendaftarkan aplikasi developer, lihat Mengontrol akses ke API dengan mendaftarkan aplikasi.
Untuk mendaftarkan aplikasi developer, perbarui file developerapps.json
menggunakan wizard konfigurasi (dijelaskan di bawah) atau dengan mengedit file konfigurasi developerapps.json
secara langsung. Untuk deskripsi kolom dalam file developerapps.json
, lihat Resource: DeveloperApp.
Untuk mendaftarkan aplikasi developer menggunakan wizard konfigurasi:
- Posisikan kursor ke file developerapps.json untuk paket pengujian, lalu klik .
Telusuri wizard konfigurasi untuk mengisi kolom secara otomatis dalam file
developerapps.json
.
Filedeveloperapps.json
dibuka di editor.Edit konfigurasi sesuai yang diperlukan.
Pilih File > Simpan atau ⌘S untuk menyimpan hasil edit.
Contoh berikut mendaftarkan aplikasi developer myapp
untuk ahamilton@example.com
dan mengaitkan myproduct
:
[ { "attributes": [ { "name": "sample_attribute_0", "value": "sample_attribute_value_0" } ], "developerEmail": "ahamilton@example.com", "name": "myapp", "callbackUrl": "", "keyExpiresIn": "never", "apiProducts": [ "myproduct" ] } ]
Menentukan peta nilai kunci (maps.json)
Tentukan peta nilai kunci (KVM) yang digunakan oleh API Anda untuk menyimpan data yang akan diambil saat runtime. Untuk mengetahui informasi selengkapnya tentang KVM, lihat Menggunakan peta nilai kunci.
Untuk menentukan peta nilai kunci, perbarui file maps.json
menggunakan wizard konfigurasi (dijelaskan di bawah) atau dengan mengedit file konfigurasi maps.json
secara langsung. Untuk deskripsi kolom dalam file maps.json
, lihat resource KeyValueMap.
Untuk mendaftarkan aplikasi developer menggunakan wizard konfigurasi:
Akun Layanan 1. Posisikan kursor ke file maps.json untuk paket pengujian, lalu klik .
2. Telusuri wizard konfigurasi untuk mengisi kolom secara otomatis dalam file maps.json
.
File maps.json
dibuka di editor.
3. Edit konfigurasi sesuai yang diperlukan.
4. Pilih File > Simpan atau ⌘S untuk menyimpan hasil edit.
Contoh berikut menentukan KVM terenkripsi mykvm
:
[ { "name": "mykvm", "encrypted": true } ]
Mengekspor resource pengujian ke Emulator Apigee
Untuk mengekspor resource pengujian ke Emulator Apigee:
- Posisikan kursor ke paket pengujian yang ingin diekspor, lalu klik .
- Jika beberapa penampung untuk Emulator Apigee berjalan, pilih container tempat Anda ingin men-deploy lingkungan.
Resource pengujian aktif muncul di Emulator Apigee, seperti yang ditunjukkan pada gambar berikut.
Lihat konten resource pengujian untuk mendapatkan informasi resource tertentu, seperti kunci API untuk pengujian yang dibuat secara otomatis dan disertakan dalam resource pengujian aplikasi developer.
Langkah berikutnya
Sekarang saatnya melakukan deployment ke lingkungan.