Membuat proxy API sederhana

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Catatan: Di lingkungan yang diaktifkan untuk deployment arsip, Anda tidak dapat membuat proxy API menggunakan Apigee UI, API, atau gcloud. Untuk membuat proxy API untuk deployment arsip menggunakan Apigee di VS Code,lihat Mengembangkan proxy API menggunakan Apigee di VS Code.

Dengan Apigee, Anda dapat dengan cepat mengekspos layanan backend sebagai API. Anda melakukannya dengan membuat proxy API yang menyediakan facade untuk layanan backend yang ingin Anda ekspos. Anda hanya perlu memberikan alamat jaringan untuk layanan backend, beserta beberapa informasi yang digunakan Apigee untuk membuat proxy API yang diekspos ke developer.

Proxy API memisahkan implementasi layanan backend Anda dari API yang digunakan developer. Hal ini melindungi developer dari perubahan mendatang pada layanan backend Anda. Saat Anda memperbarui layanan backend, developer yang terlindung dari perubahan tersebut dapat terus memanggil API tanpa terganggu.

Topik ini memberikan informasi tentang berbagai jenis proxy dan setelannya. Untuk mengetahui petunjuk langkah demi langkah tentang cara membuat proxy, lihat topik berikut:

• Tutorial: Membangun proxy API pertama Anda
• Membuat proxy API

Membuat proxy API menggunakan UI

Cara termudah untuk membuat proxy API adalah menggunakan wizard Create Proxy.

UI Apigee di Konsol Cloud

1. Di konsol Google Cloud , buka halaman Proxy development > API proxies.

   Buka proxy API

2. Klik + Create.

UI Klasik

Untuk mengakses wizard Create Proxy menggunakan UI Apigee, lakukan langkah-langkah berikut:

1. Login ke UI Apigee.
2. Di panel navigasi, pilih Develop > API Proxies.
3. Klik Buat Baru.
   

Wizard Create Proxy akan ditampilkan dan memandu Anda melalui langkah-langkah untuk membuat dan menambahkan fitur minimal ke proxy API.

Wizard ini memungkinkan Anda membuat proxy API dari sumber berikut:

Kategori	Jenis	Deskripsi
Template umum	Proxy terbalik (paling umum)	Proxy API yang merutekan permintaan masuk ke layanan backend HTTP yang ada. Dapat berupa JSON atau XML API. Lihat Membuat reverse proxy untuk layanan HTTP di bagian ini.
	Tidak ada target	Proxy API tanpa backend API ("tanpa target"). Mirip dengan Membuat proxy terbalik untuk layanan HTTP yang dijelaskan sebelumnya, kecuali Anda tidak akan menentukan API yang ada saat menentukan detail proxy API.
	Mengupload paket proxy	Paket proxy API yang ada (misalnya salah satu contoh proxy API yang tersedia di GitHub). Lihat Mengimpor proxy API dari paket proxy API.
	Proxy dengan Peristiwa yang Dikirim Server (SSE)	Proxy API yang mencakup EventFlow untuk streaming peristiwa yang dikirim server (SSE). Untuk mengetahui informasi selengkapnya, lihat Streaming peristiwa yang dikirim server.
Template AI	Batas Token Perintah	Mirip dengan pembatasan lonjakan, kebijakan ini membantu Anda mengontrol laju penggunaan token dari perintah pengguna untuk mencegah penyalahgunaan. Untuk mengetahui informasi selengkapnya, lihat Mulai menggunakan Kebijakan Token AI Apigee.
	Kuota Token LLM	Mengelola dan membatasi penggunaan token untuk panggilan LLM API. Untuk mengetahui informasi selengkapnya, lihat Mulai menggunakan Kebijakan Token AI Apigee.
	Proxy dengan Model Armor	Menerapkan interaksi AI yang aman dengan membersihkan perintah pengguna dan respons model. Untuk mengetahui informasi selengkapnya, lihat Mulai menggunakan kebijakan Apigee Model Armor.
	Proxy dengan Cache Semantik	Menyimpan respons ke permintaan serupa dalam cache, sehingga mengoptimalkan waktu respons dan panggilan LLM. Untuk mengetahui informasi selengkapnya, lihat Mulai menggunakan kebijakan caching semantik.
