这页的内容
请协助我们进行翻译

本文档为社区翻译,您可以通过 Crowdin 翻译该文档。我们需要您的帮助🙏

Webhook

提示

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

注意

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

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

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