API ของ inboxsink

กล่องจดหมายชั่วคราวที่สั่งงานด้วยโค้ดได้ ใช้ทดสอบขั้นตอนสมัครสมาชิกโดยไม่ต้องพึ่งกล่องจดหมายจริง ห้าเส้นทาง ฐานเดียวที่ https://inboxsink.com รับส่งเป็น JSON

เส้นทางที่เปลี่ยนเกมคือ wait ซึ่งจะรอจนกว่าข้อความจะมาถึง หากไม่มีมัน การทดสอบแบบครบวงจรต้องเดาด้วย sleep และจะไม่เสถียรทันทีที่คิวการส่งล่าช้า

ไลบรารี JavaScript

แพ็กเกจที่ไม่มีการพึ่งพาใด ๆ สำหรับ Node 18 ขึ้นไป โค้ดอยู่บน GitHub

npm i inboxsink

import { InboxSink } from 'inboxsink';
const sink = new InboxSink(process.env.INBOXSINK_API_KEY);

const inbox = await sink.createInbox();
const code = await sink.waitForOtp(inbox.id);   // '204815'

waitForOtp จะโยนข้อผิดพลาดแทนการคืนค่า null เมื่อไม่มีรหัสมาถึง เพราะการทดสอบควรล้มเหลวอย่างชัดเจน ไม่ใช่กรอกช่องว่างเงียบ ๆ

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

ใส่ส่วนหัว Authorization ในทุกการเรียก สร้างคีย์ได้จากแดชบอร์ด และคีย์จะขึ้นต้นด้วย ibsk_

curl -H "Authorization: Bearer ibsk_…" \
  https://inboxsink.com/v1/domains

คีย์แบบอ่านได้จะแสดงเฉพาะตอนสร้างเท่านั้น หลังจากนั้นจะเห็นเพียงคำนำหน้า เราเก็บไว้แค่ค่าแฮชของมัน

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

curl -X POST https://inboxsink.com/v1/inboxes \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"ttl_seconds": 900}'

→ 201
{ "id": "42", "address": "9f2c1a@mailhusk.com", "expires_at": "2026-09-01T15:12:00Z" }

รอข้อความ

curl -H "Authorization: Bearer $KEY" \
  "https://inboxsink.com/v1/inboxes/42/wait?timeout=45000"

→ 200
{ "message": { "id": "913", "from": "no-reply@acme.com", "subject": "…",
               "otp": "204815", "link": "https://acme.com/confirm/9f3a" } }

แสดงรายการข้อความ

อ่านข้อความ

ลบกล่องจดหมาย

ข้อผิดพลาด

ข้อจำกัดและอายุการใช้งาน

กล่องจากกลุ่มสาธารณะมีอายุหนึ่งชั่วโมง ส่วนกล่องที่สร้างผ่าน API จะเป็นไปตาม ttl_seconds ของตัวเอง สูงสุดสามสิบวัน เมื่อครบกำหนด กล่องและข้อความจะถูกลบ ไม่มีคลังเก็บให้ดึงกลับมาภายหลัง

ข้อความที่ใหญ่เกินสิบเมกะไบต์จะถูกปฏิเสธตั้งแต่ตอนรับ ที่อยู่บนโดเมนที่ไม่รู้จักจะถูกปฏิเสธระหว่างเซสชัน SMTP โดยไม่สร้างอีเมลตีกลับ

กล่องเหล่านี้ส่งอีเมลไม่ได้ และนี่เป็นความตั้งใจ เพราะข้อความที่ส่งจากโดเมนชั่วคราวจะไปไม่ถึงที่ใดเลย