Lihat konektor yang didukung untuk Integration Aplikasi.

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 fulfillment API.

Menambahkan pemicu API

Untuk menambahkan pemicu pemicu API, lakukan langkah-langkah berikut:
  1. Di konsol Google Cloud, buka halaman Integrasi Aplikasi.

    Buka Application Integration

  2. Di menu navigasi, klik Integrations

    Halaman Daftar Integrasi akan muncul yang 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 Buat Integrasi.
    2. Pilih region untuk integrasi.
    3. Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Ringkasan integrasi di toolbar integrasi.
    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 Pemicu API di editor integrasi untuk melihat panel konfigurasi pemicu.

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

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.

Sintaks

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

Ganti kode berikut:

  • TIMEOUT_SECONDS: Waktu tunggu dalam detik untuk panggilan API. Secara default, waktu tunggunya adalah 120 detik. Untuk mengetahui daftar kumpulan parameter permintaan standar, lihat Parameter sistem.
  • 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 wilayah 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" \
    -H "X-Server-Timeout: 300"
    -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 maksimal 8 MB. Jika ukurannya melebihi 8 MB, Integrasi Aplikasi tidak akan menjalankan integrasi dan Anda akan mendapatkan error.

Kuota dan batas

Untuk mengetahui informasi tentang kuota dan batas, lihat Kuota dan batas.

Langkah selanjutnya