TempMailg เอกสาร API

ใช้เอกสารนี้เพื่อสร้างคีย์ API ส่วนบุคคลของคุณ เชื่อมต่อโฮสต์ API ผู้ใช้เฉพาะ อ่านข้อความกล่องจดหมาย จัดการกล่องจดหมายที่เป็นเจ้าของ และรวม Temp Mail เข้ากับแอปหรือการทำงานอัตโนมัติของคุณ

URL ฐาน API ของผู้ใช้

รูปแบบคำขอ ใช้คีย์ API ของคุณเฉพาะในหัวข้อ Authorization Bearer และรักษา URL จุดสิ้นสุดให้สะอาด

เข้าสู่ระบบเพื่อสร้างคีย์ API สร้างบัญชี

รายการเช็คการตั้งค่าเร็ว

เปิดหน้า API Management ของแดชบอร์ดของคุณและสร้างคีย์ API ส่วนบุคคลของคุณ
คัดลอก URL ฐาน API ผู้ใช้โดยตรงตามที่แสดง เช่น https://v1.yourdomain.com/api.
ส่งคำขอทั้งหมดไปยังโฮสต์ API นั้นพร้อม Authorization: Bearer YOUR_USER_API_KEY และ Accept: application/json.
ติดตามคota การร้องขอของคุณทุกเดือนจากหน้าเดียวกัน และจากส่วนหัวคota ที่ส่งกลับในคำตอบ API ของผู้ใช้ทุกครั้ง การร้องขอที่สำเร็จ 2xx เท่านั้นที่จะถูกนับเข้ากับคota

หาก API ส่งกลับ 404 ตรวจสอบให้แน่ใจว่าคุณกำลังเรียกใช้โฮสต์ API ผู้ใช้ที่เฉพาะเจาะจงตามที่แสดงในหน้า API Management ของคุณ

การเข้าถึงคีย์ API

เข้าสู่ระบบเพื่อสร้างคีย์ API ส่วนบุคคลและดูรายละเอียดควอต้าแบบเรียลไทม์

เข้าสู่ระบบ ลงทะเบียน

การไหลของการรับรองความถูกต้อง

สร้างคีย์ API ส่วนบุคคลของคุณจากหน้า API Management
ส่งคีย์เป็นโทเค็น Bearer ในทุกการร้องขอ
ใช้ URL ฐาน API ผู้ใช้ที่เฉพาะเจาะจงที่แสดงในหน้า API Management ของคุณ
สร้างคีย์ใหม่เมื่อคุณต้องการยกเลิกคีย์เก่าและเริ่มใช้คีย์ใหม่ทันที

ความสามารถในการมองเห็นคีย์ คีย์ API ผู้ใช้ของคุณจะยังคงมองเห็นได้ภายในหน้า API Management ของคุณจนกว่าคุณจะสร้างคีย์ใหม่หรือยกเลิกมัน

ส่วนหัวที่จำเป็น

Authorization: Bearer YOUR_USER_API_KEY
Accept: application/json

ส่วนหัวคota ที่ส่งกลับในคำตอบทุกครั้ง

ค่าคota เหล่านี้จะเพิ่มขึ้นเฉพาะหลังจากคำตอบ 2xx ที่สำเร็จ

X-RateLimit-Limit: 50000
X-RateLimit-Used: 124
X-RateLimit-Remaining: 49876
X-RateLimit-Reset: 2026-05-01T00:00:00+05:00

จุดสิ้นสุด API ผู้ใช้

จุดสิ้นสุดทุกจุดด้านล่างใช้ URL ฐานและโทเค็น Bearer เหมือนกัน การร้องขอ Mailbox, ข้อความ และส่วนประกอบจะถูกตรวจสอบกับบัญชีผู้ใช้ที่รับรองความถูกต้อง

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

รับโดเมนที่อนุญาตสำหรับแผนผู้ใช้ปัจจุบันและบัญชี

ค่าประเภทที่อนุญาต: free, premium, all. แผนฟรีสามารถใช้ได้เฉพาะ free. แผนพรีเมียมสามารถใช้ free, premium, หรือ 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'

ตัวอย่างการตอบสนอง

{
    "status": true,
    "data": {
        "requested_type": "free",
        "allowed_types": [
            "free"
        ],
        "domains": [
            {
                "domain": "example.com",
                "type": "Free",
                "custom": false
            }
        ]
    }
}

POST https://v1.tempmailg.com/api/emails

สร้างกล่องจดหมายใหม่แบบสุ่มที่เป็นเจ้าของโดยผู้ใช้ที่ได้รับการยืนยันตัวตน

สร้างกล่องจดหมายสุ่ม

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'

ตัวอย่างการตอบสนอง

{
    "status": true,
    "data": {
        "id": 2301,
        "email": "randombox@example.com",
        "domain": "example.com",
        "expire_at": "2026-06-28T09:47:06+00:00",
        "expires_in_seconds": 600,
        "created_at": "2026-06-28T09:37:06+00:00",
        "email_token": "encrypted-email-token"
    }
}

POST https://v1.tempmailg.com/api/emails/{email}/{username}/{domain}

