Terima jawapan borang di Next.js, Node.js atau Python
Simpan salinan bertandatangan bagi setiap jawapan borang dalam aplikasi anda sendiri. Penerima sedia untuk Next.js, Node.js, Python, Laravel dan PHP, serta empat peraturan jika anda menulis sendiri.
Banyak pasukan mahukan jawapan borang mereka di dua tempat: dalam Weesify, tempat orang itu menjadi kenalan dan automasi bermula, dan dalam aplikasi mereka sendiri, di samping pelanggan, pesanan atau tiket mereka. Sebelum ini Weesify menyediakan penerima untuk WordPress, PHP biasa dan Laravel. Keluaran ini menambah Next.js, Node.js dan Python, dan Weesify kini mengenali laman-laman itu apabila anda menyambungkannya.
Panduan ini menerangkan cara menyambung laman, memilih penerima yang betul, apa yang mesti disemak oleh penerima, dan cara beralih daripada storan contoh kepada pangkalan data anda sendiri.
Dalam panduan ini
- Cara salinan berfungsi
- Sambungkan laman anda
- Pilih penerima anda
- Empat peraturan yang diikuti setiap penerima
- Daripada fail JSON ke pangkalan data anda
- Menguji dan mula beroperasi
- Cara lain untuk mengeluarkan jawapan
Cara salinan berfungsi
Weesify sentiasa menyimpan setiap jawapan dahulu. Apabila borang mempunyai Simpan salinan di laman ini dihidupkan, Weesify kemudian menghantar salinan ke laman anda sebagai permintaan HTTPS bertandatangan. Penerima anda menyemak tandatangan, menyimpan salinan sekali sahaja dan menjawab bahawa ia telah disimpan. Hanya selepas itu Weesify mengira salinan itu sebagai telah dihantar.
Jika laman anda tidak aktif atau menjawab dengan ralat, Weesify mencuba semula selama kira-kira sehari, dengan jarak yang semakin panjang antara cubaan. Skrin Laman web menunjukkan salinan yang dihantar, menunggu, sedang dicuba semula dan gagal bagi setiap laman, supaya anda sentiasa tahu keadaannya.

