사서함 설정

API 0.16.0OpenAPIllms-full.txt

메일 템플릿

메일함당 템플릿은 최대 100개입니다. 필드: name, subject, text, html. HTML은 정제됩니다. 템플릿 자체는 메일을 보내지 않습니다.

템플릿이 편집기 본문을 대체합니다. 받는 사람과 첨부 파일은 유지됩니다.

POST /v1/mailboxes/42/templates
Content-Type: application/json

{"name":"Welcome","subject":"Welcome","text":"Thank you for joining us.","html":"<p>Thank you for joining us.</p>"}

자동 응답

브라우저가 닫혀 있어도 자동 응답이 전송되며 발송 한도에 포함됩니다. 메일링 리스트와 자동 메시지에는 응답하지 않습니다.

자동 응답 날짜에는 시간대를 포함하세요. repeat_days는 1~30입니다. 새로운 개인 메일에만 응답하며 From이 Return-Path와 일치해야 합니다.

PUT /v1/mailboxes/42/autoresponder
Content-Type: application/json

{"enabled":true,"subject":"Away","text":"I will reply when I return.","starts_at":null,"ends_at":null,"repeat_days":7}

필터

메일함당 필터는 최대 100개, 필터당 조건은 최대 20개입니다. 전체 헤더를 비교하며 ASCII는 대소문자를 구분하지 않고 다른 문자는 구분합니다.

처음 일치하는 필터가 적용됩니다. 발신자 규칙이 우선하며 기존 메일 처리는 별도로 실행합니다.

필터 변경 시 operation을 반환합니다. 기존 메일에 적용하려면 8~120자의 Idempotency-Key가 필요합니다. 재시도할 때 같은 키를 사용하고 GET /v1/operations/{operation_id}로 상태를 확인하세요.

받은편지함과 사용자 폴더를 처리합니다. 보낸편지함, 임시보관함, 스팸 및 휴지통은 제외됩니다.

POST /v1/mailboxes/42/filters
Content-Type: application/json

{"name":"Invoices","enabled":true,"match":"all","conditions":[{"field":"subject","operator":"contains","value":"Invoice"}],"mark_read":false,"important":true,"trash":false,"move_to":null}

POST /v1/mailboxes/42/filters/17/apply
Idempotency-Key: apply-filter-0001

시사

file_infected

위협이 발견되어 파일 열기가 차단되었습니다.

file_scan_unavailable

바이러스 검사를 일시적으로 사용할 수 없습니다. 나중에 다시 시도하세요.

DOC, XLS, XLSX, PPT, PPTX, ODT 파일이나 첨부파일의 내용 요청에 preview=pdf를 추가하세요. 메일함당 분당 최대 10회 변환할 수 있습니다.

X-File-Scan: clean과 X-File-Scanned-At은 검사 결과와 시간을 나타냅니다. 파일 목록의 scanned_at은 null일 수 있습니다. 결과는 한 시간 동안 캐시되며 위협이 있거나 검사기를 사용할 수 없으면 파일을 제공하지 않습니다.

GET /v1/mailboxes/42/files/<file_id>/content?preview=pdf

X-File-Scan: clean
X-File-Scanned-At: 2026-10-22T12:00:00Z