Endpoint adalah sistem pengelolaan API terdistribusi. API ini menyediakan konsol API, hosting, logging, pemantauan, dan fitur lainnya untuk membantu Anda membuat, membagikan, memelihara, dan mengamankan API. Halaman ini menyediakan ringkasan tentang Cloud Endpoints untuk OpenAPI. Untuk mengetahui informasi tentang jenis framework API lain yang didukung oleh Endpoint, lihat Semua dokumen Endpoint.
Endpoints tersedia untuk digunakan dengan Extensible Service Proxy (ESP) terdistribusi atau Extensible Service Proxy V2 (ESPv2). Setiap proxy memberikan dukungan untuk platform yang dijelaskan di bawah ini:
- App Engine fleksibel (khusus ESP)
- Google Kubernetes Engine (ESP atau ESPv2)
- Compute Engine (ESP atau ESPv2)
- Kubernetes (ESP atau ESPv2)
- App Engine standar (khusus ESPv2)
- Cloud Functions (khusus ESPv2)
- Cloud Run (khusus ESPv2)
- Cloud Run for Anthos (khusus ESPv2)
Endpoint dengan ESP
Endpoint menggunakan Extensible Service Proxy (ESP) terdistribusi untuk memberikan latensi rendah dan performa tinggi untuk melayani API yang paling sulit sekalipun. ESP adalah proxy layanan berdasarkan NGINX, sehingga Anda dapat yakin bahwa proxy tersebut diskalakan sesuai kebutuhan untuk menangani permintaan simultan ke API Anda. ESP berjalan di container Docker-nya sendiri untuk isolasi dan skalabilitas yang lebih baik, serta didistribusikan di Container Registry. Anda dapat menggunakannya dengan:
Endpoint dengan ESPv2
ESPv2 adalah proxy berbasis Envoy berperforma tinggi dan skalabel yang berjalan di depan backend OpenAPI atau gRPC API. ESPv2 mendukung Spesifikasi OpenAPI dan Spesifikasi gRPC versi 2. Anda dapat menggunakannya dengan:
- Lingkungan standar App Engine
- Compute Engine
- Google Kubernetes Engine
- Kubernetes
- Cloud Run
- Cloud Run for Anthos
- Cloud Functions
Fitur pengelolaan Endpoints API
Baik Anda menggunakan Endpoint dengan ESP maupun ESPv2, fitur ini menyediakan sejumlah fitur pengelolaan API yang signifikan agar Anda dapat mengembangkan, memantau, dan mengontrol akses ke API Anda.
Log dan metrik
Endpoint menggunakan Infrastruktur Layanan untuk mengelola API serta metrik dan log laporan. Sebagian besar Google Cloud API menggunakan infrastruktur yang sama ini. Anda dapat mengelola dan memantau API di halaman Layanan Endpoint di Konsol Google Cloud.
Hosting API
Endpoint dioptimalkan untuk lingkungan container Docker. Anda dapat menghosting API di mana pun Docker didukung selama memiliki akses internet ke Google Cloud.
Mengembangkan REST API dengan Endpoint untuk OpenAPI
Endpoint tidak bergantung pada bahasa. Anda mem-build API dalam bahasa dan framework REST apa pun yang mendukung deskripsi API menggunakan file konfigurasi OpenAPI.
Agar dapat menggunakan Endpoint untuk OpenAPI, Anda:
Mengonfigurasi Endpoint: Anda menjelaskan platform API dan mengonfigurasi fitur Endpoint, seperti kunci API atau aturan autentikasi, dalam file konfigurasi OpenAPI.
Deploy konfigurasi Endpoint: Setelah menentukan API dalam file konfigurasi OpenAPI, gunakan Google Cloud CLI untuk men-deploy-nya ke Pengelolaan Layanan, yang digunakan Endpoint untuk mengelola API Anda. Sekarang Endpoints mengetahui semua hal tentang API Anda dan cara mengamankannya.
Deploy API Backend: Anda men-deploy ESP atau ESPv2 dan backend API ke backend Google Cloud yang didukung, seperti Compute Engine. ESP berkoordinasi dengan layanan backend Endpoint untuk mengamankan dan memantau API Anda saat runtime.
Mengontrol akses API
Dengan endpoint, Anda dapat mengonfigurasi API agar mewajibkan kunci API untuk panggilan apa pun dan memvalidasi kunci API. Anda juga dapat menggunakan Konsol Google Cloud untuk membagikan API Anda dengan developer lain sehingga mereka dapat mengaktifkan API Anda dan membuat kunci API untuk memanggilnya.
Mengautentikasi pengguna API
Untuk sebagian besar panggilan API, ada pengguna di ujung lain dari setiap panggilan. Meskipun kunci API menunjukkan aplikasi mana yang melakukan panggilan ke API Anda, proses autentikasi menentukan pengguna yang menggunakan aplikasi tersebut.
Perlu diperhatikan bahwa server API Anda masih perlu memutuskan tindakan yang dapat dilakukan pengguna terautentikasi dengan API Anda. Untuk mengetahui informasi selengkapnya, lihat panduan Google Cloud Auth.
Langkah selanjutnya
Pahami langkah-langkah deployment dan lihat cara kerja fitur Endpoint dengan melakukan Panduan Memulai untuk Endpoint, yang menggunakan skrip untuk men-deploy contoh API ke backend fleksibel App Engine.
Pelajari lebih lanjut cara menggunakan Endpoint dengan mempelajari salah satu Tutorial.