Template spesifikasi OpenAPI	Proxy terbalik (paling umum)	Buat proxy dari spesifikasi OpenAPI yang valid. Untuk mengetahui informasi selengkapnya tentang opsi ini, lihat Menggunakan Spesifikasi OpenAPI untuk membuat proxy di bagian ini.
	Tidak ada target	Proxy API tanpa backend API ("tanpa target"). Mirip dengan Membuat proxy terbalik untuk layanan HTTP yang dijelaskan sebelumnya, kecuali Anda tidak akan menentukan API yang ada saat menentukan detail proxy API.

Bagian berikut membahas detail setiap jenis proxy.

Membuat reverse proxy untuk layanan HTTP

Apigee menghasilkan proxy terbalik berdasarkan informasi berikut:

• URL layanan backend.
• Jalur URI yang secara unik mengidentifikasi API yang akan diekspos oleh proxy API ke aplikasi konsumen.

URL layanan backend biasanya merepresentasikan aplikasi yang mendukung layanan dan dimiliki oleh organisasi Anda. API ini juga dapat mengarah ke API yang tersedia untuk publik. API atau layanan dapat berada di bawah kontrol Anda (misalnya, aplikasi HR internal atau aplikasi Rails di Cloud) atau dapat berupa API atau layanan pihak ketiga (misalnya, Twitter atau Instagram).

Proxy details berikut tersedia setelah mengakses Create Proxy wizard dan memilih proxy type:

Kolom	Deskripsi
Nama	Nama yang ditampilkan untuk API Anda. Tentukan karakter alfanumerik, tanda hubung (-), atau garis bawah (_).
Base path	Fragmen URI yang muncul setelah alamat http://[host] atau https://[host] proxy API Anda. Apigee menggunakan URI jalur dasar untuk mencocokkan dan merutekan pesan permintaan masuk ke proxy API yang tepat. Catatan: Jalur dasar proxy API secara default adalah nilai yang ditentukan untuk kolom Name yang dikonversi menjadi huruf kecil semua. Setelah jalur dasar, ada URL resource tambahan. Struktur URL lengkap yang digunakan klien untuk memanggil proxy API Anda adalah sebagai berikut: https://[host]/BASE_PATH/CONDITIONAL_FLOW_PATH Catatan: Jalur dasar harus unik; Anda tidak dapat men-deploy dua proxy API dengan jalur dasar yang sama. Jika Anda mengedit proxy API yang di-deploy dan menetapkan jalur dasar ke nilai yang sama dengan jalur dasar proxy API lain, Apigee akan otomatis membatalkan deployment proxy API saat Anda menyimpannya. Sebelum dapat men-deploy ulang proxy API, Anda harus mengedit jalur dasar agar unik. Menggunakan karakter pengganti di jalur dasar Gunakan satu atau beberapa karakter pengganti /*/ di jalur dasar proxy API untuk memastikan proxy API Anda siap untuk masa mendatang. Misalnya, jalur dasar /team/*/members memungkinkan klien memanggil https://[host]/team/blue/members dan https://[host]/team/green/members tanpa Anda perlu membuat proxy API baru untuk mendukung tim baru. Perhatikan bahwa /**/ tidak didukung.
Deskripsi	(Opsional) Deskripsi API.
Target (Existing API)	URL layanan backend yang dipanggil oleh proxy API ini.

Mengimpor proxy API dari paket proxy API

Catatan: Saat mengimpor proxy API dari paket proxy API, Anda bertanggung jawab untuk mengonfigurasi keamanan dan menambahkan kebijakan ke paket. UI tidak meminta Anda untuk menambahkan keamanan atau kebijakan saat mengimpor paket, seperti yang dijelaskan di bagian Menambahkan keamanan nanti di bagian ini.

Anda sering kali menentukan proxy API sebagai kumpulan file XML, beserta file pendukung lainnya. Dengan menentukan proxy API sebagai sekumpulan file eksternal ke Apigee, Anda dapat memeliharanya dalam sistem kontrol sumber, lalu mengimpornya ke Apigee untuk pengujian dan deployment.

Untuk mengimpor proxy API dari paket proxy API, lakukan langkah-langkah berikut:

