Memvalidasi spesifikasi API

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Hub API menyediakan linter Spektral (validator) bawaan yang memvalidasi spesifikasi OpenAPI API Anda. Segera setelah Anda menambahkan spesifikasi OpenAPI ke versi API, validator (yang diaktifkan secara default) memvalidasi spesifikasi dan melaporkan temuan di Konsol Google Cloud.

Nonaktifkan validasi spesifikasi

Secara default, linter diaktifkan. Untuk menonaktifkan linter, di konsol Google Cloud, buka API hub > Pengaturan > Tindakan, lalu di bagian Linting, nonaktifkan opsi Linting.

Panduan gaya

Panduan gaya adalah seperangkat aturan yang digunakan hub API untuk memvalidasi spesifikasi OpenAPI. Hub API menggunakan panduan gaya default untuk memvalidasi spesifikasi OpenAPI. Sebagai aturan panduan gaya default, lihat Aturan OpenAPI.

Upload panduan gaya baru

Konsol

Untuk mengupload panduan gaya baru, lakukan langkah-langkah berikut:

  1. Buat gaya baru dengan memperluas panduan gaya default. Untuk selengkapnya informasinya, lihat Membuat kumpulan aturan.

  2. Di Konsol Google Cloud, buka API hub > Pengaturan > Tindakan.

  3. Di bagian Linting, klik Upload dokumen gaya baru. Tindakan ini akan menampilkan Panel Upload dokumen gaya baru.
  4. Upload dokumen gaya baru (yang dibuat di langkah 1), lalu klik Save.

REST API

Untuk mengupload panduan gaya baru untuk analisis lint, kirim permintaan PATCH ke API berikut:

https://apihub.googleapis.com/v1/projects/PROJECT/locations/LOCATION/plugins/standard-linter/styleGuide?update_mask=contents

Untuk informasi selengkapnya tentang API, lihat UpdateStyleGuide.

Contoh berikut menunjukkan panggilan API untuk mengupload panduan gaya.

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{"name":"projects/test-project-1/locations/us-central1/plugins/standard-linter/styleGuide",
"contents":{  "contents": "ZXh0ZW5kczogWyJzcGVjdHJhbDpvYXMiXQo=",
  "mimeType": "text/yaml"}}' \ 
-X PATCH \
https://apihub.googleapis.com/v1/projects/test-project-1/locations/us-central1/plugins/standard-linter/styleGuide?update_mask=contents

Download panduan gaya default

Untuk mendownload panduan gaya default yang digunakan oleh hub API untuk analisis lint, lakukan langkah-langkah berikut:

  1. Di Konsol Google Cloud, buka API hub > Pengaturan > Tindakan.

  2. Di bagian Linting, klik Download dokumen gaya asli. Ini mengunduh dokumen gaya {i> default<i} ke sistem lokal Anda.

Download panduan gaya terbaru

Konsol

Untuk mendownload panduan gaya yang saat ini digunakan oleh hub API untuk analisis lint, lakukan langkah-langkah berikut:

  1. Di Konsol Google Cloud, buka API hub > Pengaturan > Tindakan.

  2. Di bagian Linting, klik Download dokumen gaya terbaru. Ini mengunduh dokumen gaya {i> default<i} ke sistem lokal Anda.

REST API

Untuk mendownload panduan gaya yang saat ini digunakan oleh hub API untuk analisis lint, kirimkan permintaan GET ke API berikut:

https://apihub.googleapis.com/v1/projects/PROJECT/locations/LOCATION/plugins/standard-linter/styleGuide:contents

Untuk informasi selengkapnya tentang API, lihat GetStyleGuide.

Contoh berikut menunjukkan panggilan API untuk mendownload panduan gaya saat ini.

curl -X \
GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  https://apihub.googleapis.com/v1/projects/test-project-1/locations/us-central1/plugins/standard-linter/styleGuide:contents