Tmailor Open API

테스트 및 자동화를 위한 임시 메일 API

코드에서 수신 전용 임시 이메일 주소를 만들고 수신된 메시지를 JSON으로 읽어 오세요. 각 주소는 삭제할 때까지 Tmailor 계정에 유지되며, API는 메시지에서 찾은 일회성 코드를 반환합니다.

마지막 업데이트: October 2026

요금제 및 한도 보기

  • REST 및 JSON
  • SDK, CLI 및 MCP 서버
  • 매월 무료 메일함 100개
  • 수신 전용, 메시지 24시간 보관
export TMAILOR_API_KEY="tmk_live_..."

# returns 201 with email, token, web.reuse_url
curl -s -X POST https://open-api.tmailor.com/v1/mailboxes \
  -H "Authorization: Bearer $TMAILOR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

주소를 만들고, 이메일을 기다린 뒤 코드를 확인하세요.

요청당이 아닌 메일박스당 결제

주소를 생성할 때만 메일박스 할당량이 사용됩니다. 주소 목록 조회, 받은 편지함 확인, 메시지 읽기 및 삭제에는 할당량이 사용되지 않습니다. 유료 요금제에는 일일 또는 월간 요청 할당량이 없으며, 분당 요청 제한만 있습니다.

예시: 주소 하나를 생성하고 받은 편지함을 25번 확인하는 OTP 테스트는 메일박스 하나를 사용합니다.

API 키에서 받은편지함까지 4단계

  1. API 키 생성

    tmailor.com 계정이나 Google 계정으로 API 플랫폼에 로그인하고 키를 생성하세요. 무료 요금제에서는 API를 호출할 서버 IP 주소 하나도 추가해야 합니다.

  2. 주소 생성

    요청을 한 번 보내 공유 도메인의 무작위 주소를 받거나, 소유하고 검증한 도메인에서 원하는 이름을 선택하세요.

  3. 메시지 읽기

    받은편지함 목록을 조회하고 각 메시지를 JSON으로 읽으세요. 발신자, 제목, 텍스트, 정리된 HTML, 그리고 API가 찾은 일회용 코드와 링크가 포함됩니다.

  4. 유지하거나 삭제하기

    주소는 만료되지 않습니다. 재사용 링크로 tmailor.com에서 같은 받은편지함을 열거나, 테스트가 끝나면 주소를 삭제하세요.

반복 가능한 이메일 워크플로우를 위한 설계

실제 메일함 하나를 공유하는 대신, 테스트 실행마다 전용 받은편지함을 제공하세요.

가입 및 OTP 테스트

가입, 비밀번호 재설정, 일회용 코드 확인마다 새 주소를 만들고 응답에서 코드를 읽으세요.

CI/CD 파이프라인

키를 환경 변수에 넣고 파이프라인에서 엔드투엔드 이메일 검사를 실행하세요. 유료 요금제는 모든 IP 주소의 요청을 허용합니다.

QA 및 스테이징

테스터와 스테이징 환경에 각자의 주소를 부여하고, 실제 받은편지함이 테스트 데이터에 섞이지 않게 하세요.

내 도메인의 주소

a domain you own을 추가하고 MX 레코드를 저희 쪽으로 지정한 뒤, 명명 규칙을 따르는 사용자 지정 이름으로 주소를 만드세요.

요금제 및 가격

필요한 메일박스 개수를 선택하세요. 연간 요금제에서도 허용량은 30일마다 초기화됩니다.

무료

API를 사용해 보고 작은 프로젝트를 진행해 보세요.

$0 /월

  • 30일마다 메일박스 100개
  • 분당 최대 30건의 요청
  • 하루 2,000건의 요청
  • 허용 목록에 등록된 IP 한 개에서 호출
  • 공유 도메인 및 자체 도메인
무료로 시작하기

스타터

개발자 한 명이나 소규모 테스트 스위트에 적합합니다.

$9 /월

  • 30일마다 메일박스 3,000개
  • 분당 최대 300건의 요청
  • 일일 및 월간 요청 할당량 없음
  • 모든 IP 주소에서 호출
  • 공유 도메인 및 자체 도메인
스타터 선택

Pro

매일 테스트를 실행하는 팀에 적합합니다.

$29 /월

  • 30일마다 메일박스 30,000개
  • 분당 최대 600건의 요청
  • 일일 및 월간 요청 할당량 없음
  • 모든 IP 주소에서 호출
  • 공유 도메인 및 자체 도메인
Pro 선택

비즈니스

매일 자동화를 많이 사용하는 기업에 적합합니다.

$99 /월

  • 30일마다 메일박스 150,000개
  • 분당 최대 2,000건의 요청
  • 일일 및 월간 요청 할당량 없음
  • 모든 IP 주소에서 호출
  • 공유 도메인 및 자체 도메인
비즈니스 선택

Scale

대규모 테스트 환경과 바쁜 파이프라인에 적합합니다.