1. Akses wizard Create Proxy seperti yang dijelaskan dalam Membuat proxy API menggunakan UI.
2. Tentukan detail paket proxy API.

UI Apigee di Konsol Cloud

1. Di menu Proxy template, pilih Upload proxy bundle.
2. Di bagian Proxy details, masukkan Proxy name, upload file zip, lalu klik Next.
3. Di bagian Deploy, pilih lingkungan deployment, jika diinginkan, lalu klik Create.

UI Klasik

1. Klik Upload paket proxy.

2. Di halaman Upload proxy bundle di wizard proxy, masukkan informasi berikut:

   Kolom	Deskripsi
   Paket ZIP	File ZIP yang berisi konfigurasi proxy API. Tarik lalu lepas atau klik untuk membuka file.
   Nama	Nama yang ditampilkan untuk API Anda. Secara default, nama file ZIP tanpa ekstensi.

3. Klik Berikutnya.

4. Di halaman Summary, pilih lingkungan deployment, jika diinginkan, lalu klik Create and deploy.

   Konfirmasi ditampilkan untuk mengonfirmasi bahwa proxy API baru Anda berhasil dibuat.

5. Klik Edit proxy untuk menampilkan halaman detail proxy API.

Membuat proxy API gRPC

Selain proxy REST API, Apigee mendukung proxy gRPC API dengan dukungan passthrough saja saat ini. Dengan dukungan teruskan, payload gRPC itu sendiri tidak transparan bagi Apigee dan traffic dirutekan dari klien gRPC ke server target gRPC yang telah dikonfigurasi sebelumnya dalam konfigurasi target.

Saat ini, proxy API gRPC Apigee:

• Mendukung permintaan gRPC unary.
• Tidak dapat menggunakan kebijakan yang memengaruhi payload.
• Dapat digunakan dalam produk API yang tidak terkait dengan proxy GraphQL atau REST. Kuota khusus produk API dan setelan operasi lainnya berlaku di semua proxy dalam produk.
• Tidak didukung di Apigee hybrid.
• Gunakan dua variabel alur khusus gRPC: request.grpc.rpc.name dan request.grpc.service.name.
• Dapat dipantau dengan variabel Apigee Analytics khusus gRPC berikut: x_apigee_grpc_rpc_name, x_apigee_grpc_service_name, dan x_apigee_grpc_status.
• Menampilkan kode status gRPC.

Anda juga harus mengonfigurasi load balancer untuk mendukung gRPC. Lihat Menggunakan gRPC dengan aplikasi Anda dan Menggunakan perintah gcloud CLI untuk membuat perutean untuk gRPC.

Untuk membuat proxy API gRPC, pertama-tama tentukan server target gRPC (lihat Membuat TargetServer) lalu tentukan server target tersebut saat membuat proxy baru.

Catatan: Konfigurasi proxy gRPC melalui UI Apigee hanya didukung melalui UI Apigee di Konsol Cloud, bukan konsol Apigee lainnya.

Menggunakan perintah gcloud CLI untuk membuat perutean untuk gRPC

Bagian ini menunjukkan contoh perintah untuk membuat perutean bagi proxy gRPC, menggunakan gcloud CLI. Petunjuk ini mencakup penyiapan load balancer, server target, dan MIG.

Bagian ini bukan panduan komprehensif untuk membuat perutean. Contoh ini mungkin tidak sesuai untuk semua kasus penggunaan. Selain itu, petunjuk ini mengasumsikan pemahaman tentang Perutean eksternal (MIG) dan Konfigurasi gRPC load balancer Cloud.

Menetapkan variabel lingkungan

Variabel lingkungan ini digunakan dalam perintah di subbagian.

PROJECT_ID=YOUR_PROJECT_ID
MIG_NAME=YOUR_MIG_NAME
VPC_NAME=default
VPC_SUBNET=default
REGION=REGION_NAME
APIGEE_ENDPOINT=ENDPOINT
CERTIFICATE_NAME=CERTIFICATE_NAME
DOMAIN_HOSTNAME=DOMAIN_HOSTNAME

Contoh perintah gcloud CLI untuk membuat perutean bagi proxy gRPC menggunakan load balancer baru

