Weesify
Panduan

Terima jawapan borang di Next.js, Node.js atau Python

6 min bacaan

Pasukan WeesifyBlog Weesify ·

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.

Borang › Laman web dengan laman yang disambungkan, salinan yang dihantar, menunggu dan sedang dicuba semula, borang yang menyimpan salinan dan aplikasi di bawahnya
Borang › Laman web dengan laman yang disambungkan, salinan yang dihantar, menunggu dan sedang dicuba semula, borang yang menyimpan salinan dan aplikasi di bawahnya

Sambungkan laman anda

  1. Pergi ke Borang › Laman web dan tekan Sambung laman.
  2. 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/weesify untuk Next.js.
  3. 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.
  4. 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_key sebagai lajur unik, supaya pangkalan data itu sendiri menolak pendua;
  • simpan submission.id, rujukan kepada yang asal dalam Weesify;
  • simpan answers sebagai JSON, atau petakan soalan yang anda pentingkan ke lajurnya sendiri;
  • files menyenaraikan 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

  1. Lancarkan penerima dengan WEESIFY_SECRET ditetapkan.
  2. Dalam Borang › Laman web, tekan Uji. "Disambungkan" berwarna hijau bermakna tandatangan, jam dan ping semuanya berfungsi.
  3. Buka borang, pergi ke Salinan dan hidupkan Simpan salinan di laman ini untuk laman anda.
  4. 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.
Tetapan › Pembangun dengan kad Sambung pembantu AI: alamat MCP dan tiga langkah untuk menyambung
Tetapan › Pembangun dengan kad Sambung pembantu AI: alamat MCP dan tiga langkah untuk menyambung

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.

Komen dipaparkan setelah penulis meluluskannya.

Ikuti bersama

Siaran baharu tiba dalam pembaca suapan anda sebaik sahaja diterbitkan. Perubahan dalam setiap keluaran ada dalam log perubahan.