Endpoints adalah sistem pengelolaan API terdistribusi. Cloud Endpoints menyediakan konsol API, hosting, logging, pemantauan, dan fitur lainnya untuk membantu Anda membuat, membagikan, memelihara, dan mengamankan API Anda. Halaman ini memberikan ringkasan tentang Cloud Endpoints untuk OpenAPI. Untuk informasi tentang jenis framework API lainnya 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 ke platform yang dijelaskan di bawah:
- Fleksibel App Engine (khusus ESP)
- Google Kubernetes Engine (ESP atau ESPv2)
- Compute Engine (ESP atau ESPv2)
- Kubernetes (ESP atau ESPv2)
- Standar App Engine (khusus ESPv2)
- Fungsi Cloud Run (khusus ESPv2)
- Cloud Run (khusus ESPv2)
- Inferensi Knative (khusus ESPv2)
Endpoint dengan ESP
Endpoints menggunakan Extensible Service Proxy (ESP) terdistribusi untuk memberikan latensi rendah dan performa tinggi untuk menayangkan API yang paling menuntut sekalipun. ESP adalah proxy layanan berdasarkan NGINX, sehingga Anda dapat yakin bahwa layanan ini disederhanakan sesuai kebutuhan untuk menangani permintaan serentak 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 skalabel berperforma tinggi berbasis Envoy yang berjalan di depan backend OpenAPI atau gRPC API. ESPv2 mendukung versi 2 dari Spesifikasi OpenAPI dan Spesifikasi gRPC. Anda dapat menggunakannya dengan:
- Lingkungan standar App Engine
- Compute Engine
- Google Kubernetes Engine
- Kubernetes
- Cloud Run
- Inferensi Knative
- Cloud Run Functions
Fitur pengelolaan Endpoints API
Baik Anda menggunakan Endpoints dengan ESP atau ESPv2, Endpoints menyediakan sejumlah fitur pengelolaan API yang signifikan untuk memungkinkan Anda mengembangkan, memantau, dan mengontrol akses ke API Anda.
Log dan metrik
Endpoint menggunakan Infrastruktur Layanan untuk mengelola API serta melaporkan log dan metrik. Sebagian besar Google Cloud API menggunakan infrastruktur yang sama ini. Anda dapat mengelola dan memantau API di halaman Endpoints Services di Konsol Google Cloud.
Hosting API
Endpoint dioptimalkan untuk lingkungan penampung Docker. Anda dapat menghosting API di mana saja Docker didukung selama memiliki akses internet ke Google Cloud.
Mengembangkan REST API dengan Endpoints for 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.
Untuk menggunakan Endpoints untuk OpenAPI, Anda harus:
Mengonfigurasi Endpoints: Anda mendeskripsikan platform API dan mengonfigurasi fitur Endpoints, seperti kunci API atau aturan autentikasi, dalam file konfigurasi OpenAPI.
Men-deploy konfigurasi Endpoints: Setelah menentukan API dalam file konfigurasi OpenAPI, Anda dapat menggunakan Google Cloud CLI untuk men-deploynya ke Pengelolaan Layanan, yang digunakan Endpoints untuk mengelola API Anda. Sekarang Endpoints mengetahui semua tentang API Anda dan cara mengamankannya.
Men-deploy Backend API: Anda men-deploy ESP atau ESPv2 dan backend API ke backend Google Cloud yang didukung, seperti Compute Engine. ESP berkoordinasi dengan layanan backend Endpoints untuk mengamankan dan memantau API Anda saat runtime.
Mengontrol akses API
Endpoint memungkinkan Anda mengonfigurasi API untuk mewajibkan kunci API untuk panggilan apa pun dan memvalidasi kunci API. Anda juga dapat menggunakan konsol Google Cloud untuk membagikan API kepada developer lain agar mereka dapat mengaktifkan API Anda dan membuat kunci API untuk memanggilnya.
Mengautentikasi pengguna API
Untuk sebagian besar panggilan API, ada pengguna di ujung lain setiap panggilan. Meskipun kunci API menunjukkan aplikasi mana yang melakukan panggilan ke API Anda, proses autentikasi akan menentukan pengguna mana yang menggunakan aplikasi tersebut.
Perhatikan bahwa server API Anda masih perlu memutuskan tindakan yang dapat dilakukan pengguna terautentikasi dengan API Anda. Untuk informasi selengkapnya, lihat panduan Autentikasi Google Cloud.
Langkah selanjutnya
Pelajari langkah-langkah deployment dan lihat cara kerja fitur Endpoint dengan melakukan Panduan memulai untuk Endpoint, yang menggunakan skrip untuk men-deploy API contoh ke backend fleksibel App Engine.
Pelajari lebih lanjut cara menggunakan Endpoint dengan mengikuti salah satu Tutorial.