개발자

TempMail API로 구축하기

HTTP를 통해 편지함을 생성하고 인증 코드를 조회하세요. 계정 없이 바로 시작하거나, API 키를 생성하여 Pro 기능을 이용할 수 있습니다.

로그인 불필요 · API 키 불필요

익명으로 바로 시작하기

TempMail 웹 앱과 동일한 API입니다. 모든 편지함은 임의의 주소를 부여받으며 24시간 동안 유지됩니다.

  1. 1POST /accounts: 임의의 주소와 비밀번호로 편지함을 생성합니다.
  2. 2POST /token: 주소와 비밀번호를 tm_box_ 편지함 토큰으로 교환합니다.
  3. 3GET /messages: 수신된 메일을 반환하며 인증 코드가 미리 추출되어 제공됩니다.
BASE=https://www.tempmail.ai/api/v1

# 1. Create a mailbox (random address + password)
curl -s -X POST "$BASE/accounts" \
  -H "Content-Type: application/json" -d '{}'
# {"id":"…","address":"k3x9m2q7…@tempmail.ai","password":"…","expires_at":"…"}

# 2. Exchange the credentials for a mailbox token
curl -s -X POST "$BASE/token" \
  -H "Content-Type: application/json" \
  -d '{"address":"ADDRESS","password":"PASSWORD"}'
# {"id":"…","token":"tm_box_…","token_type":"Bearer","expires_at":"…"}

# 3. Read messages – verification codes are already extracted
curl -s "$BASE/messages" -H "Authorization: Bearer TOKEN"
# {"items":[{"from":"[email protected]","subject":"Your verification code","verification_code":"482913",…}],"total":1,…}
전체 API 레퍼런스 읽기
Pro

Pro 기능을 위한 API 키

tm_live_ API 키는 TempMail 계정에 귀속됩니다. 계정이 Pro 상태인 동안 동일한 키로 다음 혜택을 이용할 수 있습니다:

  • 커스텀 주소: API 키 및 "address" 필드와 함께 POST /accounts 요청
  • 상향된 한도: 초당 20회 요청 및 하루 1000개의 신규 편지함 생성
  • 만료되지 않는 비공개 주소 최대 10개
  • 메일 보관 기간 30일 및 100 MB 저장 공간

Free 계정에서도 키를 생성할 수 있습니다. 업그레이드 전까지는 익명 API와 동일하게 동작하며, 코드 변경 없이 그대로 이용 가능합니다.