API 문서

키를 가지고 있지 않다면, 방문자는 익명으로 호출될 수 있으며, 임시 이메일 주소의 생성 및 읽기는 전혀 무료입니다. 만약 API 기능이 포함된 패키지를 구매했다면, 회원센터에서 개발자 API 키를 직접 생성할 수 있습니다. 이 키를 사용하여 호출하면 해당 패키지의 저장 용량과 유지 기간을 즐길 수 있습니다.

수납 방법 (두 가지 중 하나를 선택하세요)

요청 예시

curl "https://www.mail0.vip/mail/gen?key=YOUR_API_KEY"

임시 이메일 주소를 무작위로 생성합니다. 주소가 생성된 후에는 바로 메일을 받을 수 있으며, 사전에 활성화할 필요는 없습니다.

요청 매개변수

요청 예시

curl "https://www.mail0.vip/mail/gen?domain=ideciphera.com&ttl=60"

응답 예시

{
  "code": 1,
  "address": "k3j8fh2ma@ideciphera.com"
}

사용자 정의 프리픽스를 가진 주소(프리픽스@도메인명)를 활성화하여, 해당 도메인이 메일 수신을 허용하는지 확인합니다.

요청 매개변수

요청 예시

curl -X POST "https://www.mail0.vip/mail/activate" \
  -d "address=mybox@ideciphera.com&ttl=60"

응답 예시

{
  "code": 1,
  "address": "mybox@ideciphera.com"
}

지정된 주소의 받은 편지함을 가져옵니다(최근 50개의 메시지, 수신 시간 순서대로 정렬됩니다). 1~3초마다 한 번씩 피드백하는 것이 좋습니다.

요청 매개변수

요청 예시

curl "https://www.mail0.vip/mail/inbox?address=mybox@ideciphera.com"

응답 예시

{
  "code": 1,
  "exists": 1,
  "address": "mybox@ideciphera.com",
  "list": [
    {
      "id": 1024,
      "from_addr": "noreply@example.com",
      "from_name": "Example",
      "subject": "Your verification code is 826413",
      "size": 2048,
      "is_read": 0,
      "attachments": 0,
      "received_at": "2026-10-14 18:20:31"
    }
  ]
}

메일 내용을 확인할 수 있습니다. 발신자, 제목, 본문, 첨부파일 목록 등을 확인할 수 있습니다. 확인 후 메일은 읽음으로 표시됩니다.

요청 매개변수

요청 예시

curl "https://www.mail0.vip/mail/view?address=mybox@ideciphera.com&id=1024"

응답 예시

{
  "code": 1,
  "data": {
    "id": 1024,
    "from_addr": "noreply@example.com",
    "from_name": "Example",
    "subject": "Your verification code is 826413",
    "body_text": "Dear user, your verification code is 826413, valid for 5 minutes.",
    "received_at_fmt": "2026-10-14 18:20:31",
    "attachments": [
      { "id": 88, "filename": "invoice.pdf", "size": 102400 }
    ]
  }
}

이메일 첨부파일을 다운로드합니다 (직접 파일 스트림으로 전송되며, JSON 형식이 아닙니다).

요청 매개변수

요청 예시

curl -O "https://www.mail0.vip/mail/attach?id=88"

해당 주소를 자신의 계정에 저장하여 장기간 보관할 수 있습니다 (로그인하거나 API 키를 가지고 있어야 합니다). 저장 가능한 주소의 수는 “저장 가능한 이메일” 패키지의 제한 사항에 따라 결정됩니다.

요청 매개변수

요청 예시

curl -X POST "https://www.mail0.vip/mail/save" \
  -d "address=mybox@ideciphera.com&key=YOUR_API_KEY"

귀하의 계정에 저장된 이메일 주소들을 나열해 주세요. 로그인해야 하거나 API 키를 가지고 있어야 합니다.

요청 예시

curl "https://www.mail0.vip/mail/my?key=YOUR_API_KEY"

아래 스크립트는 브라우저 콘솔이나 Node 환경에서 직접 실행할 수 있습니다: 주소 생성, 받은 메일을 순서대로 처리하며, 첫 번째 메일이 도착하면 인증 코드를 출력합니다.

// 1. 임시 주소를 생성합니다
const BASE = 'https://www.mail0.vip';
const gen = await (await fetch(BASE + '/mail/gen')).json();
const address = gen.address;
console.log('제 임시 이메일 주소:', address);

// 2. 수신함을 순환적으로 확인합니다 (2초마다 한 번씩, 첫 번째 메시지를 받으면 중단됩니다)
const seen = new Set();
while (true) {
  const d = await (await fetch(BASE + '/mail/inbox?address=' + encodeURIComponent(address))).json();
  for (const m of d.list || []) {
    if (seen.has(m.id)) continue;
    seen.add(m.id);
    const code = (m.subject || '').match(/\d{4,8}/);
    console.log('새로운 이메일:', m.subject, code ? 'CAPTCHA ' + code[0] : '');
  }
  await new Promise(r => setTimeout(r, 2000));
}