API ตรวจสอบอีเมลที่ใช้งานได้ทันที

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

ส่งคีย์ API ของคุณเป็น bearer token ในส่วนหัว Authorization ทุกคำขอ เก็บคีย์ไว้บนเซิร์ฟเวอร์ของคุณ ห้ามใส่ไว้ในโค้ดบนเบราว์เซอร์หรือแอปมือถือ

Authorization: Bearer YOUR_API_KEY

URL พื้นฐานสำหรับทุกเอนด์พอยต์คือ https://bouncebell.com/api/v1

ตรวจสอบที่อยู่เดียว

GET https://bouncebell.com/api/v1/verify

ตัวอย่าง

curl "https://bouncebell.com/api/v1/verify?email=rini.elizabeth%40acme-foods.example" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "email": "rini.elizabeth@acme-foods.example",
  "status": "valid",
  "reason": "mailbox_exists",
  "domain": "acme-foods.example",
  "mx_record": "mx1.acme-foods.example",
  "disposable": false,
  "role": false,
  "free_provider": false,
  "catch_all": false,
  "did_you_mean": null,
  "checked_at": "2026-10-30T09:30:12Z",
  "credits_used": 1
}

ฟิลด์ผลลัพธ์

สถานะ

แบตช์

ส่งได้สูงสุด 100,000 ที่อยู่ในคำขอเดียว แบตช์จะทำงานในเบื้องหลัง คุณสามารถสอบถามสถานะเป็นระยะ หรือระบุ callback_url แล้วเราจะเรียก URL นั้นเมื่อแบตช์เสร็จ

สร้างแบตช์

POST https://bouncebell.com/api/v1/batches

curl -X POST "https://bouncebell.com/api/v1/batches" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "October import", "emails": ["a@example.com", "b@example.com"],
       "callback_url": "https://yourapp.example/hooks/bouncebell"}'

{ "id": "bat_8f2k1q3m9x7w4p", "status": "queued", "total": 2, "done": 0 }

ระบบจะกันเครดิตไว้สำหรับทุกที่อยู่ที่ไม่ซ้ำกันเมื่อสร้างแบตช์ และคืนเครดิตสำหรับผลลัพธ์ที่ไม่ทราบสถานะเมื่อแบตช์เสร็จ คอลแบ็กจะได้รับ POST พร้อม {"event": "batch.completed", "batch_id": "...", "status": "done", "counts": {...}} URL ของคอลแบ็กต้องใช้ HTTPS

ตรวจสอบความคืบหน้า

GET https://bouncebell.com/api/v1/batches/{id}

{ "id": "bat_8f2k1q3m9x7w4p", "status": "running", "total": 2, "done": 1 }

สถานะคือ queued, running หรือ done เมื่อสถานะเป็น done การตอบกลับจะมี counts แยกตามสถานะด้วย

ดาวน์โหลดผลลัพธ์

GET https://bouncebell.com/api/v1/batches/{id}/results

ส่งกลับเป็น JSON โดยค่าเริ่มต้น เพิ่ม ?format=csv เพื่อรับไฟล์ CSV แต่ละแถวมีฟิลด์เหมือนกับการตรวจสอบเดี่ยว

เครดิต

GET https://bouncebell.com/api/v1/credits

{ "credits_remaining": 33420 }

ข้อผิดพลาดและขีดจำกัด

ข้อผิดพลาดจะส่งกลับเนื้อหา JSON พร้อมรหัส error และ message ที่อ่านเข้าใจได้

การตรวจสอบเดี่ยวจำกัดที่ 20 คำขอต่อวินาทีต่อคีย์ หากต้องการมากกว่านี้ โปรดติดต่อเรา