Bantu kami menerjemahkan

Dokumen ini diterjemahkan oleh komunitas. Kamu dapat ikut berkontribusi menyempurnakan terjemahan ini melalui Crowdin. Kami sangat mengapresiasi atas kerjasama yang telah kamu berikan dengan ikut berkontribusi dalam proyek ini 🙏.

Webhook

Tips

バージョン 12.109.0 以降の機能です。

Peringatan

実験的な機能であるため、動作が不安定だったり今後仕様が変更される可能性があります。

MisskeyにはWebhookが用意されています。Webhookを利用すると、Misskey上の様々なイベントをリアルタイムに受け取ることが可能です。

設定 > WebhookでWebhookの管理を行えます。

Webhookが登録されると、指定したイベントが発生した際に、指定したURLにHTTPリクエストが送信されます。リクエストのメソッドはPOSTで、ボディはJSONです。 さらに、リクエストヘッダーにはX-Misskey-Hook-Secretという名前で、登録時に設定したシークレットが含まれます。このシークレットが正しいか検証することで、リクエストが正規のものか判定することができます。

リクエストペイロードは以下のプロパティが入ります。

送信先サーバーが5xxエラーを返すか、応答しなかった場合は時間を開けてリクエストが再送されます。

Webhookは管理画面から個別にアクティブ状態を設定でき、一時的にリクエストの送信を停止させることができます。

イベント

イベントごとに説明とペイロードを示します。

follow

自分が誰かをフォローした際に発生します。

followed

自分が誰かからフォローされた際に発生します。

unfollow

自分が誰かをフォロー解除した際に発生します。

note

自分がノートを投稿した際に発生します。

reply

自分のノートに返信された際に発生します。

renote

自分のノートがRenoteされた際に発生します。

mention

自分にメンションされた際に発生します。