본문으로 건너뛰기

푸시 알림

client.push API는 Web Push 구독을 관리합니다. Web Push Protocol을 따르며 애플리케이션이 백그라운드에서 알림을 수신할 수 있게 합니다.

구독 등록​

푸시 엔드포인트와 VAPID 키를 제공하여 새 Web Push 구독을 생성합니다:

final subscription = await client.push.create(
  MastodonPushSubscriptionRequest(
    endpoint: 'https://push.example.com/subscription/abc123',
    p256dh: '<Base64url-encoded P-256 ECDH public key>',
    auth: '<Base64url-encoded authentication secret>',
    standard: true,
    alerts: MastodonPushAlertSettings(
      mention: true,
      follow: true,
      reblog: true,
      favourite: true,
      poll: true,
    ),
    policy: 'followed', // all | followed | follower | none
  ),
);

print(subscription.id);
print(subscription.serverKey); // 수신된 푸시 검증에 사용

알림 타입​

MastodonPushAlertSettings는 다음 필드의 임의 조합을 허용합니다. null로 설정된 필드는 요청에서 생략되어 변경되지 않습니다.

필드설명
mention포스트에서 언급됨
quote포스트가 인용됨
status팔로우하는 사용자의 새 포스트
reblog포스트가 부스트됨
follow새 팔로워
followRequest새 팔로우 요청
favourite포스트가 좋아요됨
poll투표하거나 생성한 설문이 종료됨
update상호작용한 포스트가 수정됨
quotedUpdate인용된 포스트가 수정됨
adminSignUp새 사용자 가입 (관리자 전용)
adminReport새 신고 (관리자 전용)

정책 값​

값설명
all모든 사용자의 알림 수신
followed팔로우하는 사용자의 알림만 수신
follower팔로워의 알림만 수신
none모든 푸시 알림 비활성화

현재 구독 조회​

final subscription = await client.push.fetch();
print(subscription.endpoint);
print(subscription.alerts.mention);
print(subscription.policy);

알림 설정 업데이트​

update를 사용하면 구독을 재생성하지 않고 알림 설정이나 정책을 변경할 수 있습니다. data 부분(알림과 정책)만 변경할 수 있습니다.

final updated = await client.push.update(
  MastodonPushSubscriptionUpdateRequest(
    alerts: MastodonPushAlertSettings(
      mention: true,
      follow: false,
    ),
    policy: 'all',
  ),
);

구독 해제​

await client.push.delete();

현재 Web Push 구독을 삭제합니다. 이후 fetch 호출은 MastodonNotFoundException을 발생시킵니다.

MastodonWebPushSubscription 모델​

필드타입설명
idString구독 ID
endpointString푸시 엔드포인트 URL
serverKeyString푸시 메시지 검증용 서버 공개 키
alertsMastodonPushAlerts활성화된 알림 설정
policyString알림 정책
standardbool?표준화된 Web Push 스펙을 따르는지 여부 (Mastodon 4.4+)