อัปเดตหรือเปลี่ยนกล่องจดหมายที่มีอยู่ที่เป็นเจ้าของเป็นชื่อผู้ใช้ใหม่และโดเมนที่อนุญาต

ใช้กล่องจดหมายที่มีอยู่ที่เป็นเจ้าของอีเมลใน {email}

อัปเดตกล่องจดหมายที่เป็นเจ้าของ

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'

ตัวอย่างการตอบสนอง

{
    "status": true,
    "data": {
        "id": 2302,
        "email": "demo123@example.com",
        "domain": "example.com",
        "expire_at": "2026-06-28T09:47:06+00:00",
        "expires_in_seconds": 600,
        "created_at": "2026-06-28T09:37:06+00:00",
        "email_token": "encrypted-email-token"
    }
}

DELETE https://v1.tempmailg.com/api/emails/{email}

ลบกล่องจดหมายที่เป็นเจ้าของ

ลบกล่องจดหมายที่เป็นเจ้าของ

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'

ตัวอย่างการตอบสนอง

{
    "status": true,
    "message": "Email has been successfully deleted."
}

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

รายการข้อความสำหรับกล่องจดหมายที่เป็นเจ้าของ

พารามิเตอร์คำถามอีเมลต้องเป็นของบัญชีผู้ใช้ที่ได้รับการยืนยันตัวตน

อ่านข้อความกล่องจดหมาย

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'

ตัวอย่างการตอบสนอง

{
    "status": true,
    "mailbox": "randombox@example.com",
    "messages": [
        {
            "is_seen": false,
            "subject": "Welcome to Temp Mail",
            "from": "Example Sender",
            "from_email": "hello@example.org",
            "to": "randombox@example.com",
            "receivedAt": "2026-06-28 09:37:06",
            "id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
            "html": true,
            "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"
                }
            ]
        }
    ]
}

GET https://v1.tempmailg.com/api/messages/{messageId}

อ่านข้อความที่เป็นเจ้าของข้อความเดียว

อ่านข้อความหนึ่ง

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'

ตัวอย่างการตอบสนอง

{
    "status": true,
    "data": {
        "is_seen": true,
        "subject": "Welcome to Temp Mail",
        "from": "Example Sender",
        "from_email": "hello@example.org",
        "to": "randombox@example.com",
        "receivedAt": "2026-06-28 09:37:06",
        "id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
        "html": true,
        "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"
            }
        ]
    }
}

DELETE https://v1.tempmailg.com/api/messages/{messageId}

ลบข้อความที่เป็นเจ้าของข้อความเดียว

ลบข้อความหนึ่ง

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'

ตัวอย่างการตอบสนอง

{
    "status": true,
    "message": "Message was deleted successfully."
}

GET https://v1.tempmailg.com/api/messages/{messageId}/attachments/{filename}

ดาวน์โหลดไฟล์แนบจากข้อความที่เป็นเจ้าของ

จุดสิ้นสุดนี้ดาวน์โหลดไฟล์โดยตรง

ดาวน์โหลดไฟล์แนบ

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

พฤติกรรมการดาวน์โหลด จุดสิ้นสุดนี้ส่งกลับไฟล์ที่ร้องขอโดยตรงแทนร่างกาย JSON

ข้อผิดพลาดทั่วไปและการแก้ไขปัญหา

นี่คือรหัสคำตอบที่พบบ่อยที่สุดที่คุณอาจเห็นขณะรวม API ผู้ใช้

401 โทเค็น Bearer ไม่ถูกต้องหรือไม่มี

403 การเข้าถึง API ของผู้ใช้ถูกปิดใช้งานสำหรับแผนผู้ใช้ปัจจุบัน

404 ทรัพยากรไม่พบในโฮสต์ที่อนุญาตหรือไม่ได้เป็นเจ้าของโดยผู้ใช้

410 กล่องจดหมายหมดอายุหรือไม่ทำงาน

422 การตรวจสอบล้มเหลวหรือกล่องจดหมาย/โดเมนที่ร้องขอไม่ได้รับอนุญาต

429 ควอต้า API ผู้ใช้รายเดือนถูกเกิน

รายการตรวจสอบอย่างรวดเร็ว

401 - โทเค็น Bearer หายไป, ไม่ถูกต้อง, ถูกยกเลิก หรือคัดลอกไม่ถูกต้อง
403 - แผนปัจจุบันไม่มีสิทธิ์การเข้าถึง API ผู้ใช้ ณ ตอนนี้
404 - Mailbox, ข้อความ หรือส่วนประกอบไม่属于ผู้ใช้นั้น หรือโฮสต์ที่ใช้ผิด
410 - กล่องจดหมายหมดอายุหรือไม่ใช้งานแล้ว
429 - ควอต้าคำขอเดือนเต็มแล้วสำหรับช่วงเวลาปัจจุบัน

ขั้นตอนต่อไปที่แนะนำ

หากคุณเข้าสู่ระบบแล้ว ให้เปิด API Management ก่อนและยืนยันสถานะคีย์ ควอต้า แผนการเข้าถึง และ URL ฐาน API ของผู้ใช้จริงก่อนที่จะแก้ไขแอปภายนอก

เข้าสู่ระบบเพื่อ設定คีย์ API