API 문서

GPTMail API

GPTMail API를 사용하면 X-API-Key 헤더와 HTTPS로 임시 메일함을 생성하고, 메일을 조회·읽기·삭제할 수 있습니다. 자동화 테스트, CI/CD 파이프라인, QA 워크플로에 적합합니다.

API Key 받는 방법

Buy API requests

Purchase API requests with GPTMail points. Earn points through daily check-ins and public domains, or buy points with LDC at a 1:1 rate.

Buy with points / add requests

방법 2: 자체 도메인 추가

공개 도메인의 MX 검증 후: 로그아웃 상태에서 제출 → API 키(20000회 요청); 로그인 상태에서 제출 → 200포인트. 도메인마다 한 가지 보상만 받습니다. 중요: 연결 후 해당 도메인 접미사는 이 사이트의 모든 사용자에게 공개되는 접미사가 되어 다른 사용자도 그 아래에서 메일 주소를 만들 수 있습니다. 활성화 후 이 서비스를 가리키는 MX 레코드를 삭제·교체·수정하지 마세요. 그렇지 않으면 이후 점검에서 도메인이 잘못 구성된 것으로 처리될 수 있습니다. 이후 점검에서 MX가 유효하지 않으면 도메인이 비활성화됩니다. MX가 3회 연속 유효하지 않으면 연결된 API Key도 비활성화됩니다. 나중에 MX가 다시 유효해지면 도메인은 자동으로 다시 활성화됩니다.

도메인

공개 테스트 키

테스트할 때는 아래에 표시된 공유 공개 키를 X-API-Key 헤더로 보내세요. 이 키는 매일 바뀌며, 모든 사용자가 함께 쓰는 일일 한도는 200,000회 요청입니다.

오늘 남은량

초기화까지

공개 키의 실시간 할당량을 불러오는 중…

아래 API 참고 문서는 Markdown으로 복사해 AI 도구, 지식 베이스 또는 README에 사용할 수 있습니다.

기본 URL: https://mail.chatgpt.org.uk

AI
llms.txt

·

llms-full.txt

(Markdown)

빠른 시작

  • X-API-Key: YOUR_KEY가 가장 간단한 방법입니다. 빠른 테스트에는 YOUR_KEY 대신 위에 표시된 일일 공개 키를 사용하세요.

  • 대부분의 메일함 엔드포인트는 email 매개변수가 필요합니다. 예: ?email=demo@example.com.

  • GPTMail API 응답은 success, data, error 필드를 가진 JSON이며, API 키를 사용하면 usage도 포함됩니다. 속도 제한 응답을 포함한 Cloudflare 오류는 HTML을 반환할 수 있습니다. JSON을 파싱하기 전에 HTTP 상태와 Content-Type을 확인하세요.

  • 이 사이트에서 현재 지원되는 도메인을 이미 알고 있다면 메일 생성 엔드포인트를 먼저 호출할 필요가 없습니다. 로컬에서 prefix@domain을 조합해 메일함 API를 바로 호출하면 API 요청을 한 번 줄일 수 있습니다.

요청 속도 제한 및 재시도

  • GET 및 POST /api/generate-email은 출발지 IP별로 10초당 30회 요청 제한을 함께 사용합니다. 이 제한은 공개 키와 개인 API 키 모두에 적용됩니다. 같은 IP를 쓰는 서로 다른 키와 클라이언트는 이 제한을 공유합니다.

  • 이 제한을 초과하면 HTTP 429가 반환되고 10초 동안 이메일 생성이 차단됩니다. 다시 시도하기 전에 Retry-After에 지정된 시간만큼 기다리세요. 이 헤더가 없으면 최소 10초를 기다린 뒤 간격을 점점 늘리며 재시도하세요. 같은 IP를 공유하는 클라이언트가 동시에 재시도하지 않도록 하세요.

  • 이 규칙은 메일함 목록 조회나 개별 메일 읽기에는 적용되지 않습니다. API 키의 일일 및 총 할당량은 별도로 계속 적용됩니다. 10초를 기다려도 소진된 키 할당량은 복구되지 않습니다.

핵심 엔드포인트

POST / GET
/api/generate-email

임시 받은편지함을 생성합니다. 가장 단순한 무작위 흐름에는 GET을, prefix와 domain을 명시하려면 POST를 사용하세요.

GET
/api/emails?email=...

메일함의 메일을 가져옵니다.

GET
/api/email/{id}?email=...

텍스트, HTML, 원시 헤더, 메타데이터를 포함한 단일 메일을 가져옵니다.

DELETE
/api/email/{id}?email=...

ID로 메일 한 통을 삭제합니다.

DELETE
/api/emails/clear?email=...

