## การยืนยันตัวตน

เรียนรู้วิธีรับและใช้คีย์ API

## รับคีย์ API

ก่อนใช้ API คุณต้องได้รับคีย์ API คุณสามารถสร้างคีย์ API ของคุณได้ในหน้าโปรไฟล์

### การใช้คีย์ API

รวมคีย์ API ของคุณในส่วนหัวคำขอสำหรับคำขอ API ทั้งหมด:

[Code (bash)]
X-API-Key: YOUR_API_KEY
[/Code]

### หมายเหตุสำคัญ

- เก็บคีย์ API ของคุณให้ปลอดภัยและอย่าเปิดเผยในที่สาธารณะ
- คีย์ API มีสิทธิ์เดียวกับบัญชีของคุณ ใช้อย่างระมัดระวัง
- หากคีย์ API ของคุณถูกบุกรุก ให้สร้างใหม่ทันทีในหน้าโปรไฟล์ของคุณ

---

## Email API

สร้างและจัดการอีเมล

## รับโดเมนที่ใช้ได้

รับโดเมนอีเมลทั้งหมดที่ใช้ได้ในระบบ

### คำขอ

[Code (bash)]
GET /api/email/domains
[/Code]

### ตัวอย่างคำขอ

[Code (bash)]
curl https://chat-tempmail.com/api/email/domains \
  -H "X-API-Key: YOUR_API_KEY"
[/Code]

### พารามิเตอร์การตอบสนอง

พารามิเตอร์ | ประเภท | คำอธิบาย
----------- | ------ | -------------
domains | array | รายการโดเมนอีเมลที่ใช้ได้

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

[Code (json)]
{
  "domains": [
    "chat-tempmail.com",
    "example.com", 
    "other-domain.com"
  ]
}
[/Code]

## สร้างอีเมล

สร้างที่อยู่อีเมลชั่วคราวใหม่

### คำขอ

[Code (bash)]
POST /api/emails/generate
[/Code]

### พารามิเตอร์คำขอ

พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย
----------- | ------ | ---------- | -------------
name | string | ใช่ | คำนำหน้าอีเมล
expiryTime | number | ใช่ | เวลาหมดอายุ (มิลลิวินาที)<br/>ค่าที่ใช้ได้:<br/>- 3600000 (1 ชั่วโมง)<br/>- 86400000 (1 วัน)<br/>- 259200000 (3 วัน)<br/>- 0 (ถาวร)
domain | string | ใช่ | โดเมนอีเมล

### ตัวอย่างคำขอ

[Code (bash)]
curl -X POST https://chat-tempmail.com/api/emails/generate \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "test",
    "expiryTime": 3600000,
    "domain": "chat-tempmail.com"
  }'
[/Code]

### พารามิเตอร์การตอบสนอง

พารามิเตอร์ | ประเภท | คำอธิบาย
----------- | ------ | -------------
id | string | ตัวระบุเฉพาะของอีเมล (รูปแบบ UUID)
email | string | ที่อยู่อีเมลที่สร้างขึ้น (ที่อยู่อีเมลเต็ม)

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

[Code (json)]
{
  "id": "c2c4f894-c672-4d5b-a918-abca95aff1f7",
  "email": "test@chat-tempmail.com"
}
[/Code]

## รับรายการอีเมล

รับที่อยู่อีเมลทั้งหมดภายใต้บัญชีของคุณ

### คำขอ

[Code (bash)]
GET /api/emails
[/Code]

### พารามิเตอร์คำขอ

พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย
----------- | ------ | ---------- | -------------
cursor | string | ไม่ | cursor การแบ่งหน้า รับ nextCursor จากคำตอบก่อนหน้า

### ตัวอย่างคำขอ

[Code (bash)]
curl https://chat-tempmail.com/api/emails \
  -H "X-API-Key: YOUR_API_KEY"
[/Code]

### พารามิเตอร์การตอบสนอง

พารามิเตอร์ | ประเภท | คำอธิบาย
----------- | ------ | -------------
emails | array | รายการอีเมล (สูงสุด 20 รายการต่อคำขอ)
nextCursor | string | cursor หน้าถัดไปสำหรับรับข้อมูลเพิ่มเติม
total | number | จำนวนอีเมลทั้งหมด

