📧 Read Mail API
API สำหรับตรวจสอบสถานะบัญชี Gmail แบบ real-time รวดเร็ว แม่นยำ
Base URL:
https://read-mail.me
Authentication
ทุก request ต้องแนบ API Key โดยใส่ใน HTTP Header:
X-API-Key: your_api_key_here
หรือแนบใน request body:
{
"api_key": "your_api_key_here",
"emails": [...]
}
รับ API Key ได้ที่ Dashboard → API Keys
Rate Limiting
| แพคเกจ | Limit/วัน | Max/Request |
|---|---|---|
| Free | 100 emails | 1,000 emails |
| Premium | 100,000 emails/วัน | 10,000 emails |
| หมายเหตุ: เพดานต่อ request ขึ้นกับโหมด — Deep สูงสุด 500, Fast สูงสุด 1,000 (เกินจะถูกตัดอัตโนมัติ) | ||
เมื่อเกิน limit จะได้รับ HTTP 429 พร้อม remaining และ reset_at
Error Codes
| HTTP Code | Error | ความหมาย |
|---|---|---|
400 | Missing emails | ไม่ได้ส่ง emails array |
401 | Missing API Key | ไม่ได้แนบ API Key |
401 | Invalid API Key | API Key ไม่ถูกต้อง |
403 | API Key Disabled | API Key ถูกปิดใช้งาน |
403 | Account Suspended | บัญชีถูกระงับ |
429 | Rate Limit Exceeded | เกิน quota รายวัน |
502 | Upstream Error | ระบบตรวจสอบขัดข้อง |
Gmail Check
POST
/api/gmail/check
ตรวจสอบสถานะ Gmail หลายบัญชีพร้อมกัน (สูงสุด 100 emails/request)
Request Headers
| Header | Required | ค่า |
|---|---|---|
Content-Type | required | application/json |
X-API-Key | required | API Key ของคุณ |
Request Body
| Field | Type | Required | รายละเอียด |
|---|---|---|---|
emails | array | required | รายการ email (สูงสุดต่อ request: Deep 500 / Fast 1,000) |
mode | string | optional | โหมดตรวจสอบ: deep (ละเอียด, ค่าเริ่มต้น) หรือ fast (เร็วกว่า) |
Response
{
"success": true,
"results": [
{ "email": "[email protected]", "status": "live" },
{ "email": "[email protected]", "status": "disabled" },
{ "email": "[email protected]", "status": "unregistered" }
],
"total": 2,
"limit": 100,
"used": 2,
"remaining": 98
}
Status Values
| Status | ความหมาย |
|---|---|
| live | บัญชีใช้งานได้ปกติ |
| disabled | บัญชีถูกระงับการใช้งาน |
| unregistered | ยังไม่ได้ลงทะเบียน Gmail |
| not_exists | บัญชีไม่มีอยู่จริง |
| invalid | รูปแบบอีเมลไม่ถูกต้อง |
| unknown | ไม่สามารถระบุสถานะได้ |
| ver | ต้องยืนยันตัวตนผ่านการยืนยันเบอร์โทร (Deep เท่านั้น) |
| failed | ตรวจสอบไม่สำเร็จ ระบบคืนเครดิตอัตโนมัติ |
ตัวอย่างการเรียกใช้
curl -s -X POST https://read-mail.me/api/gmail/check \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"mode":"deep","emails":["[email protected]","[email protected]"]}'
<?php
$ch = curl_init('https://read-mail.me/api/gmail/check');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode([
'emails' => ['[email protected]', '[email protected]']
]),
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'X-API-Key: YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
foreach ($response['results'] as $result) {
echo $result['email'] . ' => ' . $result['status'] . "\n";
}
import requests
response = requests.post(
'https://read-mail.me/api/gmail/check',
headers={
'Content-Type': 'application/json',
'X-API-Key': 'YOUR_API_KEY'
},
json={'emails': ['[email protected]', '[email protected]']}
)
data = response.json()
for result in data['results']:
print(f"{result['email']} => {result['status']}")
const response = await fetch('https://read-mail.me/api/gmail/check', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'YOUR_API_KEY'
},
body: JSON.stringify({
emails: ['[email protected]', '[email protected]']
})
});
const data = await response.json();
data.results.forEach(r => {
console.log(`${r.email} => ${r.status}`);
});
แพคเกจ
| แพคเกจ | ราคา | Limit/วัน |
|---|---|---|
| Free | ฟรี | 100 emails/วัน (สูงสุด 1,000/request) |
| Premium | 9 USDT | 100,000 emails/วัน (สูงสุด 10,000/request) |