Bagian ini menunjukkan contoh perintah untuk membuat proxy gRPC menggunakan gcloud CLI dan load balancer baru. Petunjuk mencakup penyiapan load balancer, server target, dan MIG.

Buat template instance

gcloud compute instance-templates create $MIG_NAME \
--project $PROJECT_ID \
--region $REGION \
--network $VPC_NAME \
--subnet $VPC_SUBNET \
--tags=https-server,apigee-mig-proxy,gke-apigee-proxy \
--machine-type e2-medium --image-family debian-12 \
--image-project debian-cloud --boot-disk-size 20GB \
--no-address \
--metadata ENDPOINT=$APIGEE_ENDPOINT,startup-script-url=gs://apigee-5g-saas/apigee-envoy-proxy-release/latest/conf/startup-script.sh

Buat grup instance terkelola

gcloud compute instance-groups managed create $MIG_NAME \
--project $PROJECT_ID --base-instance-name apigee-mig \
--size 2 --template $MIG_NAME --region $REGION

Mengonfigurasi penskalaan otomatis

gcloud compute instance-groups managed set-autoscaling $MIG_NAME \
--project $PROJECT_ID --region $REGION --max-num-replicas 50 \
--target-cpu-utilization 0.75 --cool-down-period 90

Menentukan port bernama

gcloud compute instance-groups managed set-named-ports $MIG_NAME \
--project $PROJECT_ID --region $REGION --named-ports https:443

Buat sertifikat dan kunci SSL yang dikelola Google untuk load balancer

gcloud compute ssl-certificates create $CERTIFICATE_NAME \
--domains=$DOMAIN_HOSTNAME \
--project $PROJECT_ID \
--global

Memvalidasi bahwa sertifikat telah disediakan

gcloud compute ssl-certificates describe $CERTIFICATE_NAME \
--global \
--format="get(name,managed.status, managed.Status)"

Buat Global Cloud Load Balancer (GCLB)

1. Buat health check
   

   gcloud compute health-checks create https hc-apigee-envoy-443 \
   --project $PROJECT_ID --port 443 --global \
   --request-path /healthz/ingress

2. Buat layanan backend untuk http1
   

   gcloud compute backend-services create YOUR_BACKEND_1 \
   --project $PROJECT_ID \
   --protocol HTTPS \
   --health-checks hc-apigee-envoy-443 \
   --port-name https \
   --timeout 302s \
   --connection-draining-timeout 300s \
   --global

3. Buat layanan backend untuk http2
   

   gcloud compute backend-services create YOUR_BACKEND_2 \
   --project $PROJECT_ID \
   --protocol HTTP2 \
   --health-checks hc-apigee-envoy-443 \
   --port-name https \
   --timeout 302s \
   --connection-draining-timeout 300s \
   --global

4. Tambahkan MIG ke layanan backend. Dalam contoh ini, kita menggunakan kembali MIG, tetapi Anda juga dapat membuat pasangan MIG baru.
   

   gcloud compute backend-services add-backend YOUR_BACKEND_1 \
   --project $PROJECT_ID --instance-group $MIG_NAME \
   --instance-group-region $REGION \
   --balancing-mode UTILIZATION --max-utilization 0.8 --global

   gcloud compute backend-services add-backend YOUR_BACKEND_2 \
   --project $PROJECT_ID --instance-group $MIG_NAME \
   --instance-group-region $REGION \
   --balancing-mode UTILIZATION --max-utilization 0.8 --global

5. Buat peta URL load balancing. Periksa terlebih dahulu apakah Anda sudah memiliki peta URL. Jika Anda melakukannya, pastikan untuk mengubah peta tersebut sesuai dengan persyaratan di bawah, bukan menimpanya.
   

   Buat file YAML atau gunakan file yang sudah ada, di /tmp/apigee-map.yaml, dengan konfigurasi ini. Perhatikan bahwa backend http1 peta URL adalah default.

   defaultService: projects/$PROJECT_ID/global/backendServices/YOUR_BACKEND_1
   name: matcher1
   routeRules:
   - matchRules:
   - headerMatches:
   - headerName: Content-Type
   prefixMatch: application/grpc
   prefixMatch: /
   priority: 100
   routeAction:
   weightedBackendServices:
   - backendService: projects/$PROJECT_ID/global/backendServices/YOUR_BACKEND_2
   weight: 100

   Validasi peta URL:

   gcloud compute url-maps validate --source /tmp/apigee-map.yaml --project $PROJECT_ID

   Buat peta URL dengan perutean berbasis header:

   gcloud compute url-maps import apigee-http1-http2 \
   --source /tmp/apigee-map.yaml  \
   --global --project $PROJECT_ID

