Framework Cloud Endpoints

Framework Cloud Endpoints adalah framework web untuk lingkungan runtime Python 2.7 dan Java 8 standar App Engine. Framework Cloud Endpoints menyediakan alat dan library yang memungkinkan Anda membuat REST API dan library klien untuk aplikasi Anda.

Seperti framework web lainnya, Framework Endpoint menangani detail komunikasi tingkat rendah dari permintaan dan respons HTTP untuk aplikasi Anda. Saat klien mengirim permintaan ke API Anda, Framework Endpoint merutekan URL permintaan ke fungsi atau metode dalam kode Anda yang memproses permintaan. Framework Endpoint mengonversi nilai yang ditampilkan ke JSON dan mengirim respons. Anda menambahkan metadata (dengan menggunakan anotasi di Java dan dekorator di Python) ke kode sumber. Metadata menentukan platform REST API untuk aplikasi Anda.

Java

@ApiMethod(name = "echo")
public Message echo(Message message, @Named("n") @Nullable Integer n) {
  return doEcho(message, n);
}

Dalam contoh kode, annotations dimulai dengan karakter @.

Python

@endpoints.method(
    # This method takes a ResourceContainer defined above.
    ECHO_RESOURCE,
    # This method returns an Echo message.
    EchoResponse,
    path="echo",
    http_method="POST",
    name="echo",
)
def echo(self, request):
    output_message = " ".join([request.message] * request.n)
    return EchoResponse(message=output_message)

Dalam contoh kode, dekorator dimulai dengan karakter @.

Dengan Endpoints Framework, Anda tidak perlu men-deploy server web pihak ketiga (seperti Apache Tomcat atau Gunicorn) dengan aplikasi Anda. Anda menganotasi atau mendekorasi kode dan men-deploy aplikasi seperti biasa ke lingkungan standar App Engine.

Pengelolaan API

Extensible Service Proxy (ESP) menyediakan fitur pengelolaan API untuk Endpoints for OpenAPI dan Endpoints for gRPC. ESP berjalan dalam penampung bersama setiap instance backend Anda.

Karena lingkungan standar App Engine tidak mendukung deployment multi-penampung saat Framework Endpoints sedang dalam pengembangan, Framework Endpoints tidak menggunakan ESP. Sebagai gantinya, Framework Endpoints menyertakan gateway API bawaan yang menyediakan fitur pengelolaan API yang sebanding dengan fitur yang disediakan ESP untuk Endpoints for OpenAPI dan Endpoints for gRPC.

Framework Endpoint mencegat semua permintaan dan melakukan pemeriksaan yang diperlukan (seperti autentikasi) sebelum meneruskan permintaan ke backend API. Saat backend merespons, Framework Endpoint mengumpulkan dan melaporkan telemetri. Anda dapat melihat metrik untuk API di halaman Endpoints Services di Konsol Google Cloud.

Anda dapat menggunakan Framework Endpoint dengan atau tanpa fungsi pengelolaan API. Penggunaan Framework Endpoints tanpa fungsi pengelolaan API ditawarkan tanpa biaya. Fungsi pengelolaan API dikenai biaya sesuai dengan halaman harga Endpoint.

Batasan

  • Framework Endpoints hanya didukung di lingkungan runtime Python 2.7 dan Java 8 standar App Engine.
  • Framework Endpoints tidak mendukung lingkungan runtime Node.js, PHP, dan Go di lingkungan standar App Engine.
  • Framework Endpoint tidak mendukung lingkungan fleksibel App Engine.
  • Framework Endpoints tidak mendukung fungsi Cloud Run, Compute Engine, dan Google Kubernetes Engine.

Langkah selanjutnya