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.