### วัตถุอีเมลในอาร์เรย์ emails

พารามิเตอร์ | ประเภท | คำอธิบาย
----------- | ------ | -------------
id | string | ตัวระบุเฉพาะของอีเมล (รูปแบบ UUID)
address | string | ที่อยู่อีเมล (ที่อยู่อีเมลเต็ม)
userId | string | ID ผู้ใช้ที่เป็นเจ้าของอีเมล (รูปแบบ UUID)
createdAt | string | เวลาสร้างอีเมล (รูปแบบ ISO 8601)
expiresAt | string | เวลาหมดอายุอีเมล (รูปแบบ ISO 8601)

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

[Code (json)]
{
  "emails": [
    {
      "id": "e4ff5c14-8a72-48c5-bd13-b5347fb944da",
      "address": "6Tg3VT@chat-tempmail.com",
      "userId": "bd08008d-e944-44b2-a0d0-67f2b528ee6d",
      "createdAt": "2025-04-21T08:30:45.084Z",
      "expiresAt": "2025-04-22T08:30:45.084Z"
    }
  ],
  "nextCursor": "fd13a8df-1465-4fbc-a612-ca7311c31ff2",
  "total": 20
}
[/Code]

## ลบอีเมล

ลบที่อยู่อีเมลที่ระบุ

### คำขอ

[Code (bash)]
DELETE /api/emails/{emailId}
[/Code]

### พารามิเตอร์คำขอ

พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย
----------- | ------ | ---------- | -------------
emailId | string | ใช่ | ID อีเมล (พารามิเตอร์เส้นทาง)

### ตัวอย่างคำขอ

[Code (bash)]
curl -X DELETE "https://chat-tempmail.com/api/emails/99fadf12-6826-490a-9c6c-b0b528d4a8e0" \
  -H "X-API-Key: YOUR_API_KEY"
[/Code]

### พารามิเตอร์การตอบสนอง

พารามิเตอร์ | ประเภท | คำอธิบาย
----------- | ------ | -------------
success | boolean | การลบสำเร็จหรือไม่

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

[Code (json)]
{
  "success": true
}
[/Code]

---

## Message API

จัดการข้อความ

## รับรายการข้อความ

รับข้อความทั้งหมดในที่อยู่อีเมลที่ระบุ

### คำขอ

[Code (bash)]
GET /api/emails/{emailId}
[/Code]

### พารามิเตอร์คำขอ

พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย
----------- | ------ | ---------- | -------------
emailId | string | ใช่ | ID อีเมล (พารามิเตอร์เส้นทาง)
cursor | string | ไม่ | cursor การแบ่งหน้า (พารามิเตอร์คำขอ) รับ nextCursor จากคำตอบก่อนหน้า

### ตัวอย่างคำขอ

[Code (bash)]
curl "https://chat-tempmail.com/api/emails/c2c4f894-c672-4d5b-a918-abca95aff1f7" \
  -H "X-API-Key: YOUR_API_KEY"
[/Code]

### พารามิเตอร์การตอบสนอง

พารามิเตอร์ | ประเภท | คำอธิบาย
----------- | ------ | -------------
messages | array | รายการข้อความ (สูงสุด 20 รายการต่อคำขอ)
nextCursor | string | cursor หน้าถัดไปสำหรับรับข้อมูลเพิ่มเติม
total | number | จำนวนข้อความทั้งหมด

### วัตถุข้อความในอาร์เรย์ messages

พารามิเตอร์ | ประเภท | คำอธิบาย
----------- | ------ | -------------
id | string | ตัวระบุเฉพาะของข้อความ (รูปแบบ UUID)
from_address | string | ที่อยู่ผู้ส่ง
subject | string | หัวข้อข้อความ
received_at | number | เวลาที่ได้รับ (Unix timestamp ในมิลลิวินาที)

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

