알림 목록

GET /v1/notifications

최신순 앱 내 알림과 unread_count를 가져옵니다. 맞춤 에이전트가 스스로 실행되고(일정, 이벤트 또는 한 번) 앱 내 구성에서 결과 수신을 선택하면 알림이 기록됩니다. 선택적 ?limit=의 기본값은 50이며 최댓값은 200입니다.

데스크톱에서는 로컬 세션 이벤트와 로그인한 계정의 서버 알림도 포함합니다. server_owner는 계정 범위를 나타내는 불투명한 식별자이며, 로그아웃 상태에서는 null이고 데스크톱 수신 기능이 꺼져 있으면 생략됩니다. 서버 레코드는 source: server를 가지며 tag를 포함할 수 있습니다. 제목과 본문은 서버에서 생성합니다. Accept-Language와 X-Minara-Client-Version은 현재 설치의 구독 정보만 업데이트합니다. 서버 알림의 읽음 및 삭제 작업은 현재 계정에만 적용되며, 목록을 비워도 전달 중복 방지 기록은 유지됩니다. 서버 수신함이 변경되면 notifications WebSocket 채널이 빈 data 객체와 함께 notifications_changed를 보냅니다. 이 API를 다시 요청하여 동기화하세요.

PC의 presentation은 system(false, always, unfocused-only), inbox(불리언), toast(false, focused-only)를 각각 지정합니다. inbox 레코드만 읽지 않은 알림 수에 포함됩니다. server_deliveries에는 이번 gateway 실행 중 수신한 실시간 알림이 포함되며 벨에 들어가지 않는 알림도 있을 수 있습니다. historical 기록과 콜드 스타트 수신함은 시스템 알림이나 Toast를 다시 띄우지 않습니다. 알 수 없는 내부 경로는 홈으로 돌아갑니다. 일반 Chat/Coding 완료 및 입력 대기는 포커스를 잃었을 때만 시스템 알림을 표시합니다.