$199 /월

  • 30일마다 메일박스 400,000개
  • 분당 최대 4,000건의 요청
  • 일일 및 월간 요청 할당량 없음
  • 모든 IP 주소에서 호출
  • 공유 도메인 및 자체 도메인
Scale 선택

Enterprise

최대 메일박스 용량과 최고 요청 속도가 필요한 경우

$499 /월

  • 30일마다 메일박스 2,000,000개
  • 분당 최대 6,000건의 요청
  • 일일 및 월간 요청 할당량 없음
  • 모든 IP 주소에서 호출
  • 공유 도메인 및 자체 도메인
Enterprise 선택

요금제 비교

이 한도는 요금제마다 다릅니다. 그 외의 모든 기능은 모든 요금제에서 동일합니다.

요금제 비교
요금제 무료스타터Pro비즈니스ScaleEnterprise
월 요금$0$9$29$99$199$499
연간 요금$0$90$290$990$1,990$4,990
30일마다 생성 가능한 메일박스1003,00030,000150,000400,0002,000,000
분당 요청 수303006002,0004,0006,000
일일 요청 한도2,000제한 없음제한 없음제한 없음제한 없음제한 없음
IP 허용 목록필수, 1 IP필요 없음필요 없음필요 없음필요 없음필요 없음
호스팅 MCP 서버로컬 서버만 지원포함포함포함포함포함

옆으로 밀어 모든 요금제를 비교하세요.

모든 요금제에 포함

  • JSON 응답을 지원하는 REST API
  • 공유 도메인의 무작위 주소
  • 직접 인증한 도메인에 원하는 이름 사용
  • 자체 도메인 무제한 (최대 3개까지 동시에 인증 대기 가능)
  • 만료되지 않는 주소
  • 보유할 수 있는 주소 수 무제한
  • 메시지는 24시간 동안 보관됩니다
  • 일회용 코드 및 링크 추출(최선 노력)
  • tmailor.com에서 받은 편지함을 여는 재사용 링크
  • 공식 SDK와 명령줄 도구
  • 요금제를 결합할 수 있으며 한도가 합산됩니다
  • 첨부 파일 없이 수신 전용
  • 주소를 삭제해도 할당량은 반환되지 않습니다
  • 메일함 할당량이 모두 소진되면 다음 주기가 시작되거나 업그레이드할 때까지 새 주소를 만들 수 없습니다. 기존 받은 편지함은 계속 사용할 수 있습니다.
  • 결제 금액은 API 약관에 따라 환불되지 않습니다. 먼저 무료 요금제에서 연동을 테스트해 보세요.

공식 SDK 및 CLI

타입이 지정된 모델, 자동 재시도, 다음 메시지를 기다리는 헬퍼를 통해 원하는 언어로 API를 호출하세요. 모든 SDK는 동일한 API와 공유 테스트 시나리오를 따릅니다.

Python

사용 가능

Python 3.9+

pip install tmailor-sdk

tmailor 명령줄 도구 포함.

Node.js

사용 가능

Node.js 18+, TypeScript types

npm install tmailor

PHP

사용 가능

PHP 8.1+

composer require tmailor/tmailor

AI 에이전트용

AI 에이전트용 MCP 서버

Claude, Cursor, VS Code Copilot 등 MCP 클라이언트로 본인이 소유하거나 테스트 권한이 있는 가입 흐름을 테스트하세요. 에이전트가 실제 수신 전용 주소를 만들고 이메일을 기다린 뒤 일회용 코드나 인증 링크를 읽습니다.

두 방법 모두 에이전트에게 동일한 도구를 제공합니다. 주소 생성, 이메일 대기 및 일회용 코드와 링크 확인, 메시지 읽기, 주소 삭제, 할당량 확인이 가능합니다. 에이전트는 이메일 주소만 볼 수 있고 그 뒤의 토큰은 볼 수 없으며, API와 동일한 메일박스 할당량과 속도 제한을 사용합니다.

호스팅 서버

설치 불필요

https://mcp.tmailor.com/mcp

AI 앱에 서버 URL을 추가하세요. Claude, ChatGPT, Codex처럼 로그인을 지원하는 앱은 접근 승인을 위해 Tmailor 플랫폼으로 안내합니다. 그 외 클라이언트는 Authorization 헤더에 API 키를 담아 보냅니다.

활성 유료 요금제가 필요합니다. 요청이 저희 서버에서 전송되므로 IP 허용 목록을 등록할 필요가 없습니다.

# Claude: add a custom connector with this URL,
# then approve access on the Tmailor platform
https://mcp.tmailor.com/mcp

# Claude Code, with your API key
claude mcp add --transport http tmailor \
  https://mcp.tmailor.com/mcp \
  --header "Authorization: Bearer tmk_live_..."

# Codex CLI, with your API key
export TMAILOR_API_KEY=tmk_live_...
codex mcp add tmailor \
  --url https://mcp.tmailor.com/mcp \
  --bearer-token-env-var TMAILOR_API_KEY

# Cursor (~/.cursor/mcp.json)
{"mcpServers": {"tmailor": {
  "url": "https://mcp.tmailor.com/mcp",
  "headers": {"Authorization": "Bearer tmk_live_..."}}}}

