واجهة 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" } }

سرد الرسائل

قراءة رسالة

حذف صندوق

الأخطاء

الحدود ومدّة البقاء

صناديق المجموعة العامّة تعيش ساعة واحدة؛ أمّا المُنشأة عبر الواجهة فتتبع ttl_seconds الخاصّ بها، حتى ثلاثين يوماً. وبعد انقضاء المدّة يُحذف الصندوق ورسائله — ولا أرشيف يُسترجَع منه شيء لاحقاً.

تُرفَض الرسائل التي تتجاوز عشرة ميغابايت عند الاستقبال. وتُرفَض العناوين على نطاق مجهول أثناء جلسة SMTP نفسها، دون توليد رسالة ارتداد.

لا تستطيع هذه الصناديق إرسال البريد، وهذا مقصود: رسالة مُرسَلة من نطاق مؤقّت لن تصل إلى أيّ مكان.