Dalam tutorial ini, kita akan melihat lebih dekat bagaimana Anda bisa mengintegrasikan Tilda dan AppMaster . Misalkan formulir tertentu telah dibuat di Tilda , dan tugas kita adalah memastikan bahwa data, ketika diisi, masuk ke AppMaster , diproses di sana dan disimpan di database.
Membuat webhook di AppMaster
Tilda mengirimkan data ke layanan pihak ketiga melalui webhook. Oleh karena itu, ada baiknya memulai dengan pembuatan webhook yang diperlukan dan, pertama-tama, menyiapkan proses bisnis untuk pengoperasiannya.
Ciri dari proses ini adalah tidak diketahui sebelumnya data pasti apa yang akan diperoleh. Webhook akan berfungsi dengan permintaan " raw " yang perlu diproses dengan benar. Untuk melakukan ini, kami akan menggunakan blok Get Request Body . Mari kita lihat data apa yang umumnya berasal dari Tilda , ubah menjadi String , tulis ke log dan tampilkan sebagai tanggapan atas permintaan.
Pada bagian endpoints, mari langsung membuat webhook baru. Penting untuk dicatat bahwa jenis permintaan harus Raw karena tidak memiliki parameter input hard-code dan siap menerima data apa pun. Anda juga perlu menonaktifkan Middleware Token Auth karena untuk mengisi formulir di Tilda , Anda tidak perlu melalui otorisasi di AppMaster , dan pengiriman data terbuka untuk semua orang.
Pengaturan formulir Tilda
Langkah selanjutnya adalah menghubungkan Tilda ke webhook yang dibuat. Untuk melakukan ini, dalam pengaturan formulir situs, cukup menentukan URL, meskipun, jika perlu, Anda dapat menggunakan opsi tambahan. Misalnya, untuk perlindungan tambahan, berikan juga kunci khusus, di badan permintaan atau di header.
Jika semuanya dilakukan dengan benar, pesan yang sesuai akan muncul dengan kemampuan untuk segera menautkan webhook ini ke semua formulir di situs.
Tetap hanya menerbitkan halaman dengan formulir dan mengujinya dalam tindakan.
Dengan membuka log AppMaster, Anda dapat memastikan bahwa data dari formulir benar-benar diterima.
Pesan: “Email=tes%40gmail.com&Nama=John+Smith&Telepon=%2B1-202-202-22-22&Komentar=Halo%2C+dunia%21%0AIni+adalah+komentar+saya&tranid=6355139%3A3971256761&formid=form513738662”
Anda dapat melihat semua informasi yang diisi dalam formulir. Pada saat yang sama, menjadi jelas bahwa data diterima dalam format x-www-form-urlencoded , masing-masing, tidak dapat lagi diproses sebagai kumpulan data mentah, tetapi sebagai kumpulan bidang individual.
Model basis data AppMaster
Tetap hanya membuat penangan yang tepat. Dan yang terbaik adalah memulai dengan model basis data tempat semua informasi akan disimpan.
Untuk formulir standar, model sederhana dengan 4 bidang sudah cukup:
- Email (String)
- Name (String)
- Phone (String)
- Comments (Text)
Selanjutnya, Anda perlu kembali ke proses bisnis yang dibuat dan mengubahnya dengan mempertimbangkan informasi yang diterima tentang komposisi permintaan.
Nama field dari tabel yang akan diisi akan digunakan sebagai parameter input. Data dari mereka akan digunakan untuk membuat model ( Make Tilda ) dan kemudian menulis ke database ( DB: Create Tilda ).
Hal terakhir yang harus dilakukan adalah mengubah titik akhir yang dibuat sebelumnya untuk webhook. Kami mengetahui format data yang masuk dan memprosesnya, jadi tipe Request payload type harus Form . Pada saat yang sama, penting untuk mencocokkan parameter yang dibuat dalam proses bisnis dengan nama bidang yang tepat dari formulir yang sudah diisi (kami melihatnya di log saat kami menerima data dari permintaan sebagai data mentah). Dalam contoh ini, mereka hampir sama, tetapi berbeda dalam kasus karakter pertama.
Sekarang Anda dapat menerbitkan aplikasi yang dibuat dan mengujinya dalam tindakan. Jika Anda berulang kali mengisi dan mengirimkan formulir di Tilda , maka data akan dikirim ke AppMaster , ditulis ke database, dan ini dapat diverifikasi menggunakan Swagger .
