Integrasi koneksi REST API - Amazon Cepat
Apa yang dapat Anda lakukanSebelum Anda mulaiSiapkan titik akhir dan otentikasi APISiapkan integrasi REST APITindakan tugas yang tersediaOpsi konfigurasi APIKelola integrasi REST API

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Integrasi koneksi REST API

Dengan integrasi REST API Connection di Amazon Quick, Anda dapat melakukan tindakan dengan REST kustom APIs dan layanan web. Integrasi ini hanya mendukung eksekusi tindakan.

Apa yang dapat Anda lakukan

Dengan integrasi REST API Connection, Anda dapat melakukan tindakan dengan REST kustom APIs dan layanan web melalui konektor tindakan.

Konektor aksi

Lakukan permintaan HTTP, ambil data, dan berinteraksi dengan APIs menggunakan opsi otentikasi fleksibel.

catatan

Integrasi REST API Connection tidak mendukung akses data atau pembuatan basis pengetahuan. Ini dirancang khusus untuk eksekusi tugas dan interaksi API dengan layanan web khusus.

Sebelum Anda mulai

Sebelum Anda mengatur integrasi REST API, pastikan Anda memiliki yang berikut:

  • Titik akhir REST API dengan izin akses yang sesuai.

  • Kredensi otentikasi API (OAuth, kunci API, atau lainnya).

  • Dokumentasi API untuk layanan web target.

Siapkan titik akhir dan otentikasi API

Sebelum mengonfigurasi integrasi di Amazon Quick, siapkan titik akhir REST API dan kredensial autentikasi Anda. Integrasi REST API Connection mendukung beberapa metode otentikasi. Pilih metode yang sesuai dengan persyaratan API Anda:

Otentikasi pengguna () OAuth

Kumpulkan informasi berikut dari penyedia API Anda:

  • URL Dasar - URL dasar REST API.

  • ID Klien - ID klien OAuth aplikasi.

  • Rahasia Klien - rahasia klien OAuth aplikasi.

  • URL Token - titik akhir OAuth token.

  • URL Auth - titik akhir OAuth otorisasi.

  • URL pengalihan - OAuth mengarahkan URI.

Otentikasi layanan () Service-to-service OAuth

Kumpulkan informasi berikut dari penyedia API Anda:

  • Jenis otentikasi - OAuth 2.0 kredensi klien memberikan aliran untuk otentikasi. service-to-service

  • URL Dasar - URL dasar REST API.

  • ID Klien - pengidentifikasi klien OAuth aplikasi untuk otentikasi layanan.

  • Rahasia klien - rahasia klien OAuth aplikasi untuk otentikasi layanan.

  • URL Token - titik akhir OAuth token untuk mendapatkan token akses.

Header dan parameter khusus

Anda dapat menggunakan header dan parameter khusus untuk otentikasi fleksibel dan interaksi API:

  • Header otentikasi kustom.

  • Header versi API.

  • Spesifikasi Content-Type.

  • Parameter kueri kustom.

Siapkan integrasi REST API

Setelah menyiapkan endpoint API dan kredensial autentikasi, ikuti langkah-langkah berikut untuk membuat integrasi REST API:

  1. Di konsol Amazon Quick, pilih Integrasi.

  2. Pilih REST API Connection dari opsi integrasi, dan klik tombol Add (plus “+”).

  3. Isi detail integrasi:

    • Nama - Nama deskriptif untuk integrasi REST API Anda.

    • Deskripsi (Opsional) - Tujuan integrasi.

  4. Pilih jenis koneksi Anda:

    • Otentikasi OAuth berbasis otentikasi pengguna untuk akses pengguna individu.

    • Otentikasi layanan - Autentikasi berbasis kunci API untuk akses layanan.

  5. Isi pengaturan koneksi berdasarkan metode otentikasi yang Anda pilih (baik pengguna atau layanan).

  6. Pilih Selanjutnya.

  7. Tinjau tindakan yang tersedia.

  8. Pilih Buat dan lanjutkan.

Tindakan tugas yang tersedia

Setelah membuat integrasi REST API, Anda dapat meninjau tindakan yang tersedia untuk berinteraksi dengan REST API. Tindakan REST API yang umum meliputi:

  • Permintaan HTTP GET untuk pengambilan data.

  • Permintaan HTTP POST untuk pembuatan data.

  • PUT/PATCH Permintaan HTTP untuk pembaruan data.

  • Permintaan HTTP DELETE untuk penghapusan data.

  • Interaksi titik akhir kustom.

  • Pemrosesan data JSON dan XHTML.

  • Parameter kueri dan manajemen header.

catatan

Tindakan spesifik yang tersedia bergantung pada titik akhir REST API dan izin otentikasi yang dikonfigurasi untuk integrasi Anda.

Opsi konfigurasi API

Anda dapat mengonfigurasi berbagai aspek integrasi REST API agar sesuai dengan kebutuhan spesifik Anda.

Konfigurasi titik akhir

Konfigurasikan pengaturan titik akhir ini:

  • URL dasar dan jalur titik akhir.

  • Spesifikasi metode HTTP.

  • Penanganan format permintaan dan respons.

  • Penanganan kesalahan dan coba lagi logika.

Penanganan data

Konfigurasikan cara integrasi Anda memproses format data yang berbeda:

  • Permintaan JSON dan pemrosesan respons.

  • Transformasi data XML.

  • Formulir data dan unggahan multipart.

  • Penanganan data biner.

Kelola integrasi REST API

Setelah membuat integrasi REST API, Anda dapat mengelolanya menggunakan opsi berikut:

  • Edit integrasi - Perbarui pengaturan otentikasi, URL dasar, atau konfigurasi API.

  • Integrasi berbagi - Buat integrasi tersedia untuk pengguna lain di organisasi Anda.

  • Memantau penggunaan - Lihat aktivitas integrasi dan metrik panggilan API.

  • Tinjauan tindakan - Lihat daftar lengkap tindakan REST API yang tersedia.

  • Uji titik akhir - Validasi konektivitas dan otentikasi API.

  • Hapus integrasi - Hapus integrasi dan cabut otentikasi terkait.

penting

Integrasi REST API bergantung pada ketersediaan dan konfigurasi layanan web target. Perubahan pada API atau persyaratan otentikasi dapat memengaruhi fungsionalitas integrasi.