메시엄 프리미엄 API

프리미엄 이용 기간에 본인 계정의 대화와 첨부를 조회합니다. 메시지 발송은 제공하지 않습니다.

계정 설정에서 키를 만들고 Authorization: Bearer YOUR_API_KEY 헤더를 전송하세요. 로그인 비밀번호와 수집기 토큰은 사용할 수 없습니다.

대화 조회

curl -H "Authorization: Bearer YOUR_API_KEY" "https://messeum.moram.net/api/v1/messages?limit=100"

limit은 1~100입니다. conversation, channel, q로 검색합니다. hasMore가 true이면 nextCursor.sentAt을 before, nextCursor.id를 beforeId, nextCursor.revision을 cursorRevision으로 전송합니다. ARCHIVE_CURSOR_STALE(409)이면 첫 페이지부터 다시 조회하세요.

첨부 다운로드

GET /api/v1/attachments/{id}

첨부 식별자는 대화 조회 응답에서 확인합니다. read:attachments 권한이 필요합니다.

한도와 오류

계정 전체 월 100,000회·분당 60회. 월 한도는 UTC 기준 매월 초기화됩니다. 401: 잘못되거나 폐기·만료된 키, 403: 이용 기간 또는 권한 부족, 404: 본인 첨부 없음, 429: 한도 초과. Retry-After 헤더를 확인하세요.

데이터는 서버에서 복호화됩니다. 연동 프로그램의 접근 권한과 보관 책임을 확인하세요.

Webhook

계정에서 HTTPS 수신 URL을 등록하세요. 본문은 id, type(archive.messages.created), createdAt, messageCount만 제공합니다. 이벤트 ID로 중복을 제거하고 필요할 때 API로 내용을 조회하세요.

X-Messeum-Timestamp가 현재 시각에서 5분 이내인지 확인한 후, 등록 시 받은 비밀키로 HMAC-SHA256(timestamp + "." + eventId + "." + 원본 요청 본문)을 계산해 X-Messeum-Signature의 sha256= 뒤 값과 상수 시간 비교하세요. X-Messeum-Event-Id도 서명에 사용합니다. JSON을 다시 직렬화하면 서명이 달라집니다.

2xx 응답이 성공입니다. 실패 시 지수 간격으로 최대 8회 시도하며, 동일 이벤트가 여러 번 도착할 수 있습니다. 수신 URL당 대기 1,000개를 넘으면 변경 알림을 합산하며 archive.changed·coalesced·resyncRequired가 포함됩니다. 합산 건수는 변경량 안내이며 본문은 API로 다시 동기화하세요. 수집 데이터 저장은 알림 장애로 중단하지 않으므로, 알림 누락 가능성을 대비해 정기적으로 API를 조회하세요. 성공·재시도 종료 기록은 30일 뒤 정리합니다. 리다이렉트와 내부망 주소는 지원하지 않습니다. 프리미엄 기간이 끝나면 전송하지 않습니다.