Buat proxy HTTPS target load balancing

gcloud compute target-https-proxies create apigee-envoy-https-proxy \
--project $PROJECT_ID --url-map apigee-envoy-proxy-map \
--ssl-certificates $CERTIFICATE_NAME

Cadangkan IP Eksternal IPV4 dan buat aturan firewall untuk load balancer

gcloud compute addresses create lb-ipv4-vip-1 \
--project $PROJECT_ID \
--network-tier=PREMIUM \
--ip-version=IPV4 \
--global

  gcloud compute addresses describe lb-ipv4-vip-1 \
--project $PROJECT_ID --format="get(address)" --global

  gcloud compute forwarding-rules create apigee-envoy-https-lb-rule \
--project $PROJECT_ID --address lb-ipv4-vip-1 --global \
--target-https-proxy apigee-envoy-https-proxy --ports 443

Membuat aturan firewall

gcloud compute firewall-rules create k8s-allow-lb-to-apigee-envoy \
--description "Allow incoming from GLB on TCP port 443 to Apigee Proxy" \
--project $PROJECT_ID --network $VPC_NAME --allow=tcp:443 \
--source-ranges=130.211.0.0/22,35.191.0.0/16 --target-tags=gke-apigee-proxy

Contoh perintah gcloud CLI untuk membuat perutean untuk proxy gRPC bagi load balancer yang ada

Bagian ini menunjukkan contoh perintah untuk membuat proxy gRPC menggunakan gcloud CLI dan load balancer yang ada. Petunjuk mencakup penyiapan load balancer, server target, dan MIG.

Buat layanan backend lain untuk http2

# Create backend service for http2
    gcloud compute backend-services create YOUR_BACKEND_2 \
--project $PROJECT_ID \
--protocol HTTP2 \
--health-checks hc-apigee-envoy-443 \
--port-name https \
--timeout 302s \
--connection-draining-timeout 300s \
--global

Lampirkan layanan backend kedua ke MIG

gcloud compute backend-services add-backend YOUR_BACKEND_2 \
--project $PROJECT_ID --instance-group $MIG_NAME \
--instance-group-region $REGION \
--balancing-mode UTILIZATION --max-utilization 0.8 --global

Mencantumkan peta URL untuk GCLB Apigee yang ada

gcloud compute url-maps list -project $PROJECT_ID

Mengambil nama peta URL yang benar yang digunakan untuk load balancing Apigee

gcloud compute url-maps export APIGEE_URL_MAP_NAME -project $PROJECT_ID

Buat file YAML peta URL load balancing

Jika Anda sudah memiliki peta URL, gabungkan konfigurasi ini ke peta URL tersebut. Jika tidak, buat file YAML di /tmp/apigee-map.yaml dengan konfigurasi ini.

defaultService: projects/dg-runtime-test1/global/backendServices/YOUR_BACKEND_1
name: matcher1
routeRules:
- matchRules:
- headerMatches:
- headerName: Content-Type
prefixMatch: application/grpc
prefixMatch: /
priority: 100
routeAction:
weightedBackendServices:
- backendService: projects/dg-runtime-test1/global/backendServices/YOUR_BACKEND_2
weight: 100

Terapkan YAML baru untuk perutean gRPC

gcloud compute url-maps import APIGEE_URL_MAP_NAME\
--source /tmp/apigee-map.yaml  \
--global -project $PROJECT_ID

Menambahkan keamanan

Keamanan proxy dicapai dengan menambahkan kebijakan ke proxy Anda. Untuk mengetahui informasi selengkapnya tentang kebijakan, lihat Apa itu kebijakan. Untuk mengetahui informasi selengkapnya tentang keamanan, lihat Mengamankan proxy.

Untuk menambahkan kebijakan keamanan ke proxy Anda:

Apigee di Konsol Cloud

