Pangerten Struktur Panjalukan Webhook
Saben webhook sing dikirim dening sistem njaba ngemot telung bagean utama: metode HTTP, header, lan awak panjaluk (request body). Kanggo pangembang API, insinyur integrasi, perwakilan layanan pelanggan, lan pangopen otomatisasi, mangerteni struktur iki penting banget kanggo ngatasi masalah integrasi.
Nalika nggarap webhook, format data sing ditampa asring dadi tantangan, utamane nalika kudu mbedakake antarane format JSON utawa URL-encoded form data. Alat Inspektur Panjaluk Webhook iki mbantu mriksa format kasebut kanthi rinci lan nyedhiyakake printah cURL sing bisa disalin kanggo kaperluan tes lokal.
Input kanggo mriksa Panjalukan
Kanggo miwiti mriksa, pangguna kudu nyedhiyakake sawetara informasi dhasar saka panjalukan webhook sing dijupuk sadurunge parsing sisih server kedadeyan:
- Metode: Pangguna bisa milih metode HTTP sing cocog saka dhaptar sing kasedhiya, yaiku POST, PUT, PATCH, GET, utawa DELETE.
- Headers: Header kudu dilebokake kanthi format siji header saben baris nggunakake pola "Name: value". Watesan maksimal kanggo header yaiku 200 baris non-kosong kanthi gunggung karakter maksimal 100.000 karakter.
- Badan: Tempel awak mentah sing dijupuk sadurunge parsing sisih server. Watesan maksimal kanggo awak panjaluk iki yaiku 1.000.000 karakter.
Yen input sing dilebokake ora cocog karo aturan kasebut, alat bakal nampilake pesen kesalahan sing spesifik.
Output lan Asil Inspeksi
Sawise pangguna nglebokake data lan milih "Priksa panjalukan", alat bakal ngasilake sawetara informasi penting:
- Badan sing diformat: Yen awak panjaluk awujud JSON utawa URL-encoded form data, alat bakal nampilake data sing wis diformat supaya luwih gampang diwaca. Yen awak panjaluk kosong, bakal katon tulisan "(kosong)".
- Kolom teken: Alat bakal nampilake dhaptar header tanda tangan utawa cap wektu (timestamp) sing umum ditemokake ing panjalukan webhook. Yen ora ana sing dideteksi, bakal nampilake "Ora ana tandha umum utawa header cap wektu webhook sing ditemokake.".
- Tes cURL lokal: Alat bakal nggawe printah cURL sing wis di-quote nganggo aturan shell sing ditargetake menyang
http://localhost:3000/webhookskanggo tes ing lingkungan lokal.
Aturan Pangolahan lan Kasus Khusus
Alat iki nduweni aturan tartamtu nalika ngolah data sing dilebokake:
- Deteksi Format: Alat mung bisa ndeteksi lan ngowahi format JSON lan URL-encoded form data. Format liyane bakal tetep ditampilake minakup teks biasa.
- Pangolahan JSON: Badan JSON bakal diurai nggunakake fungsi
JSON.parselan diurutake maneh. Proses iki bakal ngilangake spasi asli (whitespace) lan susunan kolom sing asli saka panjalukan mentah. - Watesan Tes cURL: Printah cURL sing diasilake wis ditetepake kanthi permanen menyang alamat target
http://localhost:3000/webhookslan ora bisa diowahi ing njero alat iki. - Identifikasi Header: Alat iki ngenali header tanda tangan lan cap wektu adhedhasar pola jeneng kaya
signature,hmac,digest, lan jeneng cap wektu sing umum. Alat iki ora ngetung HMAC, ora nindakake algoritma, ora mriksa bita asli saka payload, ora mriksa kunci rahasia, jendhela muter maneh (replay window), utawa verifikasi khusus panyedhiya.
Pesen Kesalahan lan Solusi
Nalika nggunakake alat iki, pangguna bisa nemoni sawetara pesen kesalahan gumantung saka data sing dilebokake:
| Pesen Kesalahan | Katrangan / Solusi |
|---|---|
| "Tempel paling ora siji header utawa awak panjaluk dhisik." | Pangguna kudu ngisi bagean header utawa awak panjaluk sadurunge nindakake inspeksi. |
| "Header dawa banget kanggo alat iki. Mbusak nilai sing ora ana hubungane utawa bola-bali." | Gunggung karakter ing bagean header ngluwihi watesan 100.000 karakter. |
| "Awak dawa banget kanggo alat iki. Simpen ing ngisor 1.000.000 karakter." | Awak panjaluk sing ditempelake ngluwihi watesan maksimal 1.000.000 karakter. |
| "Ana akeh banget garis header. Tansah panjalukan kanggo 200 header utawa kurang." | Gunggung baris header sing dilebokake ngluwihi watesan 200 baris. |
"‹line›: Header baris ora valid. Gunakake Jeneng: nilai." |
Baris header tartamtu ora nggunakake format "Name: value" sing bener. |
| "Badan katon kaya JSON nanging ora bisa diurai." | Format JSON sing dilebokake rusak utawa ora valid sahingga ora bisa diurai dening JSON.parse. |
| "Badan wangun ngemot uwal persen ora lengkap." | Ana kesalahan format persen-encoding ing njero data formulir sing dilebokake. |
Keamanan lan Privasi Data
Keamanan data dadi bab sing penting nalika mriksa isi webhook sing sensitif. Panjaluk sing ditempelake tetep ana ing browser sampeyan. BroBroGo ora ngunggah utawa nyimpen data kasebut menyang server njaba. Kabeh proses analisis lan format data ditindakake sacara lokal ing piranti pangguna.
Pitakonan sing Asring Ditakonake (FAQ)
Apa kaca iki bisa nampa panggilan balik webhook langsung?
Ora Tempel panjalukan sing dijupuk ing kene kanggo mriksa. Kaca kasebut ora nggawe titik pungkasan umum, nampa panggilan balik utawa ngirim panjaluk tes sing digawe.
Format awak webhook endi sing bisa dakpriksa?
JSON lan badan formulir sing dienkode URL dideteksi lan diformat. Badan liyane tetep minangka teks biasa supaya alat kasebut ora ngira ing XML, multipart utawa isi binar.
Apa nemokake lapangan teken mbuktekake panyuwunan kasebut asli?
Ora Alat mung lumahing teken lan header timestamp related. Verifikasi nyata mbutuhake aturan teken pangirim, kunci rahasia utawa umum, lan bait panyuwunan asli.