Lihat konektor yang didukung untuk Application Integration.

Pemicu API

Pemicu API digunakan untuk langsung memanggil eksekusi untuk integrasi. Pemicu API dapat digunakan dalam mode sinkron atau asinkron.

Anda dapat menetapkan payload permintaan dan respons untuk pemicu API dengan membuat variabel dalam integrasi. Untuk informasi tentang cara membuat integrasi dengan pemicu API yang menerima permintaan API untuk mengambil informasi pelanggan, lihat tutorial Pemenuhan API.

Menambahkan pemicu API

Untuk menambahkan pemicu pemicu API, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Application Integration.

   Buka Application Integration

2. Di menu navigasi, klik Integrasi

   Halaman Integrations List akan muncul dan mencantumkan semua integrasi yang tersedia di project Google Cloud.

3. Pilih integrasi yang ada atau klik Buat integrasi untuk membuat integrasi baru.

   Jika Anda membuat integrasi baru:

   1. Masukkan nama dan deskripsi di panel Create Integration.
   2. Pilih region untuk integrasi.
      Catatan: Dropdown Regions hanya mencantumkan region yang disediakan di project Google Cloud Anda. Untuk menyediakan wilayah baru, klik Aktifkan Wilayah. Lihat Mengaktifkan wilayah baru untuk informasi selengkapnya.
   3. Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Integration summary di toolbar integrasi.
      Catatan: Opsi untuk memilih akun layanan hanya ditampilkan jika Anda telah mengaktifkan tata kelola integrasi untuk wilayah yang dipilih.
   4. Klik Create.

   Tindakan ini akan membuka integrasi di editor integrasi.

4. Di menu navigasi editor integrasi, klik Pemicu untuk melihat daftar pemicu yang tersedia.
5. Klik dan tempatkan elemen pemicu API ke desainer.

Mengonfigurasi pemicu API

Klik elemen API trigger di editor integrasi untuk melihat panel konfigurasi pemicu.

Panel konfigurasi menampilkan ID Pemicu, yang merupakan ID buatan mesin dalam format api_trigger/TRIGGER_NAME. Tidak diperlukan konfigurasi lebih lanjut untuk pemicu ini.

Catatan: Anda dapat memiliki lebih dari satu pemicu API dalam integrasi. Setiap pemicu API diberi ID Pemicu unik.

Memanggil pemicu API dari aplikasi

Setelah memublikasikan integrasi yang memiliki pemicu API yang dikonfigurasi, Anda dapat menggunakan metode projects.locations.integrations.execute untuk memanggil pemicu tersebut dari aplikasi apa pun. Metode ini memicu eksekusi dalam mode sinkron.

Sintaksis

curl -X POST \
    -H "authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{"trigger_id":"api_trigger/TRIGGER_NAME"}' \
    "https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-:execute"

Ganti kode berikut:

• TRIGGER_NAME: Nama pemicu API dalam integrasi Anda.
• PROJECT_ID: ID project Google Cloud Anda.
• LOCATION: Lokasi project Google Cloud Anda.

Contoh

Contoh berikut memanggil integrasi di region us-east1 yang berisi pemicu test_API_1 API di project Google Cloud demo-project:

curl -X POST \
    -H "authorization: Bearer $(gcloud auth print-access-token)"
    -H "Content-Type: application/json" \
    -d '{"trigger_id":"api_trigger/test_API_1"}' \
    "https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-central1/integrations/-:execute"

Pertimbangan

Saat menggunakan pemicu API, ukuran kumulatif semua variabel input dapat maksimum 8 MB. Jika ukurannya melebihi 8 MB, Application Integration tidak akan menjalankan integrasi dan Anda akan mendapatkan error.