개발자 센터

Once Email API 문서

자동 이메일 테스트를 위한 공개 문서: 인증, 할당량, 오류와 안전한 사용 규칙.

문서는 공개됩니다. API 키는 활성 Developer 구독에서만 제공되며 대시보드에서 관리합니다.
인증

모든 요청에 Authorization: Bearer oe_live_… 를 보냅니다. 키는 한 번만 표시되므로 Secret Manager에 저장하고 브라우저 코드, 로그, Git에 넣지 마세요.

Authorization: Bearer oe_live_your_key
일반 흐름
  1. 1임시 받은편지함을 만들고 ID를 보관합니다.
  2. 2테스트 시스템에서 해당 주소로 메일을 보냅니다.
  3. 3백오프로 목록을 조회하고 빠른 빈 폴링을 피합니다.
  4. 4대상 메일을 읽고 검증한 뒤 받은편지함을 삭제합니다.

비공개 베타 엔드포인트

POST /v1/inboxesGET /v1/inboxes/{inboxId}/messagesGET /v1/inboxes/{inboxId}/messages/{uid}GET /v1/inboxes/{inboxId}/messages/{uid}/attachments/{cid}DELETE /v1/inboxes/{inboxId}

상태 코드

400

잘못된 요청

401

키가 없거나 유효하지 않음

403

요금제 또는 리소스 거부

404

리소스를 찾을 수 없음

429

속도 또는 월간 할당량 도달

5xx

일시적인 서비스 장애

클라이언트 제공 상태

TypeScript 테스트 도구와 Python 클라이언트는 구현 기반이 있습니다. 설치 가능한 공개 패키지나 전 언어 SDK는 아직 제공하지 않습니다.

결제 상태

Developer는 Stripe 월 구독과 월간 API 할당량을 사용합니다. 충전식 잔액은 제공하지 않습니다. 결제와 환불 검증 전까지 Live 결제는 닫혀 있습니다.

허용되는 사용

권한이 있는 시스템 테스트에만 사용하세요. 스팸, 정책 우회, 계정 악용, 타인 통신 감시, 개인정보 장기 보관은 금지됩니다.

API는 운영 준비 중입니다
공개 계약을 먼저 제공합니다. 결제 Webhook, 할당량, 회귀 검증 후에만 키와 실제 호출을 엽니다.
가격 보기