AI 연결 페이지에서 연결된 앱을 확인하고 원하는 앱의 연결을 해제하세요. 연결이 해제된 앱은 30초 이내에 접근 권한을 잃습니다.

로컬 서버

무료 요금제 포함 모든 요금제

tmailor-mcp

내 컴퓨터에서 실행되며 TMAILOR_API_KEY에서 키를 읽고 uv 또는 Python 3.10+가 필요합니다. 무료 플랜에서는 해당 컴퓨터의 IP를 허용 목록에 추가하세요.

# Claude Code
claude mcp add tmailor \
  -e TMAILOR_API_KEY=tmk_live_... \
  -- uvx tmailor-mcp

# Claude Desktop, Cursor, VS Code
#   command: uvx   args: ["tmailor-mcp"]

# without uv
pip install tmailor-mcp

이렇게 물어보세요: "임시 이메일을 만들어서 내 스테이징 사이트에 가입하고 인증 코드를 알려줘."

임시 메일 API FAQ

메일박스는 어떻게 계산되나요?

새로 만드는 주소마다 현재 30일 주기의 허용량에서 메일박스 하나를 사용합니다. 목록 조회, 읽기, 삭제는 메일박스를 사용하지 않으며, 주소를 삭제해도 메일박스는 반환되지 않습니다.

주소가 만료되나요?

아니요. 주소는 삭제할 때까지 계정에 남아 있습니다. 주소 안의 메시지는 24시간 동안 보관됩니다.

이메일을 보내거나 첨부파일을 받을 수 있나요?

아니요. API는 수신 전용이며 첨부파일은 전달되지 않습니다.

주소 이름과 도메인을 선택할 수 있나요?

공유 도메인에서는 이름이 무작위로 정해집니다. 이름을 선택하려면 API 플랫폼에서 소유한 도메인을 추가하고 MX 레코드를 저희 쪽으로 지정해 검증한 다음, 명명 규칙을 따르는 사용자 지정 이름으로 주소를 생성하세요.

IP 허용 목록이 필요한가요?

무료 요금제에서만 서버가 요청을 보내는 IP 주소 하나를 추가하면 됩니다. IP 주소는 하나의 무료 계정에만 등록할 수 있으므로, 공유 사무실이나 VPN 주소는 이미 사용 중일 수 있습니다. 유료 요금제가 활성화되어 있으면 API는 모든 IP 주소에서 요청을 받습니다.

API가 인증 코드를 대신 읽어주나요?

네, 최선의 노력으로 처리합니다. 메시지를 읽으면 응답에 찾은 일회용 코드(확실하지 않으면 null), 그 밖의 코드로 보이는 값과 링크가 포함됩니다. 항상 테스트에서 값을 확인하세요.

Claude나 ChatGPT 같은 AI 에이전트도 API를 사용할 수 있나요?

네, MCP를 통해 사용할 수 있습니다. 유료 요금제에서는 호스팅 서버 https://mcp.tmailor.com/mcp 를 AI 앱에 추가하고 접근을 승인하거나 API 키를 전송하세요. 모든 요금제에서 오픈소스 tmailor-mcp 서버를 직접 컴퓨터에서 실행할 수도 있습니다. 어느 방식이든 에이전트는 주소를 생성하고 이메일을 기다린 뒤 일회용 코드를 읽을 수 있으며, API와 동일한 메일박스 할당량을 사용합니다.

유료 요금제에 요청 한도가 있나요?

유료 요금제에는 일일 또는 월간 요청 할당량이 없지만, 요금제마다 분당 속도 제한이 있습니다. 무료 요금제에는 일일 요청 한도도 있습니다.

시작하려면 신용카드가 필요한가요?

아니요. tmailor.com 계정이나 Google로 로그인하고 키를 만든 후 무료 요금제로 시작하세요. 유료 요금제를 선택할 때만 결제하면 됩니다.

요금제는 어떻게 결제하나요?

TRC20(Tron) 또는 BEP20(BNB Smart Chain) 네트워크에서 USDT로 결제하거나 Binance Pay로 결제하세요. 신용카드와 체크카드는 사용할 수 없습니다. 요금제는 결제가 확인되면 활성화되며, 보통 몇 분 이내에 처리됩니다.

환불받을 수 있나요?

아니요. 결제 금액은 환불되지 않으므로 업그레이드 전에 무료 요금제에서 연동을 테스트해 보세요.

API를 사용할 수 없는 경우는 무엇인가요?

스팸, 사기, 다른 서비스에서 대량으로 계정을 생성하는 행위, 그리고 그 서비스의 차단이나 제한을 회피하는 행위는 API 약관을 위반합니다. 이런 행위를 하는 계정의 API 키를 취소하고 계정을 잠글 수 있습니다.

몇 분 만에 첫 주소를 만드세요

무료 플랜으로 시작해 한 달에 메일박스 100개를 이용하세요. 신용카드는 필요 없습니다.