[Code (json)]
{
  "messages": [
    {
      "id": "fd13a8df-1465-4fbc-a612-ca7311c31ff2",
      "from_address": "sender1@example.com",
      "subject": "Test Message 1 - xJOK2h",
      "received_at": 1745224245084
    }
  ],
  "nextCursor": "eyJ0aW1lc3RhbXAiOjE3NDUxNTU4NDUwODQsImlkIjoiNjNmNzFlODYtOGE1NC00ZDQ0LTk5ZWYtN2QzNTBhMTQ4M2JiIn0=",
  "total": 50
}
[/Code]

## รับรายละเอียดข้อความ

รับเนื้อหารายละเอียดของข้อความที่ระบุ

### คำขอ

[Code (bash)]
GET /api/emails/{emailId}/{messageId}
[/Code]

### พารามิเตอร์คำขอ

พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย
----------- | ------ | ---------- | -------------
emailId | string | ใช่ | ID อีเมล (พารามิเตอร์เส้นทาง)
messageId | string | ใช่ | ID ข้อความ (พารามิเตอร์เส้นทาง)

### ตัวอย่างคำขอ

[Code (bash)]
curl "https://chat-tempmail.com/api/emails/99fadf12-6826-490a-9c6c-b0b528d4a8e0/fd13a8df-1465-4fbc-a612-ca7311c31ff2" \
  -H "X-API-Key: YOUR_API_KEY"
[/Code]

### พารามิเตอร์การตอบสนอง

พารามิเตอร์ | ประเภท | คำอธิบาย
----------- | ------ | -------------
message | object | รายละเอียดข้อความ

### ฟิลด์ของวัตถุ message

พารามิเตอร์ | ประเภท | คำอธิบาย
----------- | ------ | -------------
id | string | ตัวระบุเฉพาะของข้อความ (รูปแบบ UUID)
from_address | string | ที่อยู่ผู้ส่ง
subject | string | หัวข้อข้อความ
content | string | เนื้อหาข้อความข้อความธรรมดา
html | string | เนื้อหา HTML ของข้อความ (อาจว่าง)
received_at | number | เวลาที่ได้รับ (Unix timestamp ในมิลลิวินาที)

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

[Code (json)]
{
  "message": {
    "id": "fd13a8df-1465-4fbc-a612-ca7311c31ff2",
    "from_address": "sender1@example.com",
    "subject": "Test Message 1 - xJOK2h",
    "content": "Test Message 1\n\nThis is test message 1 content.\n\nBest regards,\nSender 1",
    "html": "<div>\n<h1>Test Message 1</h1>\n </div>",
    "received_at": 1745224245084
  }
}
[/Code]

## ลบข้อความ

ลบข้อความที่ระบุ

### คำขอ

[Code (bash)]
DELETE /api/emails/{emailId}/{messageId}
[/Code]

### พารามิเตอร์คำขอ

พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย
----------- | ------ | ---------- | -------------
emailId | string | ใช่ | ID อีเมล (พารามิเตอร์เส้นทาง)
messageId | string | ใช่ | ID ข้อความ (พารามิเตอร์เส้นทาง)

### ตัวอย่างคำขอ

[Code (bash)]
curl -X DELETE "https://chat-tempmail.com/api/emails/76d91ae5-822a-4fdd-8701-9de038ec86d7/20e77445-b0c3-4e8b-aa29-762ea423ac15" \
  -H "X-API-Key: YOUR_API_KEY"
[/Code]

### พารามิเตอร์การตอบสนอง

พารามิเตอร์ | ประเภท | คำอธิบาย
----------- | ------ | -------------
success | boolean | การลบสำเร็จหรือไม่

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

[Code (json)]
{
  "success": true
}
[/Code]

---

## Webhook Push

ตั้งค่า webhook เพื่อรับการแจ้งเตือนการส่งข้อความ

## รับการตั้งค่า Webhook

รับข้อมูลการตั้งค่า webhook ปัจจุบัน

### คำขอ

[Code (bash)]
GET /api/webhook
[/Code]

### ตัวอย่างคำขอ

[Code (bash)]
curl https://chat-tempmail.com/api/webhook \
  -H "X-API-Key: YOUR_API_KEY"
[/Code]

