Endpoints adalah sistem pengelolaan API terdistribusi. Layanan ini 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 mengetahui informasi tentang jenis framework API lainnya yang didukung oleh Endpoints, lihat Dokumen Semua 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:
- App Engine Flexible (khusus ESP)
- Google Kubernetes Engine (ESP atau ESPv2)
- Compute Engine (ESP atau ESPv2)
- Kubernetes (ESP atau ESPv2)
- App Engine standard (khusus ESPv2)
- Cloud Run Functions (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 dalam melayani API yang paling sulit sekalipun. ESP adalah proxy layanan berbasis NGINX, sehingga Anda dapat yakin bahwa ESP dapat diskalakan 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 berperforma tinggi dan skalabel berbasis Envoy yang berjalan di depan backend API OpenAPI atau gRPC. 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 API Endpoints
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
Endpoints menggunakan Service Infrastructure untuk mengelola API dan melaporkan log serta metrik. Sebagian besar Google Cloud API menggunakan infrastruktur yang sama ini. Anda dapat mengelola dan memantau API di halaman Endpoints Services di Google Cloud console.
Hosting API
Endpoints dioptimalkan untuk lingkungan container Docker. Anda dapat menghosting API di mana saja Docker didukung selama memiliki akses internet ke Google Cloud.
Mengembangkan REST API dengan Endpoints untuk OpenAPI
Endpoint tidak bergantung pada bahasa. Anda membangun API dalam bahasa dan framework REST apa pun yang mendukung deskripsi API menggunakan file konfigurasi OpenAPI.
Untuk menggunakan Endpoints for OpenAPI, Anda:
Mengonfigurasi Endpoint: Anda mendeskripsikan permukaan API dan mengonfigurasi fitur Endpoint, seperti kunci API atau aturan autentikasi, dalam file konfigurasi OpenAPI.
Deploy konfigurasi Endpoints: Setelah menentukan API dalam file konfigurasi OpenAPI, Anda menggunakan Google Cloud CLI untuk men-deploy-nya ke Service Management, yang digunakan Endpoints untuk mengelola API Anda. Sekarang Endpoints mengetahui semua hal tentang API Anda dan cara mengamankannya.
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
Endpoints memungkinkan Anda mengonfigurasi API agar memerlukan kunci API untuk setiap panggilan dan memvalidasi kunci API. Anda juga dapat menggunakan Google Cloud konsol 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 panggilan lainnya. Meskipun kunci API menunjukkan aplikasi mana yang melakukan panggilan ke API Anda, proses autentikasi 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 mengetahui informasi selengkapnya, lihat Panduan AuthGoogle Cloud .
Langkah berikutnya
Pahami langkah-langkah deployment dan lihat cara kerja fitur Endpoints dengan melakukan Panduan memulai Endpoints, yang menggunakan skrip untuk men-deploy contoh API ke backend fleksibel App Engine.
Pelajari lebih lanjut cara menggunakan Endpoint dengan mempelajari salah satu Tutorial.