1. Buat proxy seperti yang dijelaskan dalam Membuat proxy API.
2. Tambahkan kebijakan keamanan seperti yang dijelaskan di salah satu bagian yang tercantum dalam Mengamankan proxy. Kebijakan keamanan yang paling umum digunakan adalah kunci API dan OAuth2.

UI Apigee Klasik

Di halaman Kebijakan umum di wizard Buat Proxy, pilih jenis otorisasi keamanan yang ingin Anda tambahkan. Tabel berikut merangkum opsi yang tersedia:

Otorisasi keamanan	Deskripsi
Kunci API	Menambahkan verifikasi kunci API sederhana ke proxy API yang Anda tentukan. Sebagai respons, Platform API akan menambahkan kebijakan VerifyAPIKey dan kebijakan AssignMessage ke proxy API Anda. Kebijakan VerifyAPIKey memvalidasi kunci API yang diberikan oleh aplikasi yang meminta. Kebijakan AssignMessage menghapus kunci API, yang diberikan dalam panggilan API sebagai parameter kueri, dari permintaan yang diteruskan ke server backend.
OAuth 2.0	Menambahkan autentikasi berbasis OAuth 2.0 ke proxy API Anda. Apigee otomatis menambahkan kebijakan berikut ke proxy API Anda: satu kebijakan untuk memverifikasi token akses dan kebijakan lainnya untuk menghapus token akses dari pesan sebelum meneruskannya ke layanan backend Anda. Untuk mempelajari cara mendapatkan token akses, lihat OAuth.
Teruskan (tanpa otorisasi)	Tidak memerlukan otorisasi. Permintaan diteruskan ke backend tanpa pemeriksaan keamanan apa pun di Apigee.

Menambahkan dukungan untuk CORS

Cross-origin resource sharing (CORS) adalah mekanisme standar yang memungkinkan browser web membuat permintaan langsung ke domain lain. Standar CORS menentukan serangkaian header HTTP yang digunakan browser dan server web untuk mengimplementasikan komunikasi lintas domain.

Anda dapat menambahkan dukungan untuk CORS dengan menambahkan kebijakan CORS ke PreFlow permintaan ProxyEndpoint.

Untuk mengetahui informasi lebih mendetail tentang dukungan CORS, termasuk menambahkan dukungan pra-penerbangan CORS ke proxy, lihat Menambahkan dukungan CORS ke proxy API.

Menambahkan Kuota

Kuota melindungi layanan backend Anda dari traffic tinggi di bagian Quota. Lihat Kuota. (Tidak tersedia jika Otorisasi teruskan dipilih.)

Menggunakan Spesifikasi OpenAPI untuk membuat proxy

Bagian ini membahas opsi Gunakan OpenAPI yang tersedia untuk membuat jenis proxy API berikut dari Spesifikasi OpenAPI: reverse atau tanpa target.

Apa itu Spesifikasi OpenAPI?

   "Open API Initiative (OAI) berfokus pada pembuatan, pengembangan, dan promosi format deskripsi API yang netral vendor berdasarkan Spesifikasi Swagger." Untuk mengetahui informasi selengkapnya, lihat OpenAPI Initiative.

Spesifikasi OpenAPI menggunakan format standar untuk mendeskripsikan RESTful API. Ditulis dalam format JSON atau YAML, Spesifikasi OpenAPI dapat dibaca mesin, tetapi juga mudah dibaca dan dipahami oleh manusia. Spesifikasi ini menjelaskan elemen API seperti jalur dasarnya, jalur dan kata kerja, header, parameter kueri, operasi, jenis konten, deskripsi respons, dan lainnya. Selain itu, Spesifikasi OpenAPI biasanya digunakan untuk membuat dokumentasi API.

Fragmen berikut dari Spesifikasi OpenAPI menjelaskan layanan target tiruan Apigee, http://mocktarget.apigee.net. Untuk informasi selengkapnya, lihat Spesifikasi OpenAPI untuk contoh helloworld.

openapi: 3.0.0
info:
  description: OpenAPI Specification for the Apigee mock target service endpoint.
  version: 1.0.0
  title: Mock Target API
