에이전트용 임시 메일

AI 에이전트용 임시 메일

가입 없이 에이전트가 찾아서 자율적으로 사용할 수 있는 임시 이메일 API입니다. HTTPS만으로 받은 편지함 생성, 인증 코드 대기, 메시지 읽기, 원본 조회 및 메시지 삭제가 가능합니다.

가입 불필요API 키 불필요MCP 설치 불필요curl로 사용 가능

빠른 시작

# 사용 가능한 도메인 확인:
curl -s https://api.reusable.email/v1/agent-tempmail/domains

# 1. 비공개 임시 메일함을 만드세요. 가입이나 API 키가 필요하지 않습니다.
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes \
  -H 'Content-Type: application/json' \
  -d '{"prefix":"agent"}'

# 2. 인증 이메일이나 OTP 코드를 기다리세요.
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes/{address}/wait \
  -H 'Authorization: Inbox {token}' \
  -H 'Content-Type: application/json' \
  -d '{"codeOnly":true,"timeoutSeconds":60}'

# 3. 전체 메시지를 읽으세요.
curl -s https://api.reusable.email/v1/agent-tempmail/inboxes/{address}/messages/{id} \
  -H 'Authorization: Inbox {token}'

생성 응답

{
  "inbox": {
    "address": "agent-lx84a9-q3mz2@reusable.email",
    "domain": "reusable.email",
    "created": true,
    "type": "private",
    "isProtected": true,
    "retentionDays": 180
  },
  "password": "save-this-generated-password-securely",
  "token": "use-this-as-an-inbox-token",
  "tokenExpiresAt": "2026-06-09T18:30:00.000Z",
  "links": {
    "web": "https://reusable.email/agent-lx84a9-q3mz2%40reusable.email",
    "messages": "https://api.reusable.email/v1/agent-tempmail/inboxes/agent-lx84a9-q3mz2%40reusable.email/messages",
    "wait": "https://api.reusable.email/v1/agent-tempmail/inboxes/agent-lx84a9-q3mz2%40reusable.email/wait"
  }
}

대기 응답

{
  "status": "message",
  "inbox": { "address": "agent-lx84a9-q3mz2@reusable.email" },
  "message": {
    "id": 1842,
    "from": { "name": "Example", "address": "login@example.com" },
    "subject": "Your verification code",
    "intro": "Use code 123456 to continue.",
    "verificationCode": "123456"
  }
}

에이전트 인터페이스 명세

탐색 매니페스트는 /v1/agent-tempmail에서 확인할 수 있으며, 답변 엔진을 위해 llms.txt에도 제공됩니다.

메서드	경로	용도
GET	`/v1/agent-tempmail`	에이전트와 크롤러를 위한 탐색 매니페스트
GET	`/v1/agent-tempmail/domains`	사용 가능한 대체 도메인 나열
POST	`/v1/agent-tempmail/inboxes`	비밀번호로 보호된 개인 편지함 만들기
GET	`/v1/agent-tempmail/inboxes/{address}/messages`	받은 메시지 나열
POST	`/v1/agent-tempmail/inboxes/{address}/wait`	롱 폴링으로 메일 또는 코드 대기
GET	`/v1/agent-tempmail/inboxes/{address}/messages/{id}`	메시지 읽기
GET	`/v1/agent-tempmail/inboxes/{address}/messages/{id}/source`	원시 RFC 5322 소스 가져오기
DELETE	`/v1/agent-tempmail/inboxes/{address}/messages/{id}`	메시지 삭제

인증 절차

에이전트 받은 편지함으로 가입, 로그인, 비밀번호 재설정 및 평가판 확인 이메일을 받으세요.

브라우저 자동화

실제로 이메일을 수신할 수 있는 주소가 필요한 Playwright, Selenium 또는 브라우저 에이전트와 함께 사용하세요.

CI 및 QA

계정을 만들거나 인증 정보를 공유하지 않고 테스트 실행마다 독립적인 받은 편지함을 만드세요.

FAQ

가입 없이 누구나 비공개 받은 편지함을 무료로 만들 수 있습니다. 다른 도메인을 선택하려면 도메인 목록 엔드포인트에서 제공하는 도메인을 전달하세요. 에이전트 인터페이스는 수신 전용입니다. 대량으로 사용하거나 이메일을 발송하려면 일반 계정 기반 API를 이용하세요.

에이전트 받은 편지함에서 패스키를 사용할 수 있나요?+

예. 생성된 비밀번호로 로그인한 다음 받은 편지함 설정에서 패스키를 추가하세요. 개인 받은 편지함 양식의 키 버튼과 받은 편지함 잠금 해제 화면에서 패스키 로그인을 사용할 수 있습니다. 발급된 Inbox 토큰은 모든 에이전트 메일함 엔드포인트에서 사용할 수 있습니다. 패스키는 사용자의 직접적인 인증이 필요하므로, 무인 에이전트를 위해 비밀번호를 보관하고 만료된 토큰은 POST /v1/inbox/{address}/token과 JSON {"password":"..."}로 갱신하세요.

대체 도메인을 선택할 수 있나요?+

네. GET /v1/agent-tempmail/domains에서 사용 가능한 도메인을 확인할 수 있습니다. prefix 또는 로컬 부분 주소와 함께 domain을 전달하거나 전체 주소를 제공하세요. 이미 사용 중이거나 예약된 주소는 사용할 수 없습니다.

AI 에이전트가 회원가입 없이 사용할 수 있나요?+

네. 에이전트는 인증 없이 POST 요청 한 번으로 받은 편지함을 만들 수 있습니다. 응답에는 생성된 비밀번호와 Inbox 토큰이 포함됩니다. 생성된 모든 받은 편지함은 비공개입니다. 토큰이 만료된 후 일반 비공개 받은 편지함에 로그인할 수 있도록 비밀번호를 보관하세요.

MCP나 SDK 또는 별도의 설치가 필요한가요?+

아니요. HTTPS와 curl만으로 모든 인터페이스에 접근할 수 있습니다. 에이전트는 llms.txt 또는 /v1/agent-tempmail의 JSON 매니페스트를 통해 이 인터페이스를 찾을 수 있습니다.

에이전트가 이 API를 통해 이메일을 보낼 수 있나요?+

아니요. 가입이 필요 없는 에이전트 인터페이스는 메일 수신, 읽기, 대기, 원본 조회 및 삭제만 지원합니다. 이 공개 인터페이스에서는 이메일 발송을 지원하지 않습니다.

인증 코드는 어떻게 제공되나요?+

메시지 목록, 대기 및 상세 응답은 유효한 실험적 OTP-Token 헤더를 우선 사용하고, 없으면 텍스트에서 코드를 찾습니다. 헤더에서 추출한 코드에는 verificationCodeOrigin이 포함됩니다. 코드를 제출하기 전에 이 값의 스킴, 호스트, 포트가 의도한 대상과 정확히 일치하는지 확인하세요. 이 값은 발신자가 제공하며 발신자의 신원을 증명하지 않습니다. 발신자가 제공한 값으로 자동 이동하지 마세요.

에이전트가 생성한 받은 편지함은 얼마나 오래 보관되나요?+

에이전트가 만든 받은 편지함은 일반 비공개 받은 편지함과 같은 기능을 제공하며 메시지는 180일 동안 보관됩니다.