Halaman ini berlaku untuk Apigee dan Apigee hybrid.
Tentang spesifikasi API
Spesifikasi API menggunakan format standar untuk mendeskripsikan API. Dapat dibaca oleh mesin, tetapi juga mudah dibaca dan dipahami manusia. Spesifikasi biasanya menjelaskan elemen API seperti jalur dasar, jalur dan kata kerja, header, parameter kueri, operasi, jenis konten, deskripsi respons, dan sebagainya.
Versi API dapat berisi beberapa spesifikasi API dari jenis yang sama atau berbeda seperti OpenAPI Spec, Proto, dan WSDL. Jika didukung, hub API dapat mengurai spesifikasi API untuk mengekstrak dan menyimpan Metadata API, seperti ID API, ID versi, deskripsi, dan operasi. Lihat Penguraian spesifikasi.
Menggunakan spesifikasi API dengan hub API
Anda dapat membuat versi API di hub API dengan atau tanpa spesifikasi API.
Anda dapat mengupload spesifikasi saat Anda membuat versi. Ketika melihat detail API di antarmuka pengguna, Anda akan lihat daftar spesifikasi yang terkait dengan versi resource API.
Anda juga dapat membuat dan mengonfigurasi versi dengan spesifikasi menggunakan REST API. Kapan menggunakan API, membuat entity versi API dengan spesifikasi, lalu Anda dapat ke resource API.
Untuk mengetahui informasi selengkapnya, lihat Menambahkan spesifikasi ke versi.
Penguraian spesifikasi
Jika didukung, hub API dapat mengurai spesifikasi API untuk mengekstrak informasi tentang API dan menyimpannya dengan versi API. Misalnya, hub API dapat mengurai spesifikasi OpenAPI API untuk mengekstrak dan menyimpan ID API, ID versi, deskripsi, operasi, dan metadata lainnya.
Hub API juga mendukung validasi spesifikasi. Lihat Memvalidasi spesifikasi API.