메일함의 모든 메일을 삭제합니다.

GET
/api/stats

사이트 전체 통계를 조회합니다.

예시 흐름

자주 쓰는 패턴은 두 가지입니다. 서비스에 받은편지함 생성을 맡기거나, 고정 접두사를 요청하는 방식입니다. 현재 지원되는 도메인을 이미 알고 있다면 로컬에서 메일함 주소를 조합해 바로 조회할 수도 있습니다.

1) 무작위 임시 메일 주소 생성

curl 'https://mail.chatgpt.org.uk/api/generate-email' \
  -H 'X-API-Key: PUBLIC_API_KEY'
응답 예시
{
  "success": true,
  "data": {
    "email": "a3f9c2b1@example.com"
  },
  "usage": {
    "daily_limit": 200000,
    "used_today": 1,
    "remaining_today": 199999,
    "total_limit": 200000,
    "total_usage": 1,
    "remaining_total": 199999
  }
}

2) 고정 접두사로 생성 (예: demo@example.com)

curl -X POST 'https://mail.chatgpt.org.uk/api/generate-email' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: PUBLIC_API_KEY' \
  -d '{"prefix":"demo"}'
응답 예시
{
  "success": true,
  "data": {
    "email": "demo@example.com"
  },
  "usage": {
    "daily_limit": 200000,
    "used_today": 2,
    "remaining_today": 199998
  }
}

3) 받은편지함의 메일 목록

지원되는 도메인을 이미 알고 있으면 1단계를 건너뛰고 바로 조회하세요.

curl 'https://mail.chatgpt.org.uk/api/emails?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
응답 예시
{
  "success": true,
  "data": {
    "emails": [
      {
        "id": "e5a7f3...",
        "email_address": "demo@example.com",
        "from_address": "noreply@github.com",
        "subject": "Your code: 654321",
        "content": "Your verification code is 654321",
        "html_content": "...",
        "has_html": true,
        "timestamp": 1709654321,
        "created_at": "2024-03-05T12:18:41Z"
      }
    ],
    "count": 1
  }
}

4) 메일 한 통 읽기 — 일반 텍스트, HTML 본문, 메타데이터 포함

EMAIL_ID를 3단계에서 반환된 id로 바꾸세요. 메일함 주소도 email로 함께 전달하면(삭제와 첨부 파일 다운로드도 마찬가지) ID로 검색하지 않고 해당 메일함에서 바로 메일을 읽습니다. API 키를 사용하면 email 파라미터는 선택 사항이지만, 전달하면 조회가 더 빨라집니다.

curl 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
응답 예시
{
  "success": true,
  "data": {
    "id": "e5a7f3...",
    "email_address": "demo@example.com",
    "from_address": "noreply@github.com",
    "subject": "Your code: 654321",
    "content": "Your verification code is 654321",
    "html_content": "<p>Your code is 654321</p>",
    "has_html": true,
    "timestamp": 1709654321,
    "raw_size": 2048,
    "created_at": "2024-03-05T12:18:41Z"
  }
}

5) ID로 메일 한 통 삭제

API 키를 사용하면 email 파라미터는 선택 사항이지만, 전달하면 조회가 더 빨라집니다.

curl -X DELETE 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
응답 예시
{
  "success": true,
  "data": {
    "message": "Email deleted"
  }
}

6) 받은편지함 전체 비우기 — 이 주소의 모든 메일 삭제

호출할 때마다 한 배치가 삭제됩니다. 응답에 "has_more": true가 있는 동안 false를 반환할 때까지 다시 호출하세요.

curl -X DELETE 'https://mail.chatgpt.org.uk/api/emails/clear?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
응답 예시
{
  "success": true,
  "data": {
    "message": "Deleted 3 emails",
    "count": 3,
    "has_more": false
  }
}

응답 구조

성공 응답은 대개 다음과 같은 형태입니다. API Key로 인증한 경우 usage 안의 할당량 정보를 확인하세요.

{
  "success": true,
  "data": {
    "email": "demo@example.com"
  },
  "usage": {
    "daily_limit": 200000,
    "used_today": 1,
    "remaining_today": 199999,
    "total_limit": 200000,
    "total_usage": 1,
    "remaining_total": 199999
  }
}

확장 통계

  • /api/statistics/24h 24시간 단위의 시간대별 분포 창 하나를 반환합니다. 이전 창은 offset=1,2,...를 사용하세요.
  • /api/statistics/top-subjects 가장 많은 메일 제목을 반환합니다.
  • /api/statistics/top-domains 가장 활발한 도메인을 반환합니다.
  • /api/statistics/top-senders 가장 활발한 발신자를 반환합니다.
GPTMail