### พารามิเตอร์การตอบสนอง

พารามิเตอร์ | ประเภท | คำอธิบาย
----------- | ------ | -------------
url | string | ที่อยู่ URL webhook (อาจเป็นสตริงว่าง)
enabled | boolean | webhook เปิดใช้งานหรือไม่

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

[Code (json)]
{
  "url": "https://your-server.com/webhook",
  "enabled": true
}
[/Code]

## ตั้งค่า Webhook

ตั้งค่าหรืออัปเดตการตั้งค่า webhook

### คำขอ

[Code (bash)]
POST /api/webhook
[/Code]

### พารามิเตอร์คำขอ

พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย
----------- | ------ | ---------- | -------------
url | string | ใช่ | ที่อยู่ URL webhook (ต้องเป็น URL HTTP/HTTPS ที่ถูกต้อง)
enabled | boolean | ใช่ | เปิดใช้งาน webhook หรือไม่

### ตัวอย่างคำขอ

[Code (bash)]
curl -X POST https://chat-tempmail.com/api/webhook \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-server.com/webhook",
    "enabled": true
  }'
[/Code]

### พารามิเตอร์การตอบสนอง

พารามิเตอร์ | ประเภท | คำอธิบาย
----------- | ------ | -------------
success | boolean | การตั้งค่าสำเร็จหรือไม่

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

[Code (json)]
{
  "success": true
}
[/Code]

## Webhook Events

เมื่อมีข้อความใหม่มาถึง ระบบจะส่งคำขอ POST ไปยัง URL ที่คุณตั้งค่าไว้

### รูปแบบข้อมูลที่ได้รับ

ส่วนหัวคำขอ:
- Content-Type: application/json
- X-Webhook-Event: new_message

### ข้อมูลการส่ง Webhook

พารามิเตอร์ | ประเภท | คำอธิบาย
----------- | ------ | -------------
emailId | string | ID อีเมลที่ได้รับข้อความ (รูปแบบ UUID)
messageId | string | ID ข้อความใหม่ (รูปแบบ UUID)
fromAddress | string | ที่อยู่ผู้ส่ง
subject | string | หัวข้อข้อความ
content | string | เนื้อหาข้อความข้อความธรรมดา
html | string | เนื้อหา HTML ของข้อความ (อาจว่าง)
receivedAt | string | เวลาที่ได้รับข้อความ (รูปแบบ ISO 8601)
toAddress | string | ที่อยู่อีเมลที่ได้รับข้อความ

### ตัวอย่างข้อมูลการส่ง

[Code (json)]
{
  "emailId": "c2c4f894-c672-4d5b-a918-abca95aff1f7",
  "messageId": "fd13a8df-1465-4fbc-a612-ca7311c31ff2",
  "fromAddress": "sender@example.com",
  "subject": "Test Message",
  "content": "Message plain text content",
  "html": "<div>Message HTML content</div>",
  "receivedAt": "2025-01-21T08:30:45.084Z",
  "toAddress": "test@chat-tempmail.com"
}
[/Code]

### ข้อกำหนดการตอบสนอง

เซิร์ฟเวอร์ของคุณควรส่งรหัสสถานะ 2xx เพื่อแสดงการรับที่สำเร็จ หากส่งรหัสสถานะที่ไม่ใช่ 2xx ระบบอาจลองส่งใหม่

การตอบสนองที่แนะนำ:

[Code (json)]
HTTP/1.1 200 OK
Content-Type: application/json

{
  "received": true
}
[/Code]

### หมายเหตุสำคัญ

- ตรวจสอบให้แน่ใจว่า URL webhook ของคุณเข้าถึงได้
- แนะนำให้ตรวจสอบความสมบูรณ์ของข้อมูลการส่งในฝั่งเซิร์ฟเวอร์ของคุณ
- ระบบจะส่งการแจ้งเตือน webhook ทันทีเมื่อข้อความมาถึง
- หากการส่งล้มเหลว ระบบอาจลองใหม่ ดังนั้นตรวจสอบให้แน่ใจว่าอินเทอร์เฟซของคุณเป็น idempotent

---