Sambungkan laman anda
- Pergi ke Borang › Laman web dan tekan Sambung laman.
- Masukkan alamat laman anda. Weesify melihat halaman awamnya, mengenali laman WordPress, Laravel, Next.js, Node.js, Python dan PHP biasa, dan mencadangkan alamat penerima yang betul, contohnya
/api/weesifyuntuk Next.js. - Salin rahsia tandatangan. Ia ditunjukkan sekali sahaja. Simpan di pelayan anda sebagai pemboleh ubah persekitaran bernama
WEESIFY_SECRET, jangan sekali-kali dalam halaman web atau repositori anda. - Muat turun penerima untuk teknologi anda dari panel yang sama.
Jika Weesify tidak dapat mengenal pasti cara laman anda dibina, pilih Pelayan saya sendiri dan masukkan alamat sendiri. Mana-mana teknologi yang boleh menerima POST HTTPS akan berfungsi.
Pilih penerima anda
Next.js (App Router). Simpan route.ts sebagai app/api/weesify/route.ts. Ia berjalan pada runtime Node.js, membaca badan mentah, menyemak tandatangan dan menjawab dalam JSON. Ada tempat yang ditanda dengan jelas untuk panggilan pangkalan data anda, menggunakan Prisma, Drizzle, Supabase atau apa sahaja yang sudah anda gunakan.
Node.js. weesify-receiver.mjs memerlukan Node 18 atau lebih baharu dan tiada pakej. Jalankannya sendiri di belakang HTTPS, atau pasangkannya dalam Express dengan app.post('/weesify/receive', weesifyExpress()). Jangan letak penghurai badan JSON pada laluan itu: tandatangan disemak terhadap bait tepat yang dihantar oleh Weesify.
Python. weesify_receiver.py hanya menggunakan pustaka standard, Python 3.8 atau lebih baharu. Jalankannya sendiri, atau panggil fungsi handle() daripada laluan Flask atau paparan Django. Dalam Django, tandakan paparan itu @csrf_exempt: tandatangan itulah yang melindunginya.
Laravel. WeesifyFormCopyController.php diletakkan dalam app/Http/Controllers, dengan satu laluan dalam routes/api.php dan jadual kecil untuk salinan. Fail itu menunjukkan kedua-duanya.
PHP. weesify-receiver.php berfungsi pada mana-mana hos PHP 7.4+, termasuk hos kongsi. Muat naiknya dan tetapkan rahsia.
Setiap fail menerangkan dirinya di bahagian atas, supaya anda boleh membaca dengan tepat apa yang dilakukannya sebelum ia mendekati pelayan anda.
Empat peraturan yang diikuti setiap penerima
Jika anda lebih suka menulis sendiri, inilah sahaja yang perlu dilakukannya.
1. Semak tandatangan. Setiap permintaan ada dua pengepala: X-Weesify-Timestamp (dalam saat) dan X-Weesify-Signature, iaitu v1= diikuti HMAC-SHA256 dalam heks bagi timestamp.body menggunakan rahsia anda. Kira nilai yang sama daripada badan mentah dan bandingkannya dalam masa malar.
2. Tolak permintaan lama. Jika cap masa berbeza lebih daripada lima minit daripada jam pelayan anda, jawab 401. Ini menghalang permintaan yang dipintas daripada dihantar semula kemudian.
3. Jawab ping. Apabila anda menekan Uji dalam Weesify, ia menghantar {"event": "ping"}. Jawab {"ok": true}.
4. Simpan setiap salinan sekali sahaja. Salinan sebenar mempunyai "event": "submission.copy" dan idempotency_key. Simpannya jika anda belum pernah melihat kunci itu dan jawab {"stored": true}; jika sudah, jawab {"duplicate": true}. Cubaan semula menggunakan kunci yang sama, jadi salinan yang tiba dua kali disimpan sekali.
Apa-apa jawapan selain 2xx dengan stored atau duplicate dianggap sebagai "cuba lagi nanti". Itu disengajakan: jika pangkalan data anda tidak tersedia seketika, menjawab 500 bermakna Weesify terus menyimpan salinan itu dalam giliran dan tidak kehilangannya.
Kami menguji peraturan ini pada penerima kami sendiri dalam setiap keluaran: penandatangan Weesify menghasilkan permintaan sebenar, fail Node.js dan Python dijalankan seperti di pelayan anda, dan semakan di atas mesti lulus, termasuk penolakan cap masa yang lapuk.
Daripada fail JSON ke pangkalan data anda
Penerima PHP, Node.js dan Python menyimpan setiap salinan sebagai fail JSON dalam folder peribadi, supaya ia berfungsi sebaik dimuat naik. Itu memadai untuk ujian atau laman yang bervolum rendah. Untuk kegunaan sebenar, ubah fungsi store() supaya menulis baris dalam pangkalan data anda:
- gunakan
idempotency_keysebagai lajur unik, supaya pangkalan data itu sendiri menolak pendua; - simpan
submission.id, rujukan kepada yang asal dalam Weesify; - simpan
answerssebagai JSON, atau petakan soalan yang anda pentingkan ke lajurnya sendiri; filesmenyenaraikan sebarang muat naik bersama nama dan alamat muat turunnya.
Penerima Next.js disertakan dengan set dalam memori dan bukannya fail, kerana kebanyakan hos Next.js tiada cakera kekal. Ia dilabel dengan jelas sebagai tidak kekal, dengan contoh berkomen bagi panggilan pangkalan data yang menggantikannya.
Menguji dan mula beroperasi
- Lancarkan penerima dengan
WEESIFY_SECRETditetapkan. - Dalam Borang › Laman web, tekan Uji. "Disambungkan" berwarna hijau bermakna tandatangan, jam dan ping semuanya berfungsi.
- Buka borang, pergi ke Salinan dan hidupkan Simpan salinan di laman ini untuk laman anda.
- Hantar borang itu sekali sendiri dan lihat salinan muncul sebagai telah dihantar.
Jika Uji gagal, mesej menerangkan sebabnya dengan kata-kata mudah: alamat tidak dapat dicapai, jawapan bukan JSON, atau tandatangan tidak sepadan (biasanya rahsia yang ditampal dengan ruang berlebihan, atau penghurai badan yang mengubah bait).
Cara lain untuk mengeluarkan jawapan
Salinan ke pelayan anda ialah salah satu daripada beberapa laluan, dan anda boleh menggunakan lebih daripada satu serentak:
- Aplikasi. Google Sheets, Airtable, Notion, HubSpot dan Salesforce, masing-masing dengan log masuknya sendiri, dari skrin Laman web yang sama.
- Webhook dan API. Setiap jawapan ialah peristiwa yang boleh anda hantar ke mana-mana, dan API membaca borang serta jawapan. Artikel kami tentang API dan CLI Weesify menerangkan kedua-duanya.
- Pembantu AI. Pelayan MCP Weesify membolehkan pembantu yang anda gunakan membaca borang dan jawapan anda serta membuat draf borang baharu, menggunakan token yang anda kawal.

Apa pun laluan yang anda pilih, Weesify menyimpan yang asal, jadi anda boleh mematikan destinasi, membetulkannya dan menghidupkannya semula tanpa kehilangan satu jawapan pun.
Dapatkan catatan baharu melalui e-mel
Artikel baharu daripada Blog Weesify, terus ke peti masuk anda. Tiada spam, nyahlanggan pada bila-bila masa.
Dengan melanggan, anda bersetuju menerima e-mel daripada Blog Weesify. Nyahlanggan pada bila-bila masa.
Komen
Belum ada komen. Mulakan perbualan.