jointrashposs/content/ko/docs/2.for-users/3.features/webhook.md

Webhook

:::tip

버전 12.109.0 이후 기능입니다.

:::

:::warning

실험적인 기능이기 때문에 작동이 불안정하거나 향후 사양이 변경될 수 있습니다.

:::

Misskey에는 Webhook이 준비되어 있습니다.Webhook을 이용하면 Misskey의 다양한 이벤트를 실시간으로 받아볼 수 있습니다.

대상 서버가 5xx 오류를 반환하거나 응답하지 않는 경우 시간을 열어 요청을 다시 전송합니다.

Webhook이 등록되면 지정한 이벤트가 발생하면 지정한 URL로 HTTP 요청이 전송됩니다.요청의 메서드는 POST이고, 본문은 JSON입니다. 또한, 요청 헤더에는 X-Misskey-Hook-Secret이라는 이름으로 등록 시 설정한 시크릿이 포함됩니다.이 시크릿이 올바른지 확인하여 요청이 유효한지 판단할 수 있습니다.

요청 페이로드에는 다음과 같은 속성이 들어갑니다.

각 이벤트마다 설명과 페이로드를 표시합니다.

대상 서버가 5xx 오류를 반환하거나 응답하지 않는 경우 시간을 열어 요청을 다시 전송합니다.

자신이 누군가를 팔로우했을 때 발생합니다.

이벤트

각 이벤트마다 설명과 페이로드를 표시합니다.

follow

followed

unfollow

note

reply

renote

mention

자신에게 멘션이 왔을때 발생합니다.