paths:
  /:
    get:
      summary: View personalized greeting
      operationId: View a personalized greeting
      description: View a personalized greeting for the specified or guest user.
      parameters:
        - name: user
          in: query
          description: Your user name.
          required: false
          schema:
            type: string
      responses:
        "200":
          description: Success
  /help:
    get:
      summary: Get help
      operationId: Get help
      description: View help information about available resources in HTML format.
      responses:
        "200":
          description: Success
...

Melalui wizard Create Proxy, Anda dapat mengimpor Spesifikasi OpenAPI dan menggunakannya untuk membuat proxy API. Setelah proxy dibuat, Anda dapat menggunakan UI Apigee untuk mengembangkannya lebih lanjut dengan menambahkan kebijakan, menerapkan kode kustom, dan sebagainya&emdash;seperti proxy Apigee lainnya.

Membuat proxy API dari Spesifikasi OpenAPI

Buat proxy API dari Spesifikasi OpenAPI. Hanya dengan beberapa klik, Anda akan memiliki proxy API dengan jalur, parameter, alur bersyarat, dan endpoint target yang dibuat secara otomatis. Kemudian, Anda dapat menambahkan fitur seperti keamanan OAuth, pembatasan kapasitas, dan caching.

Di wizard Create Proxy, klik Use OpenAPI Spec dan ikuti wizard untuk membuat proxy tanpa target atau reverse dari Spesifikasi OpenAPI. Untuk mengetahui detailnya, lihat Membuat proxy API dari Spesifikasi OpenAPI.

Membuat revisi baru proxy API

Untuk membuat revisi baru proxy API, lakukan langkah-langkah berikut:

1. Buka UI Apigee.

Apigee di Konsol Cloud

Di konsol Google Cloud , buka halaman Proxy development > API proxies.

Buka proxy API

UI Apigee Klasik

1. Login ke UI Apigee.
2. Di panel navigasi, pilih Develop > API Proxies.
2. Klik proxy API dalam daftar yang ingin Anda salin.

3. Klik tab Develop.

4. Pilih tombol Simpan, lalu pilih Simpan sebagai Revisi Baru.

Mencadangkan proxy API

Anda dapat mencadangkan proxy API yang ada sebagai sekumpulan file XML dalam paket proxy API. Setelah diekspor ke dalam bundle, Anda dapat mengimpor proxy API ke proxy baru, seperti yang dijelaskan di Mengimpor proxy API dari bundle proxy API sebelumnya di bagian ini. Untuk mengetahui informasi selengkapnya, lihat Mendownload proxy API.

Membuat proxy API menggunakan API

Untuk membuat proxy API menggunakan API, lihat Membuat proxy API.

Tentang tidak ada proxy target

Tidak ada proxy target di Apigee yang berguna saat Anda ingin memproses permintaan dalam Apigee itu sendiri tanpa meneruskannya ke layanan backend. Penting untuk memahami kapan pendekatan ini tepat.

Kasus penggunaan umum

• Berinteraksi dengan data yang dikelola Apigee: Proxy tanpa target berguna jika Anda hanya perlu berinteraksi dengan data yang dikelola Apigee, seperti data yang disimpan dalam peta nilai kunci (KVM) atau cache Apigee. Misalnya, Anda dapat menggunakan proxy tanpa target untuk mengambil data, seperti data sesi pengguna atau data konfigurasi, dari KVM. Dalam hal ini, tidak perlu memanggil layanan backend. Yang diperlukan hanyalah kebijakan KeyValueMapOperations dalam alur proxy. Contoh lainnya, Anda mungkin ingin penelepon meminta agar cache dikosongkan. Anda dapat melakukannya dengan memanggil kebijakan InvalidateCache, tanpa perlu terhubung ke target.
• Menggunakan API tiruan: Anda dapat membuat API tiruan untuk menyimulasikan perilaku API sebelum implementasi backend selesai agar pengembangan frontend dapat berjalan secara independen. Untuk mempelajari lebih lanjut cara membuat API tiruan, lihat Proxy API Tiruan OpenAPI.
• Pengelolaan token: Apigee dapat mengeluarkan token OAuthV2, dan hal ini biasanya dilakukan melalui proxy tanpa target.
• Menguji perilaku kebijakan: Proxy tanpa target dapat berguna saat Anda ingin mencoba kebijakan Apigee untuk menguji perilakunya.