문서로 건너뛰기
API

메일이 들어오는 방식 읽기

메일이 어떻게 들어오는지, 앱의 분석 페이지가 보여 주는 그대로.

GET/analytics/mailbox

워크스페이스에 실제 호출을 실행합니다.

GET /analytics/mailbox

메일이 어떻게 들어오는지, 앱의 분석 페이지가 보여 주는 그대로.

예시

threads:read가 필요합니다. 기간은 from과 to로 따로 정하지 않으면 최근 30일이며, 일 단위로 나뉘고 grain을 쓰면 시간이나 분 단위로 나뉩니다. 읽는 사람의 UTC 기준 동쪽으로의 분 단위 오프셋인 offsetMinutes를 넘기면 하루가 읽는 사람의 하루와 같은 지점에서 끊깁니다.

curl
curl "$OE/analytics/mailbox?offsetMinutes=120" -H "$AUTH"
응답
{  "object": "mailbox_insights",  "from": "2026-09-02T09:00:00.000Z",  "to": "2026-10-02T09:00:00.000Z",  "grain": "day",  "offsetMinutes": 120,  "scanned": 486,  "days": [    { "day": "2026-09-30", "count": 21 },    { "day": "2026-10-01", "count": 17 }  ],  "hours": [    { "hour": 9, "count": 64 },    { "hour": 14, "count": 51 }  ],  "addresses": [{ "address": "[email protected]", "count": 301 }],  "senders": [    {      "email": "[email protected]",      "name": "Ada Lovelace",      "count": 18,      "lastAt": "2026-10-01T16:20:11.000Z"    }  ],  "senderCount": 132,  "waiting": [    { "band": 1, "count": 6 },    { "band": 3, "count": 2 },    { "band": 7, "count": 1 }  ],  "unattributed": 0,  "folders": [{ "label": "inbox", "count": 412, "unread": 9 }],  "series": []}

scanned는 기간 안에 들어온 대화를 셉니다. days는 대화를 구간별로, hours는 하루의 시간대별로 나누며, addresses는 들어온 주소별로 세고, senders는 가장 많이 보낸 사람들을 꼽습니다. waiting은 1일, 3일, 7일이 지나도 아직 답장을 기다리는 대화를 세고, folders는 각 폴더에 무엇이 있는지 보여 줍니다.

특정 주소로 제한된 키나 앱은 그 주소로 들어온 메일만 셉니다. address는 모든 것을 한 주소로 좁히며, 키가 닿지 않는 주소는 실패하는 대신 아무것도 세지 않습니다.

레퍼런스