개발자용 API

받은편지함 생성

POST https://10genmail.com/api/inbox

요청 본문 없음. 새 주소와 빈 메일 목록을 반환합니다.

{
  "address": "quick-fox-abc123@10genmail.com",
  "slug": "quick-fox-abc123",
  "createdAt": 1234567890123,
  "expiresAt": 1234568490123,
  "ttlSeconds": 600,
  "messages": []
}

Rate limit: IP당 분당 10회.

받은편지함 조회

GET https://10genmail.com/api/inbox?address=...

쿼리: address(URL 인코딩된 이메일). 받은편지함과 메일을 반환합니다. 만료 시 404.

{
  "address": "quick-fox-abc123@10genmail.com",
  "slug": "quick-fox-abc123",
  "createdAt": 1234567890123,
  "expiresAt": 1234568490123,
  "ttlSeconds": 420,
  "messages": [
    {
      "id": "msg-...",
      "from": { "name": null, "email": "sender@example.com" },
      "subject": "Hello",
      "text": "...",
      "html": null,
      "date": "...",
      "timestamp": 1234567900000
    }
  ]
}

Rate limit: IP당 분당 120회.

만료 연장

POST https://10genmail.com/api/inbox/extend

본문: { "address": "..." }. 10분 연장. 생성 시점부터 총 30분까지. 갱신된 받은편지함을 반환합니다.

Rate limit: 조회와 동일(120/분).