TempMail

API 문서

TempMail API v1 레퍼런스

기본 URL

https://mail.taohuaxin.top

인증

/config를 제외한 모든 엔드포인트에 인증이 필요합니다.

모든 요청에 다음 헤더를 추가하세요:

x-api-key: tm_your_token_here

토큰 받기: 대시보드 → 설정 → API 키

엔드포인트

메서드경로설명
GET/api/v1/config서버 설정 (공개 — 인증 불필요)
GET/api/v1/me모든 메일박스의 이메일 조회 (롱 폴링)
GET/api/v1/inbox/:address단일 메일박스의 이메일 조회 (롱 폴링)
DELETE/api/v1/inbox/:address메일박스의 모든 이메일 삭제
GET/api/v1/email/:id전체 파싱된 이메일 가져오기 (텍스트 + HTML + 첨부파일)
GET/api/v1/email/:id/rendered렌더링된 이메일 텍스트 가져오기
GET/api/v1/email/:id/attachments/:attachmentIdID로 첨부파일 하나 다운로드
DELETE/api/v1/email/:id단일 이메일 삭제
GET/api/v1/domains사용자 지정 도메인 목록
POST/api/v1/domains사용자 지정 도메인 추가
DELETE/api/v1/domains/:id사용자 지정 도메인 제거

docs.examples

GET/api/v1/config

서버 설정 (공개 — 인증 불필요)

curl https://mail.taohuaxin.top/api/v1/config

docs.response

{
  "domains": ["taohuaxin.top"],
  "smtpPort": 25,
  "smtpsPort": 465,
  "mxPort": 25,
  "version": "1.0.0"
}
GET/api/v1/me

모든 메일박스의 이메일 조회 (롱 폴링)

curl -H "x-api-key: tm_your_token_here" \
  "https://mail.taohuaxin.top/api/v1/me?count=1&limit=20"

docs.response

{
  "emails": [
    {
      "id": "cmcg2a1b40001xyz",
      "fromAddress": "[email protected]",
      "subject": "Your verification code",
      "isRead": false,
      "receivedAt": "2026-07-10T08:30:00.000Z",
      "mailbox": { "address": "alice", "domain": "taohuaxin.top" }
    }
  ],
  "nextSince": "cmcg2a1b40001xyz"
}
GET/api/v1/inbox/:address

단일 메일박스의 이메일 조회 (롱 폴링)

curl -H "x-api-key: tm_your_token_here" \
  "https://mail.taohuaxin.top/api/v1/inbox/[email protected]?since=cmcg2a1b40001xyz&count=1"

docs.response

{
  "emails": [
    {
      "id": "cmcg9f2c80002abc",
      "fromAddress": "[email protected]",
      "subject": "Welcome!",
      "isRead": false,
      "receivedAt": "2026-07-10T09:00:00.000Z"
    }
  ],
  "nextSince": "cmcg9f2c80002abc"
}
DELETE/api/v1/inbox/:address

메일박스의 모든 이메일 삭제

curl -X DELETE -H "x-api-key: tm_your_token_here" \
  "https://mail.taohuaxin.top/api/v1/inbox/[email protected]"

docs.response

{ "success": true }
GET/api/v1/email/:id

전체 파싱된 이메일 가져오기 (텍스트 + HTML + 첨부파일)

curl -H "x-api-key: tm_your_token_here" \
  "https://mail.taohuaxin.top/api/v1/email/cmcg2a1b40001xyz"

docs.response

{
  "id": "cmcg2a1b40001xyz",
  "fromAddress": "[email protected]",
  "toAddress": "[email protected]",
  "subject": "Your verification code",
  "bodyHtml": "<p>Your code is <b>123456</b></p>",
  "bodyText": "Your code is 123456",
  "isRead": true,
  "receivedAt": "2026-07-10T08:30:00.000Z",
  "attachments": [
    { "id": "att_01", "filename": "invoice.pdf", "mimeType": "application/pdf", "size": 24580 }
  ]
}
GET/api/v1/email/:id/rendered

렌더링된 이메일 텍스트 가져오기

curl -H "x-api-key: tm_your_token_here" \
  "https://mail.taohuaxin.top/api/v1/email/cmcg2a1b40001xyz/rendered"

docs.response

From: [email protected]
To: [email protected]
Subject: Your verification code
Date: Fri, 10 Jul 2026 08:30:00 GMT

<p>Your code is <b>123456</b></p>
GET/api/v1/email/:id/attachments/:attachmentId

ID로 첨부파일 하나 다운로드

curl -OJ -H "x-api-key: tm_your_token_here" \
  "https://mail.taohuaxin.top/api/v1/email/cmcg2a1b40001xyz/attachments/att_01"

docs.response

HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="invoice.pdf"
Content-Length: 24580

<binary file stream>
DELETE/api/v1/email/:id

단일 이메일 삭제

curl -X DELETE -H "x-api-key: tm_your_token_here" \
  "https://mail.taohuaxin.top/api/v1/email/cmcg2a1b40001xyz"

docs.response

{ "success": true }
GET/api/v1/domains

사용자 지정 도메인 목록

curl -H "x-api-key: tm_your_token_here" \
  "https://mail.taohuaxin.top/api/v1/domains"

docs.response

[
  {
    "id": "dom_01",
    "domain": "mail.example.com",
    "verified": true,
    "receiveMode": "inherit",
    "createdAt": "2026-07-01T00:00:00.000Z"
  }
]
POST/api/v1/domains

사용자 지정 도메인 추가

curl -X POST -H "x-api-key: tm_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{"domain":"mail.example.com","receiveMode":"inherit"}' \
  "https://mail.taohuaxin.top/api/v1/domains"

docs.response

{
  "id": "dom_02",
  "domain": "mail.example.com",
  "verified": false,
  "receiveMode": "inherit",
  "createdAt": "2026-07-10T10:00:00.000Z"
}
DELETE/api/v1/domains/:id

사용자 지정 도메인 제거

curl -X DELETE -H "x-api-key: tm_your_token_here" \
  "https://mail.taohuaxin.top/api/v1/domains/dom_02"

docs.response

{ "success": true }

롱 폴링

메일박스 엔드포인트는 롱 폴링을 지원합니다. 한 번 호출하면 서버가 메일 도착까지 대기합니다(최대 25초). 타임아웃까지 메일이 도착하지 않으면 204를 반환합니다.

쿼리 매개변수

매개변수설명
since이전 응답의 커서；이 시점 이후의 메일만 반환됩니다
countN개의 새 이메일이 도착하면 반환 (기본값 1, 최대 50)
limit응답 본문당 최대 이메일 수 (기본값 20, 최대 50)
from필터 — From에 이 문자열이 포함된 메일만 반환
subject필터 — Subject에 이 문자열이 포함된 메일만 반환

삭제 동작

모든 DELETE 작업은 소프트 삭제입니다: 삭제된 항목은 사용자에게 숨겨지지만 감사 목적으로 관리자에게는 계속 접근 가능합니다.