Webhook
Fitur ini telah tersedia sejak Misskey versi 12.109.0.
Fitur ini eksperimental dan kemungkinan tidak stabil atau terdapat perubahan kedepannya nanti.
Misskey menyediakan webhook yang mana membolehkanmu untuk menerima berbagai event dari Misskey secara realtime.
Kamu dapat mengelola webhookmu dengan menuju ke menu Pengaturan > Webhook.
Ketika webhook telah terdaftar, permintaan HTTP dikirimkan ke URL yang telah ditentukan setiap kali event yang ditentukan terjadi. Metode permintaan tersebut berjenis POST dan berisi JSON pada body. Sebagai tambahan, header permintaan akan memuat secret yang telah diatur pada saat registrasi dengan nama X-Misskey-Hook-Secret
. Kamu dapat menggunakan secret ini untuk memverifikasi apakah permintaan tersebut sah.
Muatan dari permintaan memiliki isi properti sebagai berikut.
Jika peladen tujuan mengeluarkan error 5XX atau tidak merespon, maka permintaan akan dikirimkan kembali setelah jeda waktu.
Webhook secara terpisah dapat memiliki status aktif mereka diubah dari layar administrator untuk menghentikan pengiriman permintaan dalam sementara waktu.
Event
Berikut deskripsi dan muatan dari setiap tipe event.
follow
Terjadi ketika mengikuti seseorang.
followed
Terjadi ketika kamu diikuti seseorang.
unfollow
Terjadi ketika kamu batal mengikuti seseorang.
note
Terjadi ketika kamu memposting catatan.
reply
Terjadi ketika seseorang telah membalas catatanmu.
renote
Terjadi ketika catatanmu direnote.
mention
Terjadi ketika seseorang menyebut kamu.