TempMail API 문서

REST API v1 및 Webhooks

TempMailg 개발자 API 문서

이 문서를 사용하여 개인 API 키를 생성하고, 전용 사용자 API 호스트에 연결하고, 메일박스 메시지를 읽고, 소유한 메일박스를 관리하며, Temp Mail을 자신의 앱이나 자동화에 통합합니다.

베어러 토큰 인증 실시간 웹훅 Gmail & Outlook 별칭 JSON 응답
사용자 API 기본 URL HTTPS
요청 형식 Authorization Bearer 헤더에서만 API 키를 사용하고 엔드포인트 URL을 깨끗하게 유지합니다.

사서함 관리

허용된 도메인을 가져오기, 메일함을 만들거나 전환하기, 허용된 수명을 선택하기, 그리고 소유한 주소를 삭제하기.

GET https://v1.tempmailg.com/api/domains?type={type}
#

허용된 도메인 목록

임시 이메일을 만들기 위해 사용 가능한 도메인을 나열합니다. 구독 플랜에서 지원하는 무료, 프리미엄 또는 맞춤 도메인만 보려면 유형별로 필터링하세요.

매개변수 1
매개변수 위치 유형 상태 설명
type query string 선택 사항
도메인 티어 필터. 생략 시 프리미엄 도메인 접근이 활성화된 경우 전체를 사용하고, 그렇지 않으면 무료를 사용합니다. 인식되는 값: free, basic, pro, premium, custom, ultimate, all
기본: 계정 종속
허용된 도메인 가져오기
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
맞춤 도메인인지 여부.
POST https://v1.tempmailg.com/api/emails
#

임시 메일함 만들기

소유한 임시 사서함을 생성합니다. 무작위 생성을 위해 사용자 이름과 도메인을 생략하거나 허용된 사용자 정의 이름과 허용된 도메인을 제공하십시오. provider 매개변수는 Gmail 또는 Outlook 별칭 생성을 선택할 수 있습니다.

매개변수 8
매개변수 위치 유형 상태 설명
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를 반환합니다.
메일함 만들기
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 형식의 절대 읽기 권한 만료. 보안 변경으로 인해 권한이 조기에 취소될 수 있습니다.
POST https://v1.tempmailg.com/api/emails/{email}/{username}/{domain}
#

메일함 업데이트 / 전환

현재 사서함의 소유권을 확인한 후 새 사용자 이름 및 도메인에서 사서함을 생성하거나 선택합니다. 이는 기존 사서함의 이름을 바꾸거나 수명을 직접 변경하지 않습니다. 대상이 다를 경우, 기존 사서함은 기록에 남으며 활성 사서함 제한에 의해 일시 중지될 수 있습니다. 자체 활성 대상을 재사용하면 요청된 수명 또는 기본 플랜이 다시 적용됩니다.

매개변수 9
매개변수 위치 유형 상태 설명
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>
{email}에 있는 기존의 소유한 메일박스 이메일을 사용합니다. 선택적 본문 매개변수: 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를 반환합니다.
소유한 메일박스 업데이트하기
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 형식의 절대 읽기 권한 만료. 보안 변경으로 인해 권한이 조기에 취소될 수 있습니다.
DELETE https://v1.tempmailg.com/api/emails/{email}
#

메일함 삭제

소유한 메일함을 삭제하고 해당 메시지와 파일 정리를 실행합니다. 보관된 메일함 기록은 내부적으로 소프트 삭제될 수 있으며; 주소는 API를 통해 더 이상 사용할 수 없습니다.

매개변수 3
매개변수 위치 유형 상태 설명
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자 길이의 안정적인 키. 동일한 키로 동일한 요청을 재시도하여 중복 작업을 방지하십시오.
소유한 메일박스 삭제하기
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 별칭 메일함을 생성합니다.

POST https://v1.tempmailg.com/api/gmail-alias/emails
#

Gmail 별칭 만들기

인증된 사용자가 소유하는 새로운 Gmail 별칭 임시 사서함을 생성합니다.

매개변수 8
매개변수 위치 유형 상태 설명
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자 길이의 안정적인 키. 동일한 키로 동일한 요청을 재시도하여 중복 작업을 방지하십시오.
구독 플랜에서 Gmail Alias API 권한을 활성화하거나 API 크레딧 패키지를 통해 잠금 해제해야 합니다. 선택적 매개변수: 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를 반환합니다.
Gmail 별칭 사서함 만들기
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 형식의 절대 읽기 권한 만료. 보안 변경으로 인해 권한이 조기에 취소될 수 있습니다.
GET https://v1.tempmailg.com/api/outlook-alias/domains
#

Outlook 별칭 도메인

메일함 생성을 위해 사용할 수 있는 활성 Outlook / Hotmail 별칭 도메인을 가져옵니다.

구독 플랜에서 Outlook Alias API 권한이 활성화되어 있거나 API 크레딧 패키지를 통해 잠금 해제되어야 합니다. 특정 도메인 선택이 플랜에서 잠금 해제되었는지 여부를 나타냅니다.
Outlook 별칭 도메인 가져오기
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.
POST https://v1.tempmailg.com/api/outlook-alias/emails
#

Outlook 별칭 만들기

인증된 사용자가 소유한 새로운 Outlook / Hotmail 별칭 임시 사서함을 생성합니다.

매개변수 7
매개변수 위치 유형 상태 설명
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자 길이의 안정적인 키. 동일한 키로 동일한 요청을 재시도하여 중복 작업을 방지하십시오.
구독 플랜에서 Outlook Alias API 권한이 활성화되어 있거나 API 크레딧 패키지를 통해 잠금 해제되어야 합니다. 선택적 매개변수: 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를 반환합니다.
Outlook 별칭 사서함 생성
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/텍스트 메시지를 읽으며, 첨부 파일을 스트리밍합니다.

