빠른 설정 체크리스트
- 대시보드 API 관리 페이지를 열고 개인 API 키를 생성합니다.
- 표시된 사용자 API 기본 URL을 정확하게 복사합니다. 예를 들어 https://v1.tempmailg.com/api.
- 모든 요청을 해당 API 호스트로 보내고 Authorization: Bearer YOUR_USER_API_KEY 및 Accept: application/json.
- 동일한 대시보드 페이지와 사용자 API 응답에 할당량 헤더가 제공되는 경우 해당 헤더에서 월별 요청 할당량을 추적하세요. 성공적인 2xx 요청만이 할당량에 포함됩니다.
인증 흐름
- 대시보드의 API 관리 페이지에서 개인 API 키를 생성하세요.
- 모든 요청에 Bearer 토큰으로 키를 전송하세요.
- API 관리 페이지에 표시된 사용자 API 기본 URL을 사용하세요.
- 이전 키를 무효화하고 즉시 새로운 키를 사용하려면 언제든지 키를 재생성하세요.
필수 헤더
Authorization: Bearer YOUR_USER_API_KEY
Accept: application/json
속도 제한 및 할당량 헤더
Rate-limit 헤더는 표시된 요청 예산을 설명합니다. 할당량 정보가 있을 때는 Quota 헤더가 포함됩니다; minute-limit 거부는 전체 월별 할당량을 계산하지 않습니다.
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1729520000
X-Quota-Limit: 50000
X-Quota-Remaining: 48210
X-Quota-Used: 1790
X-Quota-Reset: 2026-11-01T00:00:00+00:00
X-RateLimit-Scope: account
Retry-After: 42 (when a timed retry is available)
X-RateLimit-Limit— 플랜당 분당 허용되는 최대 요청 수 (RPM).X-RateLimit-Remaining— 현재 분 윈도우에 남은 RPM 요청 수.X-RateLimit-Reset— 현재 분당 속도 제한 창이 재설정되는 Unix 타임스탬프.X-Quota-Limit— 귀하의 계정에 대한 총 월별 및 구매한 크레딧 용량.X-Quota-Remaining— 현재 달에 남은 사용 가능한 API 요청 수.X-Quota-Used— 현재 청구 기간 동안 사용된 총 API 요청 수.X-Quota-Reset— 월 할당량이 재설정되는 ISO-8601 타임스탬프.X-RateLimit-Scope— 헤더인 account, ip, status_endpoint, 또는 mailbox에 의해 설명된 예산.X-Mailbox-RateLimit-*— 별도의 사서함 생성/업데이트 예산. 성공적인 사서함 응답은 X-RateLimit-*에 계정 RPM을 유지합니다; 사서함 전용 거부는 사서함 범위와 자체 재시도 창을 사용합니다.Retry-After— 시간 제한 재시도가 적절해질 때까지의 초. 비활성화된 플랜이나 할당량이 소진된 경우 대신 계정 변경이 필요할 수 있으므로 이 헤더가 항상 존재하는 것은 아닙니다.503 protection_unavailable— API 보호 저장소 또는 조정이 일시적으로 사용할 수 없습니다. 나중에 다시 시도하십시오; 이는 결제 실패나 신용 차감이 아닙니다.
사서함 관리
허용된 도메인을 가져오기, 메일함을 만들거나 전환하기, 허용된 수명을 선택하기, 그리고 소유한 주소를 삭제하기.
허용된 도메인 목록
임시 이메일을 만들기 위해 사용 가능한 도메인을 나열합니다. 구독 플랜에서 지원하는 무료, 프리미엄 또는 맞춤 도메인만 보려면 유형별로 필터링하세요.
| 매개변수 | 위치 | 유형 | 상태 | 설명 |
|---|---|---|---|---|
type
|
query | string | 선택 사항 |
도메인 티어 필터. 생략 시 프리미엄 도메인 접근이 활성화된 경우 전체를 사용하고, 그렇지 않으면 무료를 사용합니다. 인식되는 값: free, basic, pro, premium, custom, ultimate, all
기본:
계정 종속
|
const response = await fetch('https://v1.tempmailg.com/api/domains?type=free', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/domains?type=free', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/domains?type=free');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request GET \
--url 'https://v1.tempmailg.com/api/domains?type=free' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
합성 데이터를 사용한 예시 응답입니다. ID, 주소, 토큰, 타임스탬프, 플랜 제한 및 카운트는 다양합니다. 샘플 수명은 플랜 기본값을 대체하지 않습니다. 응답 필드 설명은 nullable 및 제공자별 필드를 식별합니다.
예시 응답
200 OK • JSON{
"status": true,
"data": {
"requested_type": "free",
"plan": "pro",
"plan_name": "Pro Plan",
"allowed_types": [
"free",
"basic",
"pro",
"premium",
"custom",
"ultimate",
"all"
],
"domains": [
{
"domain": "example.com",
"type": "Free",
"custom": false
}
]
}
}
| 필드 | 유형 | 설명 |
|---|---|---|
status |
boolean | 작업이 성공했는지 여부. |
data.requested_type |
string | 도메인 필터가 적용되었습니다. |
data.plan |
string | 현재 플랜 태그. |
data.plan_name |
string | 현재 플랜의 읽을 수 있는 이름. |
data.allowed_types |
array<string> | 이 계정에서 사용할 수 있는 도메인 필터. 인식된 필터도 플랜에 따라 금지될 수 있습니다. |
data.domains |
array | 필터링 후 선택 가능한 도메인; 빈 배열도 유효합니다. |
data.domains[].domain |
string | 선택 가능한 도메인 이름. |
data.domains[].type |
string | 읽을 수 있는 도메인 티어 레이블. |
data.domains[].custom |
boolean | 맞춤 도메인인지 여부. |
임시 메일함 만들기
소유한 임시 사서함을 생성합니다. 무작위 생성을 위해 사용자 이름과 도메인을 생략하거나 허용된 사용자 정의 이름과 허용된 도메인을 제공하십시오. provider 매개변수는 Gmail 또는 Outlook 별칭 생성을 선택할 수 있습니다.
| 매개변수 | 위치 | 유형 | 상태 | 설명 |
|---|---|---|---|---|
username
|
body | string | 선택 사항 |
선택적 사용자 지정 사용자 이름: 2~64자의 ASCII 문자, 숫자, 점, 밑줄 또는 하이픈. 플랜 권한이 필요합니다; custom_username도 허용됩니다.
기본:
무작위 생성
|
domain
|
body | string | 선택 사항 |
GET /domains에서 반환된 허용된 도메인 중 하나입니다. 생략하면 무작위 허용 도메인이 선택됩니다.
기본:
무작위 허용 도메인
|
lifetime
|
body | string | 선택 사항 |
허용되는 값:
10m — 10분
1h — 1시간
2h — 2시간
1d — 1일
1w — 1주
1m — 30일
3m — 90일
6m — 180일
1y — 365일
unlimited — 무제한
기본:
플랜 기본 수명
|
provider
|
body | string | 선택 사항 |
메일함 제공자: standard, gmail_alias, 또는 outlook_alias.
기본:
standard
|
pin_enabled
|
body | boolean | 선택 사항 |
플랜에서 허용되는 경우 새 사서함에 대한 선택적 PIN 보호를 제공합니다. 기존 사서함의 PIN은 변경되지 않습니다.
기본:
false
|
pin
|
body | string | 선택 사항 |
pin_enabled가 true인 경우 필요: 앞자리 0을 보존하기 위해 문자열로 전송되는 6~8자리 PIN.
|
pin_confirmation
|
body | string | 선택 사항 |
pin_enabled가 true일 때 필요합니다. pin과 정확히 일치해야 합니다.
|
Idempotency-Key
|
header | string | 선택 사항 |
PIN 보호된 생성 또는 삭제에 필요: 16~128자 길이의 안정적인 키. 동일한 키로 동일한 요청을 재시도하여 중복 작업을 방지하십시오.
|
username (플랜에서 허용되는 경우 사용자 지정 사용자 이름), domain (허용된 도메인, 예: example.com), lifetime (허용되는 값: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited), provider (standard, gmail_alias, outlook_alias). 수명(lifetime)을 생략하거나 비워 두면 현재 월간/연간 플랜에 구성된 Default Email Lifetime을 사용합니다. 기본값을 재정의하려면 1h와 같은 허용된 수명을 전송하십시오. Unlimited는 플랜 기본값으로 설정된 경우 또는 명시적으로 요청되고 허용된 경우에만 사용됩니다. 본문 매개변수 mailbox_lifetime와 email_lifetime도 허용됩니다; 첫 번째 비어 있지 않은 값이 다음 순서대로 선택됩니다: lifetime, mailbox_lifetime, email_lifetime. 잘못되었거나 허용되지 않은 값은 기본값을 조용히 선택하는 대신 HTTP 422를 반환합니다.const response = await fetch('https://v1.tempmailg.com/api/emails', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/emails', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/emails');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request POST \
--url 'https://v1.tempmailg.com/api/emails' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
합성 데이터를 사용한 예시 응답입니다. ID, 주소, 토큰, 타임스탬프, 플랜 제한 및 카운트는 다양합니다. 샘플 수명은 플랜 기본값을 대체하지 않습니다. 응답 필드 설명은 nullable 및 제공자별 필드를 식별합니다.
예시 응답
200 OK • JSON{
"status": true,
"data": {
"id": 2301,
"pin_protected": false,
"email": "demo123@example.com",
"domain": "example.com",
"provider": "standard",
"expire_at": "2026-11-20T02:17:54+00:00",
"expires_in_seconds": 86399.75,
"mailbox_state": "active",
"receiving_enabled": true,
"message_count": 0,
"unread_message_count": 0,
"last_message_received_at": null,
"message_count_synced_at": null,
"created_at": "2026-11-19T02:17:54+00:00",
"email_token": "encrypted-email-token"
}
}
| 필드 | 유형 | 설명 |
|---|---|---|
status |
boolean | 작업이 성공했는지 여부. |
data.id |
integer | 메일함 ID. 생성된 ID, 주소 및 토큰은 각 메일함마다 다릅니다. |
data.pin_protected |
boolean | 이 사서함에 PIN 보호가 있는지 여부. PIN 또는 PIN 해시는 반환되지 않습니다. |
data.email |
string | 전체 메일함 주소가 생성되었습니다. |
data.domain |
string | 생성된 메일함의 도메인. |
data.provider |
string | 메일함 제공자: standard, gmail_alias, 또는 outlook_alias. |
data.expire_at |
string|null | 무제한 사서함인 경우 null, 그렇지 않으면 ISO-8601 타임스탬프 형식의 유효 만료일. |
data.expires_in_seconds |
number|null | 계산 시 남은 비음수 초; 소수 초도 가능합니다. Null은 0이 아니라 무제한을 의미합니다. |
data.mailbox_state |
string | 현재 메일함 상태: 활성, 일시 중지, 만료, 또는 비활성. |
data.receiving_enabled |
boolean | 이 메일함이 현재 들어오는 메시지를 수신하는지 여부. |
data.message_count |
integer | 알려진 전체 메시지 수; 마지막 사서함 동기화를 반영할 수 있습니다. |
data.unread_message_count |
integer | 알려진 읽지 않은 메시지 수; 마지막 메일함 동기화를 반영할 수 있습니다. |
data.last_message_received_at |
string|null | ISO-8601 형식의 마지막으로 알려진 수신 메시지 시간, 사용할 수 없을 때는 null입니다. |
data.message_count_synced_at |
string|null | ISO-8601 형식의 마지막 메시지 수 동기화 시간이며, 동기화 이전에는 null입니다. |
data.created_at |
string|null | ISO-8601 형식의 사서함 생성 시간. |
data.email_token |
string | 불투명한 암호화된 메일함 참조입니다. Bearer 인증, 소유권 확인 또는 PIN 인증을 대체하지 않습니다. |
data.pin_grant |
object | 조건부: 활성 PIN 보호 메일함 생성은 이 읽기 권한을 반환하고, 일반 비보호 생성은 이를 생략합니다. |
data.pin_grant.mailbox_id |
integer | 조건부 읽기 권한이 연결된 메일함 ID. |
data.pin_grant.unlock_token |
string | 동일한 소유자 자격 증명을 사용한 X-Mailbox-Unlock용 불투명 읽기 토큰입니다. 비공개로 유지하고 메모리 내에 보관하십시오; 읽기 권한은 삭제를 허가하지 않습니다. |
data.pin_grant.scope |
string | 조건부 생성 권한에 대한 범위가 읽혔습니다. |
data.pin_grant.idle_timeout_seconds |
integer | 읽기 권한에 허용된 유휴 시간이며, 일반적으로 3600초입니다. |
data.pin_grant.absolute_timeout_seconds |
integer | 읽기 권한의 최대 수명은 일반적으로 86400초입니다. |
data.pin_grant.expires_at |
string | ISO-8601 형식의 현재 읽기 권한 만료. |
data.pin_grant.absolute_expires_at |
string | ISO-8601 형식의 절대 읽기 권한 만료. 보안 변경으로 인해 권한이 조기에 취소될 수 있습니다. |
메일함 업데이트 / 전환
현재 사서함의 소유권을 확인한 후 새 사용자 이름 및 도메인에서 사서함을 생성하거나 선택합니다. 이는 기존 사서함의 이름을 바꾸거나 수명을 직접 변경하지 않습니다. 대상이 다를 경우, 기존 사서함은 기록에 남으며 활성 사서함 제한에 의해 일시 중지될 수 있습니다. 자체 활성 대상을 재사용하면 요청된 수명 또는 기본 플랜이 다시 적용됩니다.
| 매개변수 | 위치 | 유형 | 상태 | 설명 |
|---|---|---|---|---|
email
|
path | string | 필수 |
전환할 소유 메일함의 현재 전체 이메일 주소. 각 경로 세그먼트를 URL 인코딩하십시오; 플러스 기호는 %2B로 인코딩합니다.
|
username
|
path | string | 필수 |
새로 원하는 사용자 이름: 2~64자의 영숫자 문자; 사용자 지정 사용자 이름 권한에 따라 달라질 수 있습니다.
|
domain
|
path | string | 필수 |
새 허용 도메인 이름.
|
lifetime
|
body | string | 선택 사항 |
허용되는 값:
10m — 10분
1h — 1시간
2h — 2시간
1d — 1일
1w — 1주
1m — 30일
3m — 90일
6m — 180일
1y — 365일
unlimited — 무제한
기본:
플랜 기본 수명
|
pin_enabled
|
body | boolean | 선택 사항 |
플랜에서 허용되는 경우 새 사서함에 대한 선택적 PIN 보호를 제공합니다. 기존 사서함의 PIN은 변경되지 않습니다.
기본:
false
|
pin
|
body | string | 선택 사항 |
pin_enabled가 true인 경우 필요: 앞자리 0을 보존하기 위해 문자열로 전송되는 6~8자리 PIN.
|
pin_confirmation
|
body | string | 선택 사항 |
pin_enabled가 true일 때 필요합니다. pin과 정확히 일치해야 합니다.
|
Idempotency-Key
|
header | string | 선택 사항 |
PIN 보호된 생성 또는 삭제에 필요: 16~128자 길이의 안정적인 키. 동일한 키로 동일한 요청을 재시도하여 중복 작업을 방지하십시오.
|
X-Mailbox-Unlock
|
header | string | 선택 사항 |
헤더, 보호된 사서함만: 읽기 unlock_token을 사용하십시오. 먼저 PIN unlock URL에 POST pin 및 scope=read를 전송하십시오. 일반 Bearer 인증을 유지하십시오. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
lifetime (허용 값: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). 수명(lifetime)을 생략하거나 비워 두면 현재 월간/연간 플랜에 구성된 Default Email Lifetime을 사용합니다. 기본값을 재정의하려면 1h와 같은 허용된 수명을 전송하십시오. Unlimited는 플랜 기본값으로 설정된 경우 또는 명시적으로 요청되고 허용된 경우에만 사용됩니다. 본문 매개변수 mailbox_lifetime와 email_lifetime도 허용됩니다; 첫 번째 비어 있지 않은 값이 다음 순서대로 선택됩니다: lifetime, mailbox_lifetime, email_lifetime. 잘못되었거나 허용되지 않은 값은 기본값을 조용히 선택하는 대신 HTTP 422를 반환합니다.const response = await fetch('https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request POST \
--url 'https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
합성 데이터를 사용한 예시 응답입니다. ID, 주소, 토큰, 타임스탬프, 플랜 제한 및 카운트는 다양합니다. 샘플 수명은 플랜 기본값을 대체하지 않습니다. 응답 필드 설명은 nullable 및 제공자별 필드를 식별합니다.
예시 응답
200 OK • JSON{
"status": true,
"data": {
"id": 2302,
"pin_protected": false,
"email": "demo123@example.com",
"domain": "example.com",
"provider": "standard",
"expire_at": "2026-11-19T02:27:54+00:00",
"expires_in_seconds": 599.75,
"mailbox_state": "active",
"receiving_enabled": true,
"message_count": 0,
"unread_message_count": 0,
"last_message_received_at": null,
"message_count_synced_at": null,
"created_at": "2026-11-19T02:17:54+00:00",
"email_token": "encrypted-email-token"
}
}
| 필드 | 유형 | 설명 |
|---|---|---|
status |
boolean | 작업이 성공했는지 여부. |
data.id |
integer | 메일함 ID. 생성된 ID, 주소 및 토큰은 각 메일함마다 다릅니다. |
data.pin_protected |
boolean | 이 사서함에 PIN 보호가 있는지 여부. PIN 또는 PIN 해시는 반환되지 않습니다. |
data.email |
string | 전체 메일함 주소가 생성되었습니다. |
data.domain |
string | 생성된 메일함의 도메인. |
data.provider |
string | 메일함 제공자: standard, gmail_alias, 또는 outlook_alias. |
data.expire_at |
string|null | 무제한 사서함인 경우 null, 그렇지 않으면 ISO-8601 타임스탬프 형식의 유효 만료일. |
data.expires_in_seconds |
number|null | 계산 시 남은 비음수 초; 소수 초도 가능합니다. Null은 0이 아니라 무제한을 의미합니다. |
data.mailbox_state |
string | 현재 메일함 상태: 활성, 일시 중지, 만료, 또는 비활성. |
data.receiving_enabled |
boolean | 이 메일함이 현재 들어오는 메시지를 수신하는지 여부. |
data.message_count |
integer | 알려진 전체 메시지 수; 마지막 사서함 동기화를 반영할 수 있습니다. |
data.unread_message_count |
integer | 알려진 읽지 않은 메시지 수; 마지막 메일함 동기화를 반영할 수 있습니다. |
data.last_message_received_at |
string|null | ISO-8601 형식의 마지막으로 알려진 수신 메시지 시간, 사용할 수 없을 때는 null입니다. |
data.message_count_synced_at |
string|null | ISO-8601 형식의 마지막 메시지 수 동기화 시간이며, 동기화 이전에는 null입니다. |
data.created_at |
string|null | ISO-8601 형식의 사서함 생성 시간. |
data.email_token |
string | 불투명한 암호화된 메일함 참조입니다. Bearer 인증, 소유권 확인 또는 PIN 인증을 대체하지 않습니다. |
data.pin_grant |
object | 조건부: 활성 PIN 보호 메일함 생성은 이 읽기 권한을 반환하고, 일반 비보호 생성은 이를 생략합니다. |
data.pin_grant.mailbox_id |
integer | 조건부 읽기 권한이 연결된 메일함 ID. |
data.pin_grant.unlock_token |
string | 동일한 소유자 자격 증명을 사용한 X-Mailbox-Unlock용 불투명 읽기 토큰입니다. 비공개로 유지하고 메모리 내에 보관하십시오; 읽기 권한은 삭제를 허가하지 않습니다. |
data.pin_grant.scope |
string | 조건부 생성 권한에 대한 범위가 읽혔습니다. |
data.pin_grant.idle_timeout_seconds |
integer | 읽기 권한에 허용된 유휴 시간이며, 일반적으로 3600초입니다. |
data.pin_grant.absolute_timeout_seconds |
integer | 읽기 권한의 최대 수명은 일반적으로 86400초입니다. |
data.pin_grant.expires_at |
string | ISO-8601 형식의 현재 읽기 권한 만료. |
data.pin_grant.absolute_expires_at |
string | ISO-8601 형식의 절대 읽기 권한 만료. 보안 변경으로 인해 권한이 조기에 취소될 수 있습니다. |
메일함 삭제
소유한 메일함을 삭제하고 해당 메시지와 파일 정리를 실행합니다. 보관된 메일함 기록은 내부적으로 소프트 삭제될 수 있으며; 주소는 API를 통해 더 이상 사용할 수 없습니다.
| 매개변수 | 위치 | 유형 | 상태 | 설명 |
|---|---|---|---|---|
email
|
path | string | 필수 |
삭제할 소유 메일함의 전체 이메일 주소입니다. 주소를 URL 인코딩하십시오; 플러스 기호는 %2B로 인코딩합니다.
|
X-Mailbox-Unlock
|
header | string | 선택 사항 |
헤더, 보호된 사서함 전용: 일회용 삭제 unlock_token을 사용하십시오. 먼저 POST pin, scope=delete 및 423 응답에서 PIN unlock URL에 반환된 action/target_id을 사용합니다. 읽기 토큰은 삭제할 수 없습니다. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
Idempotency-Key
|
header | string | 선택 사항 |
PIN 보호된 생성 또는 삭제에 필요: 16~128자 길이의 안정적인 키. 동일한 키로 동일한 요청을 재시도하여 중복 작업을 방지하십시오.
|
const response = await fetch('https://v1.tempmailg.com/api/emails/demo123@example.com', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.delete('https://v1.tempmailg.com/api/emails/demo123@example.com', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/emails/demo123@example.com');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'DELETE',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request DELETE \
--url 'https://v1.tempmailg.com/api/emails/demo123@example.com' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
합성 데이터를 사용한 예시 응답입니다. ID, 주소, 토큰, 타임스탬프, 플랜 제한 및 카운트는 다양합니다. 샘플 수명은 플랜 기본값을 대체하지 않습니다. 응답 필드 설명은 nullable 및 제공자별 필드를 식별합니다.
예시 응답
200 OK • JSON{
"status": true,
"message": "Email has been successfully deleted."
}
| 필드 | 유형 | 설명 |
|---|---|---|
status |
boolean | 작업이 성공했는지 여부. |
message |
string | 삭제 결과. 누락된 리소스는 HTTP 404를 반환합니다. |
Gmail & Outlook 별칭
높은 평판의 Gmail 및 Outlook/Hotmail 별칭 메일함을 생성합니다.
Gmail 별칭 만들기
인증된 사용자가 소유하는 새로운 Gmail 별칭 임시 사서함을 생성합니다.
| 매개변수 | 위치 | 유형 | 상태 | 설명 |
|---|---|---|---|---|
mode
|
body | string | 선택 사항 |
생성 모드: auto, dot, plus, 또는 plus_dot. gmail_alias_mode도 허용됩니다. 스타일 선택이 허용되지 않으면 auto가 사용됩니다.
기본:
auto
|
username
|
body | string | 선택 사항 |
선택적 사용자 지정 별칭 접미사: 2~32개의 ASCII 문자 또는 숫자, 소문자로 정규화; 기능 권한에 따라 제한됩니다. 또한 custom_username 또는 alias_username을 허용합니다.
기본:
자동 생성
|
domain
|
body | string | 선택 사항 |
무작위, gmail.com 또는 googlemail.com을 사용하세요; alias_domain도 허용됩니다. 생략하거나 도메인 선택 권한이 없을 경우 무작위를 사용합니다.
기본:
random
|
lifetime
|
body | string | 선택 사항 |
허용되는 값:
10m — 10분
1h — 1시간
2h — 2시간
1d — 1일
1w — 1주
1m — 30일
3m — 90일
6m — 180일
1y — 365일
unlimited — 무제한
기본:
플랜 기본 수명
|
pin_enabled
|
body | boolean | 선택 사항 |
플랜에서 허용되는 경우 새 사서함에 대한 선택적 PIN 보호를 제공합니다. 기존 사서함의 PIN은 변경되지 않습니다.
기본:
false
|
pin
|
body | string | 선택 사항 |
pin_enabled가 true인 경우 필요: 앞자리 0을 보존하기 위해 문자열로 전송되는 6~8자리 PIN.
|
pin_confirmation
|
body | string | 선택 사항 |
pin_enabled가 true일 때 필요합니다. pin과 정확히 일치해야 합니다.
|
Idempotency-Key
|
header | string | 선택 사항 |
PIN 보호된 생성 또는 삭제에 필요: 16~128자 길이의 안정적인 키. 동일한 키로 동일한 요청을 재시도하여 중복 작업을 방지하십시오.
|
mode (auto, dot, plus, plus_dot), username (사용자 지정 별칭 사용자 이름), domain (예: gmail.com, googlemail.com), lifetime (허용되는 값: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). 수명(lifetime)을 생략하거나 비워 두면 현재 월간/연간 플랜에 구성된 Default Email Lifetime을 사용합니다. 기본값을 재정의하려면 1h와 같은 허용된 수명을 전송하십시오. Unlimited는 플랜 기본값으로 설정된 경우 또는 명시적으로 요청되고 허용된 경우에만 사용됩니다. 본문 매개변수 mailbox_lifetime와 email_lifetime도 허용됩니다; 첫 번째 비어 있지 않은 값이 다음 순서대로 선택됩니다: lifetime, mailbox_lifetime, email_lifetime. 잘못되었거나 허용되지 않은 값은 기본값을 조용히 선택하는 대신 HTTP 422를 반환합니다.const response = await fetch('https://v1.tempmailg.com/api/gmail-alias/emails', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/gmail-alias/emails', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/gmail-alias/emails');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request POST \
--url 'https://v1.tempmailg.com/api/gmail-alias/emails' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
합성 데이터를 사용한 예시 응답입니다. ID, 주소, 토큰, 타임스탬프, 플랜 제한 및 카운트는 다양합니다. 샘플 수명은 플랜 기본값을 대체하지 않습니다. 응답 필드 설명은 nullable 및 제공자별 필드를 식별합니다.
예시 응답
200 OK • JSON{
"status": true,
"data": {
"id": 2305,
"pin_protected": false,
"email": "example+alias123@gmail.com",
"domain": "gmail.com",
"provider": "gmail_alias",
"expire_at": "2026-11-19T03:17:54+00:00",
"expires_in_seconds": 3599.75,
"mailbox_state": "active",
"receiving_enabled": true,
"message_count": 0,
"unread_message_count": 0,
"last_message_received_at": null,
"message_count_synced_at": null,
"created_at": "2026-11-19T02:17:54+00:00",
"email_token": "encrypted-email-token"
}
}
| 필드 | 유형 | 설명 |
|---|---|---|
status |
boolean | 작업이 성공했는지 여부. |
data.id |
integer | 메일함 ID. 생성된 ID, 주소 및 토큰은 각 메일함마다 다릅니다. |
data.pin_protected |
boolean | 이 사서함에 PIN 보호가 있는지 여부. PIN 또는 PIN 해시는 반환되지 않습니다. |
data.email |
string | 전체 메일함 주소가 생성되었습니다. |
data.domain |
string | 생성된 메일함의 도메인. |
data.provider |
string | 메일함 제공자: standard, gmail_alias, 또는 outlook_alias. |
data.expire_at |
string|null | 무제한 사서함인 경우 null, 그렇지 않으면 ISO-8601 타임스탬프 형식의 유효 만료일. |
data.expires_in_seconds |
number|null | 계산 시 남은 비음수 초; 소수 초도 가능합니다. Null은 0이 아니라 무제한을 의미합니다. |
data.mailbox_state |
string | 현재 메일함 상태: 활성, 일시 중지, 만료, 또는 비활성. |
data.receiving_enabled |
boolean | 이 메일함이 현재 들어오는 메시지를 수신하는지 여부. |
data.message_count |
integer | 알려진 전체 메시지 수; 마지막 사서함 동기화를 반영할 수 있습니다. |
data.unread_message_count |
integer | 알려진 읽지 않은 메시지 수; 마지막 메일함 동기화를 반영할 수 있습니다. |
data.last_message_received_at |
string|null | ISO-8601 형식의 마지막으로 알려진 수신 메시지 시간, 사용할 수 없을 때는 null입니다. |
data.message_count_synced_at |
string|null | ISO-8601 형식의 마지막 메시지 수 동기화 시간이며, 동기화 이전에는 null입니다. |
data.created_at |
string|null | ISO-8601 형식의 사서함 생성 시간. |
data.email_token |
string | 불투명한 암호화된 메일함 참조입니다. Bearer 인증, 소유권 확인 또는 PIN 인증을 대체하지 않습니다. |
data.pin_grant |
object | 조건부: 활성 PIN 보호 메일함 생성은 이 읽기 권한을 반환하고, 일반 비보호 생성은 이를 생략합니다. |
data.pin_grant.mailbox_id |
integer | 조건부 읽기 권한이 연결된 메일함 ID. |
data.pin_grant.unlock_token |
string | 동일한 소유자 자격 증명을 사용한 X-Mailbox-Unlock용 불투명 읽기 토큰입니다. 비공개로 유지하고 메모리 내에 보관하십시오; 읽기 권한은 삭제를 허가하지 않습니다. |
data.pin_grant.scope |
string | 조건부 생성 권한에 대한 범위가 읽혔습니다. |
data.pin_grant.idle_timeout_seconds |
integer | 읽기 권한에 허용된 유휴 시간이며, 일반적으로 3600초입니다. |
data.pin_grant.absolute_timeout_seconds |
integer | 읽기 권한의 최대 수명은 일반적으로 86400초입니다. |
data.pin_grant.expires_at |
string | ISO-8601 형식의 현재 읽기 권한 만료. |
data.pin_grant.absolute_expires_at |
string | ISO-8601 형식의 절대 읽기 권한 만료. 보안 변경으로 인해 권한이 조기에 취소될 수 있습니다. |
Outlook 별칭 도메인
메일함 생성을 위해 사용할 수 있는 활성 Outlook / Hotmail 별칭 도메인을 가져옵니다.
const response = await fetch('https://v1.tempmailg.com/api/outlook-alias/domains', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/outlook-alias/domains', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/outlook-alias/domains');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request GET \
--url 'https://v1.tempmailg.com/api/outlook-alias/domains' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
합성 데이터를 사용한 예시 응답입니다. ID, 주소, 토큰, 타임스탬프, 플랜 제한 및 카운트는 다양합니다. 샘플 수명은 플랜 기본값을 대체하지 않습니다. 응답 필드 설명은 nullable 및 제공자별 필드를 식별합니다.
예시 응답
200 OK • JSON{
"status": true,
"data": {
"domains": [
{
"domain": "outlook.com",
"type": "Outlook/Hotmail",
"selectable": true,
"locked": false,
"disabled_reason": null
},
{
"domain": "hotmail.com",
"type": "Outlook/Hotmail",
"selectable": true,
"locked": false,
"disabled_reason": null
}
]
}
}
| 필드 | 유형 | 설명 |
|---|---|---|
status |
boolean | 작업이 성공했는지 여부. |
data.domains |
array | 활성 Outlook/Hotmail 도메인; 빈 배열도 유효합니다. |
data.domains[].domain |
string | 사용 가능한 도메인 이름. |
data.domains[].type |
string | 읽을 수 있는 제공자 레이블. |
data.domains[].selectable |
boolean | 귀하의 계정이 이 도메인을 명시적으로 선택할 수 있는지 여부. |
data.domains[].locked |
boolean | 귀하의 계정에 대해 명시적 도메인 선택이 잠겨 있는지 여부. |
data.domains[].disabled_reason |
string|null | 도메인 선택이 잠긴 이유, 선택 가능할 때는 null. |
Outlook 별칭 만들기
인증된 사용자가 소유한 새로운 Outlook / Hotmail 별칭 임시 사서함을 생성합니다.
| 매개변수 | 위치 | 유형 | 상태 | 설명 |
|---|---|---|---|---|
domain
|
body | string | 선택 사항 |
GET /outlook-alias/domains에서 무작위 또는 도메인을 사용하십시오; outlook_alias_domain도 허용됩니다. 선택 권한이 없으면 무작위가 사용됩니다.
기본:
무작위 사용 가능한 도메인
|
username
|
body | string | 선택 사항 |
선택적 사용자 지정 별칭 접미사: 2~32개의 ASCII 문자 또는 숫자, 소문자로 정규화; 기능 권한에 따라 제한됩니다. 또한 custom_username 또는 alias_username을 허용합니다.
기본:
자동 생성
|
lifetime
|
body | string | 선택 사항 |
허용되는 값:
10m — 10분
1h — 1시간
2h — 2시간
1d — 1일
1w — 1주
1m — 30일
3m — 90일
6m — 180일
1y — 365일
unlimited — 무제한
기본:
플랜 기본 수명
|
pin_enabled
|
body | boolean | 선택 사항 |
플랜에서 허용되는 경우 새 사서함에 대한 선택적 PIN 보호를 제공합니다. 기존 사서함의 PIN은 변경되지 않습니다.
기본:
false
|
pin
|
body | string | 선택 사항 |
pin_enabled가 true인 경우 필요: 앞자리 0을 보존하기 위해 문자열로 전송되는 6~8자리 PIN.
|
pin_confirmation
|
body | string | 선택 사항 |
pin_enabled가 true일 때 필요합니다. pin과 정확히 일치해야 합니다.
|
Idempotency-Key
|
header | string | 선택 사항 |
PIN 보호된 생성 또는 삭제에 필요: 16~128자 길이의 안정적인 키. 동일한 키로 동일한 요청을 재시도하여 중복 작업을 방지하십시오.
|
domain (예: outlook.com, hotmail.com), username (사용자 지정 별칭 사용자 이름), lifetime (허용되는 값: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). 수명(lifetime)을 생략하거나 비워 두면 현재 월간/연간 플랜에 구성된 Default Email Lifetime을 사용합니다. 기본값을 재정의하려면 1h와 같은 허용된 수명을 전송하십시오. Unlimited는 플랜 기본값으로 설정된 경우 또는 명시적으로 요청되고 허용된 경우에만 사용됩니다. 본문 매개변수 mailbox_lifetime와 email_lifetime도 허용됩니다; 첫 번째 비어 있지 않은 값이 다음 순서대로 선택됩니다: lifetime, mailbox_lifetime, email_lifetime. 잘못되었거나 허용되지 않은 값은 기본값을 조용히 선택하는 대신 HTTP 422를 반환합니다.const response = await fetch('https://v1.tempmailg.com/api/outlook-alias/emails', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/outlook-alias/emails', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/outlook-alias/emails');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request POST \
--url 'https://v1.tempmailg.com/api/outlook-alias/emails' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
합성 데이터를 사용한 예시 응답입니다. ID, 주소, 토큰, 타임스탬프, 플랜 제한 및 카운트는 다양합니다. 샘플 수명은 플랜 기본값을 대체하지 않습니다. 응답 필드 설명은 nullable 및 제공자별 필드를 식별합니다.
예시 응답
200 OK • JSON{
"status": true,
"data": {
"id": 2306,
"pin_protected": false,
"email": "example+alias45@outlook.com",
"domain": "outlook.com",
"provider": "outlook_alias",
"expire_at": "2026-11-19T03:17:54+00:00",
"expires_in_seconds": 3599.75,
"mailbox_state": "active",
"receiving_enabled": true,
"message_count": 0,
"unread_message_count": 0,
"last_message_received_at": null,
"message_count_synced_at": null,
"created_at": "2026-11-19T02:17:54+00:00",
"email_token": "encrypted-email-token"
}
}
| 필드 | 유형 | 설명 |
|---|---|---|
status |
boolean | 작업이 성공했는지 여부. |
data.id |
integer | 메일함 ID. 생성된 ID, 주소 및 토큰은 각 메일함마다 다릅니다. |
data.pin_protected |
boolean | 이 사서함에 PIN 보호가 있는지 여부. PIN 또는 PIN 해시는 반환되지 않습니다. |
data.email |
string | 전체 메일함 주소가 생성되었습니다. |
data.domain |
string | 생성된 메일함의 도메인. |
data.provider |
string | 메일함 제공자: standard, gmail_alias, 또는 outlook_alias. |
data.expire_at |
string|null | 무제한 사서함인 경우 null, 그렇지 않으면 ISO-8601 타임스탬프 형식의 유효 만료일. |
data.expires_in_seconds |
number|null | 계산 시 남은 비음수 초; 소수 초도 가능합니다. Null은 0이 아니라 무제한을 의미합니다. |
data.mailbox_state |
string | 현재 메일함 상태: 활성, 일시 중지, 만료, 또는 비활성. |
data.receiving_enabled |
boolean | 이 메일함이 현재 들어오는 메시지를 수신하는지 여부. |
data.message_count |
integer | 알려진 전체 메시지 수; 마지막 사서함 동기화를 반영할 수 있습니다. |
data.unread_message_count |
integer | 알려진 읽지 않은 메시지 수; 마지막 메일함 동기화를 반영할 수 있습니다. |
data.last_message_received_at |
string|null | ISO-8601 형식의 마지막으로 알려진 수신 메시지 시간, 사용할 수 없을 때는 null입니다. |
data.message_count_synced_at |
string|null | ISO-8601 형식의 마지막 메시지 수 동기화 시간이며, 동기화 이전에는 null입니다. |
data.created_at |
string|null | ISO-8601 형식의 사서함 생성 시간. |
data.email_token |
string | 불투명한 암호화된 메일함 참조입니다. Bearer 인증, 소유권 확인 또는 PIN 인증을 대체하지 않습니다. |
data.pin_grant |
object | 조건부: 활성 PIN 보호 메일함 생성은 이 읽기 권한을 반환하고, 일반 비보호 생성은 이를 생략합니다. |
data.pin_grant.mailbox_id |
integer | 조건부 읽기 권한이 연결된 메일함 ID. |
data.pin_grant.unlock_token |
string | 동일한 소유자 자격 증명을 사용한 X-Mailbox-Unlock용 불투명 읽기 토큰입니다. 비공개로 유지하고 메모리 내에 보관하십시오; 읽기 권한은 삭제를 허가하지 않습니다. |
data.pin_grant.scope |
string | 조건부 생성 권한에 대한 범위가 읽혔습니다. |
data.pin_grant.idle_timeout_seconds |
integer | 읽기 권한에 허용된 유휴 시간이며, 일반적으로 3600초입니다. |
data.pin_grant.absolute_timeout_seconds |
integer | 읽기 권한의 최대 수명은 일반적으로 86400초입니다. |
data.pin_grant.expires_at |
string | ISO-8601 형식의 현재 읽기 권한 만료. |
data.pin_grant.absolute_expires_at |
string | ISO-8601 형식의 절대 읽기 권한 만료. 보안 변경으로 인해 권한이 조기에 취소될 수 있습니다. |
메시지 및 첨부 파일
수신함을 가져오고, 전체 HTML/텍스트 메시지를 읽으며, 첨부 파일을 스트리밍합니다.
사서함 메시지 목록
사용 가능한 메시지 요약 및 사서함 메타데이터를 검색합니다. 표준 받은편지함 스캔은 최대 25개의 최신 메시지 배치를 반환하며, 이는 페이지화된 전체 기록 엔드포인트가 아닙니다. 전체 본문 및 첨부파일을 보려면 GET /messages/{messageId}를 사용하십시오.
| 매개변수 | 위치 | 유형 | 상태 | 설명 |
|---|---|---|---|---|
email
|
query | string | 필수 |
읽을 메시지를 위한 소유 메일함의 전체 이메일 주소. 쿼리 값을 URL 인코딩하십시오; 플러스 기호는 %2B 로 인코딩합니다.
|
X-Mailbox-Unlock
|
header | string | 선택 사항 |
헤더, 보호된 사서함만: 읽기 unlock_token을 사용하십시오. 먼저 PIN unlock URL에 POST pin 및 scope=read를 전송하십시오. 일반 Bearer 인증을 유지하십시오. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
const response = await fetch('https://v1.tempmailg.com/api/messages?email=demo123@example.com', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/messages?email=demo123@example.com', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/messages?email=demo123@example.com');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request GET \
--url 'https://v1.tempmailg.com/api/messages?email=demo123@example.com' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
합성 데이터를 사용한 예시 응답입니다. ID, 주소, 토큰, 타임스탬프, 플랜 제한 및 카운트는 다양합니다. 샘플 수명은 플랜 기본값을 대체하지 않습니다. 응답 필드 설명은 nullable 및 제공자별 필드를 식별합니다.
예시 응답
200 OK • JSON{
"status": true,
"mailbox": "demo123@example.com",
"email_token": "encrypted-email-token",
"messages": [
{
"is_seen": false,
"subject": "Welcome to Temp Mail",
"from": "Example Sender",
"from_email": "hello@example.org",
"receivedAt": "2026-11-19 02:17:54",
"id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
"otp": null,
"otp_locked": false,
"verification_link": null,
"verification_link_locked": false
}
],
"mailbox_provider": "standard",
"mailbox_state": "active",
"expire_at": "2026-11-20T02:17:54+00:00",
"expires_in_seconds": 86399.75,
"receiving_enabled": true,
"mailbox_limit": {
"limit": 50,
"limit_label": "50",
"active_count": 1,
"paused_count": 0,
"paused_mailboxes": [],
"remaining": 49,
"remaining_label": "49",
"reached": false,
"blocked": false,
"provider": "standard"
},
"message_count": 1,
"unread_message_count": 1,
"last_message_received_at": "2026-11-19T02:17:54+00:00",
"message_count_synced_at": "2026-11-19T02:17:54+00:00"
}
| 필드 | 유형 | 설명 |
|---|---|---|
status |
boolean | 작업이 성공했는지 여부. |
mailbox |
string | 요청된 메시지의 메일함 주소. |
email_token |
string | 불투명 암호화된 사서함 참조; 일반 인증이 여전히 필요합니다. |
mailbox_provider |
string | 메일함 제공자: standard, gmail_alias, 또는 outlook_alias. |
messages |
array | 메시지 요약. 빈 받은 편지함은 빈 배열을 반환합니다; 본문 및 첨부 파일을 위해 단일 메시지를 검색합니다. |
expire_at |
string|null | 무제한 사서함인 경우 null, 그렇지 않으면 ISO-8601 타임스탬프 형식의 유효 만료일. |
expires_in_seconds |
number|null | 계산 시 남은 비음수 초; 소수 초도 가능합니다. Null은 0이 아니라 무제한을 의미합니다. |
mailbox_state |
string | 현재 메일함 상태: 활성, 일시 중지, 만료, 또는 비활성. |
receiving_enabled |
boolean | 이 메일함이 현재 들어오는 메시지를 수신하는지 여부. |
message_count |
integer | 알려진 전체 메시지 수; 마지막 사서함 동기화를 반영할 수 있습니다. |
unread_message_count |
integer | 알려진 읽지 않은 메시지 수; 마지막 메일함 동기화를 반영할 수 있습니다. |
last_message_received_at |
string|null | ISO-8601 형식의 마지막으로 알려진 수신 메시지 시간, 사용할 수 없을 때는 null입니다. |
message_count_synced_at |
string|null | ISO-8601 형식의 마지막 메시지 수 동기화 시간이며, 동기화 이전에는 null입니다. |
mailbox_limit.limit |
integer | 이 제공자에 대한 활성 메일함 제한; -1은 무제한을 의미합니다. |
mailbox_limit.limit_label |
string | 메일함 제한에 대한 표시 라벨. |
mailbox_limit.active_count |
integer | 이 공급자에 대한 활성 메일함 수. |
mailbox_limit.paused_count |
integer | 이 공급자에 대한 일시 중지된 사서함 수. |
mailbox_limit.paused_mailboxes |
array<string> | 메일함 제한으로 인해 주소가 일시 중지되었습니다. |
mailbox_limit.remaining |
integer | 남은 활성 메일함 슬롯; -1은 무제한을 의미합니다. 이는 API 요청 할당량이 아닙니다. |
mailbox_limit.remaining_label |
string | 남은 메일함 슬롯에 대한 표시 레이블. |
mailbox_limit.reached |
boolean | 활성 사서함 제한에 도달했는지 여부. |
mailbox_limit.blocked |
boolean | 활성 메일함 제한이 0인지 여부. |
mailbox_limit.provider |
string|null | 메일함 제한이 적용되는 제공자. |
messages[].id |
string | 단일 메시지, 삭제 및 첨부 엔드포인트에서 사용되는 불투명 메시지 ID. |
messages[].is_seen |
boolean | 메시지가 읽음으로 표시되었는지 여부. |
messages[].subject |
string | 메시지 제목. |
messages[].from |
string | 보낸 사람 표시 이름 또는 주소. |
messages[].from_email |
string | 보낸 사람 이메일 주소. |
messages[].receivedAt |
string | 애플리케이션 시간대의 수신 시간, 형식: YYYY-MM-DD HH:mm:ss. |
messages[].otp |
string|null | 가능하고 허용되는 경우 일회용 코드를 감지하고; 그렇지 않으면 null. |
messages[].otp_locked |
boolean | 감지된 일회용 코드가 기능 권한에 의해 숨겨지는지 여부. |
messages[].verification_link |
string|null | 가능하고 허용되는 경우 확인 URL을 감지합니다; 그렇지 않으면 null. |
messages[].verification_link_locked |
boolean | 감지된 인증 링크가 기능 권한에 의해 숨겨져 있는지 여부. |
messages[].from_name |
string|null | Outlook 요약 필드: 원본 발신자 이름. Standard 및 Gmail 요약에 없음. |
messages[].snippet |
string|null | Outlook 요약 필드: 짧은 메시지 미리보기. |
messages[].received_at |
string|null | Outlook 요약 필드: 알려진 경우 ISO-8601 수신 시간. |
messages[].has_attachments |
boolean | Outlook 요약 필드: 첨부 파일 메타데이터가 존재하는지 여부. 다운로드 가능 여부는 별도로 확인됩니다. |
단일 메시지 가져오기
불투명한 메시지 ID로 소유된 메시지를 검색합니다. 본문 형식 및 첨부 파일 메타데이터를 반환합니다. 본문 필드는 메시지 형식에 따라 다르며; Outlook은 아래에 나열된 공급자별 필드를 추가합니다.
| 매개변수 | 위치 | 유형 | 상태 | 설명 |
|---|---|---|---|---|
messageId
|
path | string | 필수 |
메시지 목록에 반환되는 고유 메시지 ID.
|
X-Mailbox-Unlock
|
header | string | 선택 사항 |
헤더, 보호된 사서함만: 읽기 unlock_token을 사용하십시오. 먼저 PIN unlock URL에 POST pin 및 scope=read를 전송하십시오. 일반 Bearer 인증을 유지하십시오. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
const response = await fetch('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request GET \
--url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
합성 데이터를 사용한 예시 응답입니다. ID, 주소, 토큰, 타임스탬프, 플랜 제한 및 카운트는 다양합니다. 샘플 수명은 플랜 기본값을 대체하지 않습니다. 응답 필드 설명은 nullable 및 제공자별 필드를 식별합니다.
예시 응답
200 OK • JSON{
"status": true,
"data": {
"is_seen": true,
"subject": "Welcome to Temp Mail",
"from": "Example Sender",
"from_email": "hello@example.org",
"to": "demo123@example.com",
"mailbox_provider": "standard",
"receivedAt": "2026-11-19 02:17:54",
"id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
"html": true,
"html_content": "<p>Hello from the inbox.</p>",
"text_content": "<pre>Hello from the inbox.</pre>",
"content": "<p>Hello from the inbox.</p>",
"attachments": [
{
"name": "file.txt",
"extension": "txt",
"size": 91,
"url": "https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt"
}
]
}
}
| 필드 | 유형 | 설명 |
|---|---|---|
status |
boolean | 작업이 성공했는지 여부. |
data.id |
string | 불투명 메시지 ID. |
data.is_seen |
boolean | 메시지 읽음 상태. 읽으면 확인된 것으로 표시될 수 있으며, 캐시된 데이터는 이전 상태를 반영할 수 있습니다. |
data.subject |
string | 메시지 제목. |
data.from |
string | 보낸 사람 표시 이름 또는 주소. |
data.from_email |
string | 보낸 사람 이메일 주소. |
data.to |
string | 수신자 사서함 주소. |
data.mailbox_provider |
string | 메일함 제공자: standard, gmail_alias, 또는 outlook_alias. |
data.receivedAt |
string | 애플리케이션 시간대의 수신 시간, 형식: YYYY-MM-DD HH:mm:ss. |
data.html |
boolean | 메시지에 HTML 본문이 있는지 여부. |
data.html_content |
string | HTML 본문이 있는 경우. HTML이 없는 표준 메시지는 이 필드를 생략할 수 있습니다. 메시지 내용을 신뢰하지 마세요. |
data.text_content |
string | 텍스트 본문이 있는 경우; 표준 메시지는 pre 요소에 이스케이프된 텍스트를 포함할 수 있거나 이 필드를 생략할 수 있습니다. |
data.content |
string | 표시를 위한 기본 본문이며, 가능한 경우 일반적으로 HTML입니다. |
data.attachments |
array | 첨부 파일 메타데이터, 또는 빈 배열. 다운로드에는 일반 인증 및 해당 PIN 권한이 필요합니다. |
data.attachments[].name |
string | 다운로드 시 단일 경로 세그먼트로 URL 인코딩할 파일 이름. |
data.attachments[].size |
integer | 첨부 파일 크기(바이트). |
data.attachments[].url |
string | 인증된 사용자 API 다운로드 URL이 파일 이름과 함께 첨부 파일에 추가되었습니다. URL이 로컬 파일이 사용 가능함을 보장하지는 않습니다. |
data.attachments[].extension |
string | 표준/Gmail 메타데이터 필드: 제공된 경우 파일 확장자. |
data.attachments[].id |
string | Outlook 메타데이터 필드: 제공자 첨부 파일 ID. |
data.attachments[].content_type |
string | Outlook 메타데이터 필드: MIME 콘텐츠 유형. |
data.from_name |
string|null | Outlook 상세 필드: 원본 발신자 이름. |
data.to_email |
string|null | Outlook 상세 필드: 원본 수신자 주소. |
data.received_at |
string|null | Outlook 상세 필드: ISO-8601 수신 시간. |
data.has_html |
boolean | Outlook 세부 필드: HTML 본문이 존재하는지 여부. |
메시지 삭제
소유한 메시지 하나를 삭제합니다.
| 매개변수 | 위치 | 유형 | 상태 | 설명 |
|---|---|---|---|---|
messageId
|
path | string | 필수 |
영구적으로 삭제하기 위한 고유 메시지 ID 문자열.
|
X-Mailbox-Unlock
|
header | string | 선택 사항 |
헤더, 보호된 사서함 전용: 일회용 삭제 unlock_token을 사용하십시오. 먼저 POST pin, scope=delete 및 423 응답에서 PIN unlock URL에 반환된 action/target_id을 사용합니다. 읽기 토큰은 삭제할 수 없습니다. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
Idempotency-Key
|
header | string | 선택 사항 |
PIN 보호된 생성 또는 삭제에 필요: 16~128자 길이의 안정적인 키. 동일한 키로 동일한 요청을 재시도하여 중복 작업을 방지하십시오.
|
const response = await fetch('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.delete('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'DELETE',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request DELETE \
--url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
합성 데이터를 사용한 예시 응답입니다. ID, 주소, 토큰, 타임스탬프, 플랜 제한 및 카운트는 다양합니다. 샘플 수명은 플랜 기본값을 대체하지 않습니다. 응답 필드 설명은 nullable 및 제공자별 필드를 식별합니다.
예시 응답
200 OK • JSON{
"status": true,
"message": "Message was deleted successfully."
}
| 필드 | 유형 | 설명 |
|---|---|---|
status |
boolean | 작업이 성공했는지 여부. |
message |
string | 삭제 결과. 누락된 리소스는 HTTP 404를 반환합니다. |
첨부 파일 다운로드
소유한 메시지에서 첨부 파일을 다운로드합니다.
| 매개변수 | 위치 | 유형 | 상태 | 설명 |
|---|---|---|---|---|
messageId
|
path | string | 필수 |
파일을 포함하는 메시지의 ID.
|
filename
|
path | string | 필수 |
다운로드할 첨부 파일의 파일명 및 확장자.
|
X-Mailbox-Unlock
|
header | string | 선택 사항 |
헤더, 보호된 사서함만: 읽기 unlock_token을 사용하십시오. 먼저 PIN unlock URL에 POST pin 및 scope=read를 전송하십시오. 일반 Bearer 인증을 유지하십시오. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
const response = await fetch('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const blob = await response.blob();
const downloadUrl = window.URL.createObjectURL(blob);
const link = document.createElement('a');
link.href = downloadUrl;
link.download = 'file.txt';
document.body.appendChild(link);
link.click();
link.remove();
window.URL.revokeObjectURL(downloadUrl);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt', headers=headers, stream=True, timeout=30)
response.raise_for_status()
with open('file.txt', 'wb') as handle:
for chunk in response.iter_content(chunk_size=8192):
if chunk:
handle.write(chunk)
<?php
$fileHandle = fopen('file.txt', 'w');
$ch = curl_init('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_FILE => $fileHandle,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
if (curl_exec($ch) === false) {
fclose($fileHandle);
throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
fclose($fileHandle);
curl --request GET \
--url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY' \
--output file.txt
| 필드 | 유형 | 설명 |
|---|---|---|
Content-Disposition |
header | 성공적인 응답이 요청된 파일명을 다운로드합니다. |
body |
binary | 성공 시 파일 바이트를 반환하고, JSON은 반환하지 않습니다. 오류는 비-2xx 상태와 함께 JSON을 반환합니다. |
속도 제한 및 할당량
크레딧을 소모하지 않고 실시간 요청 예산, 속도 제한 및 계정 할당량을 모니터링합니다.
속도 제한 및 할당량
API 사용량을 소모하지 않고 현재 속도 제한 및 할당량 상태를 확인하세요. 이 엔드포인트는 할당량이 없으며 월간 API 크레딧을 차감하지 않습니다 (남용 방지 제한: 60 요청/분).
const response = await fetch('https://v1.tempmailg.com/api/rate-limit', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/rate-limit', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/rate-limit');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request GET \
--url 'https://v1.tempmailg.com/api/rate-limit' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
합성 데이터를 사용한 예시 응답입니다. ID, 주소, 토큰, 타임스탬프, 플랜 제한 및 카운트는 다양합니다. 샘플 수명은 플랜 기본값을 대체하지 않습니다. 응답 필드 설명은 nullable 및 제공자별 필드를 식별합니다.
예시 응답
200 OK • JSON{
"status": "success",
"data": {
"limit": 60,
"remaining": 45,
"reset": 32,
"plan": "premium",
"monthly_limit": 50000,
"monthly_remaining": 48210,
"purchased_credits": 5000,
"quota": {
"enabled": true,
"user_api_status": true,
"plan_name": "Premium Plan",
"period": "2026-10",
"base_limit": 50000,
"extra_requests": 0,
"monthly_limit": 50000,
"monthly_remaining": 48210,
"used": 1790,
"purchased_credits": 5000,
"bonus_credits": 1000,
"direct_purchased_credits": 4000,
"remaining": 53210,
"unlimited": false,
"usage_percent": 3,
"reset_at": "2026-11-01T00:00:00+00:00"
}
}
}
| 필드 | 유형 | 설명 |
|---|---|---|
data.limit |
integer|string | 계정 요청당 분당 제한. 문자열 unlimited는 무제한 분당 예산을 나타냅니다; 이는 월별 할당량과는 별개입니다. |
data.remaining |
integer|string | 남은 계정 분당 예산 슬롯, 또는 문자열 unlimited. 양수 값이 API 크레딧이 남아 있음을 의미하지는 않습니다. |
data.reset |
integer | 계정 분당 창에 대한 초이며, 월별 할당량 재설정이 아닙니다. 비활성화되었거나 무제한 분당 예산은 명목상 60초 값을 유지할 수 있습니다; 이는 대기 후 접근을 보장하지 않습니다. |
data.plan |
string | 현재 플랜 태그. 읽을 수 있는 플랜 이름은 data.quota.plan_name에 별도로 제공됩니다. |
data.quota.enabled |
boolean | 전역 및 플랜/크레딧 API 접근이 활성화되어 있는지 여부. 이는 남은 용량을 나타내거나 사용자 API 스위치를 대체하지 않습니다. |
data.quota.user_api_status |
boolean | 사용자가 사용자 API 스위치를 활성화했는지 여부. 작업에는 이 스위치와 활성화된 접근 및 사용 가능한 용량이 필요합니다. |
data.quota.plan_name |
string | 현재 플랜의 읽을 수 있는 이름. |
data.quota.period |
string | 애플리케이션 시간대를 사용한 YYYY-MM 형식의 달별 사용 기간; 반드시 구독 청구 기간과 일치하지는 않을 수 있습니다. |
data.quota.base_limit |
integer | 기본 월간 플랜 허용량. -1 값은 무제한을 의미합니다. |
data.quota.extra_requests |
integer | 현재 사용 기간에 대해 추가 월 허용량이 부여되었습니다; 구매한 크레딧과는 별개입니다. |
data.quota.monthly_limit |
integer | 기본 허용량에 현재 기간 추가 요청을 더한 값입니다. -1은 무제한을 의미합니다. 구매한 크레딧은 포함되지 않습니다. |
data.quota.monthly_remaining |
integer|null | 남은 유한 월별 할당량이며, 월별 할당량이 무제한인 경우 null입니다. null은 0으로 해석해서는 안 됩니다. |
data.quota.used |
integer | 성공적인, 현재 사용 기간 동안 크레딧을 사용한 작업을 포함한 API 작업이 계산됩니다. 상태 확인은 이 값을 증가시키지 않습니다. |
data.quota.purchased_credits |
integer | 현재 크레딧 잔액, 활성 플랜 보너스 크레딧 포함. 보너스 크레딧은 이 잔액에 두 번 추가해서는 안 됩니다. |
data.quota.bonus_credits |
integer | 신용 잔액의 활성 플랜 보너스 부분; purchased_credits의 세부 내역이며, 추가 용량이 아닙니다. |
data.quota.direct_purchased_credits |
integer | 활성 플랜 보너스 부분을 제외한 크레딧 잔액. 이 값에 bonus_credits를 더하면 purchased_credits와 같습니다. |
data.quota.remaining |
integer|null | 보너스를 중복 계산하지 않고 월별 남은 할당량에 현재 크레딧 잔액을 더합니다. Null은 무제한 월 할당량을 의미합니다. 개별 기능 권한 및 기타 요청 제한은 여전히 적용됩니다. |
data.quota.unlimited |
boolean | 월별 할당량이 무제한인지 여부입니다. 이는 계정의 분당 예산이나 다른 기능 제한이 무제한이 되는 것을 의미하지 않습니다. |
data.quota.usage_percent |
integer | 대시보드 호환 반올림 백분율(0~100): 사용량을 사용량과 남은 양의 합으로 나눈 뒤 100을 곱합니다. 사용 가능한 신용 용량을 포함하므로 재충전 시 백분율이 낮아질 수 있습니다. 무제한 할당량이거나 크기가 0인 풀의 경우 0이며, 분당 속도 제한 백분율이나 접근 결정이 아닙니다. |
data.quota.reset_at |
string | 다음 달력 월 할당량 재설정을 위한 시간대 오프셋이 포함된 ISO-8601 타임스탬프입니다. 이는 구독 만료 날짜가 아니며, 월별 재설정은 구매한 크레딧을 보충하지 않습니다. |
status |
string | 이 상태 엔드포인트의 문자 그대로 성공입니다. 다른 성공적인 사서함 엔드포인트는 부울 true를 사용합니다. |
data.monthly_limit |
integer | 해당 data.quota 필드의 호환성 별칭; 잔액을 계산할 때 다시 추가하지 마세요. |
data.monthly_remaining |
integer|null | 해당 data.quota 필드의 호환성 별칭; 잔액을 계산할 때 다시 추가하지 마세요. |
data.purchased_credits |
integer | 해당 data.quota 필드의 호환성 별칭; 잔액을 계산할 때 다시 추가하지 마세요. |
메일박스 웹훅(실시간 푸시)
REST API를 반복적으로 폴링하여 들어오는 메일을 확인하는 대신 (GET /messages), 웹훅을 구성하여 새 메시지를 실시간으로 서버 또는 자동화 워크플로우로 푸시할 수 있습니다.
지원되는 웹훅 이벤트
각 웹훅은 하나 이상의 이벤트 유형에 구독할 수 있습니다. 해당 엔드포인트는 이러한 트리거 중 하나가 발생할 때마다 이벤트 알림을 받습니다.
선택된 메일함에 새 메시지가 도착할 때마다 실시간으로 전송됩니다.
임시 사서함이 만료되고 웹훅 처리가 일시 중지될 때 전송됩니다.
계획 규칙에 따라 만료된 사서함이 다시 활성화될 때 전송됩니다.
웹훅 및 해당 사서함이 삭제되기 직전에 전송됨.
요청 헤더 및 HMAC 서명 검증
모든 웹훅 배송에는 특별한 보안 헤더가 포함되어 있습니다. TempMailg에서 진짜로 발송되었으며 변조되지 않았음을 확인하기 위해 X-TempMailg-Signature 헤더를 사용합니다.
| 헤더 이름 | 예시 값 | 설명 |
|---|---|---|
User-Agent |
TempMailg-Webhooks/1.0 | 웹훅 전달 작업자를 위한 표준 식별자. |
X-TempMailg-Event |
email.received | 이 전달을 트리거한 이벤트 유형. |
X-TempMailg-Event-Id |
e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c | 이 배달 시도에 할당된 고유 UUID. |
X-TempMailg-Timestamp |
1725192000 | 요청이 시작된 시점을 나타내는 Unix epoch 타임스탬프. |
X-TempMailg-Signature |
sha256=d7a8fbb307d7809469ca933b02d82941... | 귀하의 비밀키를 사용하여 {timestamp}.{raw_body}에서 계산된 HMAC-SHA256 서명. |
X-TempMailg-Test |
false | 대시보드의 "Send Test Ping" 기능에 의해 전송될 때 True. |
이 시그니처는 HMAC과 SHA256을 사용하여 다음 문자열에 대해 계산됩니다:
hash_hmac('sha256', "${X-TempMailg-Timestamp}.${raw_request_body}", your_webhook_secret)
샘플 이벤트 페이로드 (email.received)
HTTP POST 요청 본문에 application/json 형식으로 전송됩니다.
{
"id": "e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"version": "1.0",
"event": "email.received",
"occurred_at": "2026-11-19T02:17:54+00:00",
"test": false,
"mailbox": {
"id": 1024,
"email": "developer@v1.tempmailg.com"
},
"data": {
"message_id": "7a8b9c0d1e2f",
"subject": "Your Verification Code: 948201",
"from": "auth@service.com",
"to": "developer@v1.tempmailg.com",
"date": "2026-11-19T02:17:54+00:00",
"attachments_count": 0,
"text_preview": "Hello, your one-time verification code is 948201. It will expire in 10 minutes.",
"email_url": "https://tempmailg.com/mailbox/1024?message=7a8b9c0d1e2f",
"inbox_url": "https://tempmailg.com/mailbox/1024"
}
}
수신자 구현 예시
웹훅을 수신하고 HMAC 서명을 안전하게 검증하는 방법을 보려면 언어를 선택하세요.
const express = require('express');
const crypto = require('crypto');
const app = express();
const WEBHOOK_SECRET = 'your_webhook_signing_secret';
// Capture raw body buffer for HMAC-SHA256 signature verification
app.use(express.json({
verify: (req, res, buf) => {
req.rawBody = buf.toString('utf8');
}
}));
app.post('/webhook', (req, res) => {
const timestamp = req.headers['x-tempmailg-timestamp'];
const signatureHeader = req.headers['x-tempmailg-signature'] || '';
// Calculate HMAC-SHA256 signature
const expectedSignature = 'sha256=' + crypto
.createHmac('sha256', WEBHOOK_SECRET)
.update(`${timestamp}.${req.rawBody}`)
.digest('hex');
// Verify signature
if (signatureHeader !== expectedSignature) {
return res.status(401).json({ error: 'Invalid webhook signature' });
}
const { event, mailbox, data } = req.body;
console.log(`[Event: ${event}] Mailbox: ${mailbox.email}`);
if (event === 'email.received') {
console.log(`From: ${data.from}`);
console.log(`Subject: ${data.subject}`);
console.log(`Preview: ${data.text_preview}`);
}
// Acknowledge receipt with HTTP 200
res.status(200).json({ received: true });
});
app.listen(3000, () => console.log('Webhook receiver running on port 3000'));
from flask import Flask, request, jsonify
import hmac
import hashlib
app = Flask(__name__)
WEBHOOK_SECRET = b"your_webhook_signing_secret"
@app.route("/webhook", methods=["POST"])
def handle_webhook():
timestamp = request.headers.get("X-TempMailg-Timestamp", "")
signature_header = request.headers.get("X-TempMailg-Signature", "")
# Calculate expected HMAC-SHA256 signature
raw_body = request.get_data()
signed_payload = f"{timestamp}.".encode("utf-8") + raw_body
expected_signature = "sha256=" + hmac.new(
WEBHOOK_SECRET, signed_payload, hashlib.sha256
).hexdigest()
# Verify signature securely
if not hmac.compare_digest(signature_header, expected_signature):
return jsonify({"error": "Invalid signature"}), 401
payload = request.get_json()
event = payload.get("event")
mailbox = payload.get("mailbox", {}).get("email")
data = payload.get("data", {})
print(f"[{event}] Mailbox: {mailbox}")
if event == "email.received":
print(f"From: {data.get('from')}")
print(f"Subject: {data.get('subject')}")
print(f"Preview: {data.get('text_preview')}")
# Return 200 OK to acknowledge receipt
return jsonify({"received": True}), 200
if __name__ == "__main__":
app.run(port=5000)
<?php
$secret = 'your_webhook_signing_secret';
$rawBody = file_get_contents('php://input');
$timestamp = $_SERVER['HTTP_X_TEMPMAILG_TIMESTAMP'] ?? '';
$receivedSignature = $_SERVER['HTTP_X_TEMPMAILG_SIGNATURE'] ?? '';
// Calculate HMAC-SHA256 signature
$expectedSignature = 'sha256=' . hash_hmac('sha256', $timestamp . '.' . $rawBody, $secret);
// Verify signature
if (!hash_equals($expectedSignature, $receivedSignature)) {
http_response_code(401);
echo json_encode(['error' => 'Invalid signature']);
exit;
}
$payload = json_decode($rawBody, true);
$event = $payload['event'] ?? '';
$mailbox = $payload['mailbox']['email'] ?? '';
$data = $payload['data'] ?? [];
if ($event === 'email.received') {
$sender = $data['from'] ?? '';
$subject = $data['subject'] ?? '';
$preview = $data['text_preview'] ?? '';
// Process new incoming email...
}
// Acknowledge receipt
http_response_code(200);
echo json_encode(['received' => true]);
지원되는 플랫폼 및 자동화 통합
TempMailg 웹훅은 표준 HTTPS 엔드포인트와 주요 노코드/자동화 플랫폼에서 바로 사용할 수 있습니다:
일반적인 오류 및 문제 해결
사용자 API를 통합하는 동안 나타날 수 있는 가장 일반적인 응답 코드입니다.
잘못된, 누락되었거나 취소된 Bearer 토큰입니다.
소유권, 기능 권한, 도메인 접근 또는 첨부 파일 크기로 인해 작업이 차단되었습니다. 응답 코드와 메시지를 확인하십시오.
리소스가 허용된 호스트에서 찾을 수 없거나 사용자에게 속하지 않습니다.
작업 키가 다른 세부 정보와 함께 재사용되었거나, 다른 작업이 진행 중이거나, 사서함 보안이 변경되었습니다. 재시도하기 전에 코드를 확인하십시오.
메일박스가 만료되거나 비활성화되었습니다.
잘못된 매개변수, 허용되지 않은 수명, 사용 불가능한 별칭 용량, 잘못된 PIN 설정 또는 누락/잘못된 Idempotency-Key 때문에 작업이 방지되었습니다.
보호된 메일함에는 유효한 범위가 지정된 X-Mailbox-Unlock 토큰이 필요합니다. 삭제를 위해 응답에 포함된 action 및 target_id를 사용하십시오. 잠금 해제 또는 복구 요구 사항이 해결된 후에 다시 시도해야 합니다.
요청 제한, 비활성화된 플랜, 할당량 소진, 또는 쿨다운으로 인해 작업이 차단되었습니다. 이유와 사용 가능한 예산 헤더를 확인하세요. Retry-After는 선택 사항입니다.
서버가 작업을 완료할 수 없습니다. 보호된 생성 또는 삭제의 경우, 재시도 시 동일한 요청 및 Idempotency-Key를 유지하십시오.
보호 저장소 또는 조정을 확인할 수 없습니다. 표시된 지연 후에 다시 시도하십시오. 이 응답은 결제 실패가 아닙니다.
빠른 체크리스트
- 401 Unauthorized - Bearer 토큰이 누락되었거나, 잘못되거나, 취소되었거나, 잘못 복사되었습니다.
- 403 Forbidden - 현재 플랜에는 사용자 API 액세스 권한이 없습니다.
- 404 Not Found - 자원 미발견 또는 유효하지 않은 매개변수
- 410 Gone / Expired - 메일박스가 만료되거나 더 이상 활성화되지 않습니다.
- 429 Rate Limited - 응답 이유와 예산 헤더를 확인하십시오. Retry-After는 시간 제한에만 적용되며, 크레딧이 소진되었거나 접근이 비활성화된 경우 계정 변경이 필요할 수 있습니다.
권장되는 다음 단계
로그인한 경우 API 관리를 먼저 열고 디버깅하기 전에 키, 할당량, 플랜 액세스 상태 및 정확한 사용자 API 기본 URL을 확인하세요.