GET https://v1.tempmailg.com/api/messages?email={email}
#

사서함 메시지 목록

사용 가능한 메시지 요약 및 사서함 메타데이터를 검색합니다. 표준 받은편지함 스캔은 최대 25개의 최신 메시지 배치를 반환하며, 이는 페이지화된 전체 기록 엔드포인트가 아닙니다. 전체 본문 및 첨부파일을 보려면 GET /messages/{messageId}를 사용하십시오.

매개변수 2
매개변수 위치 유형 상태 설명
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>
이 이메일은 귀하의 계정에 속해야 합니다. 표준 및 Gmail 요약에는 OTP 및 verification-link 필드가 포함되어 있으며; Outlook에는 from_name, snippet, received_at 및 has_attachments도 포함됩니다. 공급자 동기화 및 캐싱으로 인해 새 메시지와 카운트가 지연될 수 있습니다.
메일박스 메시지 읽기
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 요약 필드: 첨부 파일 메타데이터가 존재하는지 여부. 다운로드 가능 여부는 별도로 확인됩니다.
GET https://v1.tempmailg.com/api/messages/{messageId}
#

단일 메시지 가져오기

불투명한 메시지 ID로 소유된 메시지를 검색합니다. 본문 형식 및 첨부 파일 메타데이터를 반환합니다. 본문 필드는 메시지 형식에 따라 다르며; Outlook은 아래에 나열된 공급자별 필드를 추가합니다.

매개변수 2
매개변수 위치 유형 상태 설명
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>
하나의 메시지 읽기
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 본문이 존재하는지 여부.
DELETE https://v1.tempmailg.com/api/messages/{messageId}
#

메시지 삭제

소유한 메시지 하나를 삭제합니다.

매개변수 3
매개변수 위치 유형 상태 설명
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자 길이의 안정적인 키. 동일한 키로 동일한 요청을 재시도하여 중복 작업을 방지하십시오.
한 개의 메시지를 삭제
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를 반환합니다.
GET https://v1.tempmailg.com/api/messages/{messageId}/attachments/{filename}
#

첨부 파일 다운로드

소유한 메시지에서 첨부 파일을 다운로드합니다.

매개변수 3
매개변수 위치 유형 상태 설명
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>
성공 시 파일 바이트를 반환하며 JSON을 반환하지 않습니다. 파일이 너무 큰 경우 HTTP 403을 반환하고, 로컬 파일이 없거나 사용할 수 없는 경우 HTTP 404를 반환합니다. 파일 이름을 단일 경로 세그먼트로 URL 인코딩하십시오. 첨부 파일 메타데이터만으로는 다운로드 가능성을 보장하지 않습니다.
첨부 파일을 다운로드
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
다운로드 동작 이 엔드포인트는 JSON 본문 대신 요청된 파일을 직접 반환합니다.
응답 필드
필드 유형 설명
Content-Disposition header
성공적인 응답이 요청된 파일명을 다운로드합니다.
body binary
성공 시 파일 바이트를 반환하고, JSON은 반환하지 않습니다. 오류는 비-2xx 상태와 함께 JSON을 반환합니다.

속도 제한 및 할당량

크레딧을 소모하지 않고 실시간 요청 예산, 속도 제한 및 계정 할당량을 모니터링합니다.

GET https://v1.tempmailg.com/api/rate-limit
#

속도 제한 및 할당량

API 사용량을 소모하지 않고 현재 속도 제한 및 할당량 상태를 확인하세요. 이 엔드포인트는 할당량이 없으며 월간 API 크레딧을 차감하지 않습니다 (남용 방지 제한: 60 요청/분).

X-RateLimit-* 은 표시된 요청 예산을 설명합니다; X-Quota-* 은 사용 가능한 경우 월별 및 구매된 용량을 설명합니다. X-Mailbox-RateLimit-* 은 별도의 사서함 생성/업데이트 예산을 보고합니다. 사서함 전용 거부는 사서함 범위와 자체 재시도 창을 사용합니다. 분당 제한 거부는 할당량 정보를 생략할 수 있습니다. Retry-After 는 시간 제한 재시도에만 포함됩니다; 접근이 비활성화된 경우 계정 변경이 필요할 수 있습니다. 이 성공적인 상태 응답에서 data.limit, data.remaining 및 data.reset은 사용 가능한 크레딧이 아니라 계정 분당 예산을 설명합니다. data.quota 객체는 월별 할당량, 크레딧 잔액 및 사용량을 설명합니다. 기존 data.monthly_limit, data.monthly_remaining 및 data.purchased_credits 필드는 해당 quota 필드의 별칭으로 유지됩니다. 성공적인 상태 확인은 다른 API 작업을 허가하지 않습니다. 작업은 여전히 활성화된 접근 권한, 사용 가능한 할당량 및 모든 적용 가능한 제한을 통과해야 합니다. 할당량 스냅샷은 진행 중인 요청에 의해 이미 예약된 용량을 보장하지 않습니다.
요금 제한 상태 확인
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 필드의 호환성 별칭; 잔액을 계산할 때 다시 추가하지 마세요.

우편함 PIN 보호

계속하려면 PIN을 입력하세요. 이 웹사이트 세션이 현재인 동안 메일함이 잠금 해제된 상태를 유지합니다.

쿠키를 수락하시겠습니까?

저희는 귀하의 브라우징 경험을 향상시키기 위해 쿠키를 사용합니다. 이 사이트를 이용함으로써 귀하는 저희 쿠키 정책에 동의하는 것입니다.

더 많은