SMSBulk
العودة إلى الوثائق
REST API · البريد الإلكتروني

واجهة برمجة التحقق بالبريد الإلكتروني

اشترِ عناوين بريد إلكتروني مؤقتة للتحقق برمز OTP عبر واجهة REST نظيفة. نفس تنسيق JSON ونفس مفتاح API المستخدم في نقاط نهاية الرسائل القصيرة، ضمن /v1/email-activations.

الرابط الأساسي

https://smsbulk.net/api/v1/email-activations

مفتاح API واحد يعمل لكل من الرسائل القصيرة والبريد الإلكتروني. إذا كنت قد دمجت واجهة الرسائل القصيرة بالفعل، فإن البريد الإلكتروني يبعد عنك دقائق.

المصادقة

أرسل مفتاح API مع كل طلب. تُقبل طريقتان قابلتان للتبادل:

# 1. Header (recommended)
curl https://smsbulk.net/api/v1/email-activations \
  -H "x-api-key: YOUR_KEY"

# 2. Bearer token
curl https://smsbulk.net/api/v1/email-activations \
  -H "Authorization: Bearer YOUR_KEY"

أرسل المفتاح عبر الترويسة (x-api-key) أو رمز Bearer. لا يُنصح بتمريره كمعامل استعلام في الرابط لأسباب أمنية، لأن سلاسل الاستعلام تُسجَّل عادةً في سجلات الخادم والوكيل.

مفتاح API الخاص بالرسائل القصيرة هو نفسه المستخدم هنا. لا يوجد مفتاح منفصل للبريد الإلكتروني.

نقاط النهاية

ست مسارات ضمن /api/v1/email-activations. الأسعار موجهة للمستخدم؛ لا تُعاد تكلفة الجملة أبدًا.

GET/api/v1/email-activations/domains?site=telegram.com

يسرد نطاقات مزودي البريد الإلكتروني المتاحة لموقع مستهدف، مع سعر المستخدم والمخزون.

الطلب
curl "https://smsbulk.net/api/v1/email-activations/domains?site=telegram.com" \
  -H "x-api-key: YOUR_KEY"
الاستجابة
[
  { "name": "gmx.com", "price": 0.04, "count": 12, "currency": "USD" }
]
POST/api/v1/email-activations

يحجز عنوان بريد إلكتروني لزوج موقع/نطاق. يخصم من محفظتك فورًا ويعيد التفعيل بحالة WAITING.

الطلب
curl -X POST https://smsbulk.net/api/v1/email-activations \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "site": "telegram.com", "domain": "gmx.com" }'
الاستجابة
{
  "id": "cmox8h7pmicm3mkczzwhdz0yd",
  "site": "telegram.com",
  "domain": "gmx.com",
  "emailAddress": null,
  "status": "WAITING",
  "otpValue": null,
  "userCost": "0.04",
  "currency": "USD",
  "expiresAt": "2026-06-03T14:05:00Z",
  "receivedAt": null,
  "createdAt": "2026-06-03T13:45:00Z"
}
GET/api/v1/email-activations?limit=50

يعيد أحدث تفعيلات البريد الإلكتروني، الأحدث أولًا. الافتراضي 50، الحد الأقصى 100، بدون ترقيم بالمؤشر.

الطلب
curl "https://smsbulk.net/api/v1/email-activations?limit=50" \
  -H "x-api-key: YOUR_KEY"
الاستجابة
[
  {
    "id": "cmox8h7pmicm3mkczzwhdz0yd",
    "site": "telegram.com",
    "domain": "gmx.com",
    "emailAddress": "[email protected]",
    "status": "RECEIVED",
    "otpValue": "595348",
    "userCost": "0.04",
    "currency": "USD",
    "expiresAt": "2026-06-03T14:05:00Z",
    "receivedAt": "2026-06-03T13:47:12Z",
    "createdAt": "2026-06-03T13:45:00Z"
  }
]
GET/api/v1/email-activations/:id

يجلب تفعيلًا واحدًا. يتضمن رمز OTP المُحلَّل ونص البريد الإلكتروني الخام بصيغة HTML بمجرد استلامه.

الطلب
curl https://smsbulk.net/api/v1/email-activations/cmox8h7pmicm3mkczzwhdz0yd \
  -H "x-api-key: YOUR_KEY"
الاستجابة
{
  "id": "cmox8h7pmicm3mkczzwhdz0yd",
  "site": "telegram.com",
  "domain": "gmx.com",
  "emailAddress": "[email protected]",
  "status": "RECEIVED",
  "otpValue": "595348",
  "htmlMessage": "<html>Your code is 595348</html>",
  "userCost": "0.04",
  "currency": "USD",
  "expiresAt": "2026-06-03T14:05:00Z",
  "receivedAt": "2026-06-03T13:47:12Z",
  "createdAt": "2026-06-03T13:45:00Z"
}
POST/api/v1/email-activations/:id/reorder

يعيد فتح العنوان نفسه لرمز OTP آخر. يخصم من المحفظة مرة أخرى (مكافئ إعادة إرسال الرسائل القصيرة للبريد الإلكتروني).

الطلب
curl -X POST https://smsbulk.net/api/v1/email-activations/cmox8h7pmicm3mkczzwhdz0yd/reorder \
  -H "x-api-key: YOUR_KEY"
الاستجابة
{
  "id": "cmox8h7pmicm3mkczzwhdz0yd",
  "site": "telegram.com",
  "domain": "gmx.com",
  "emailAddress": null,
  "status": "WAITING",
  "otpValue": null,
  "userCost": "0.04",
  "currency": "USD",
  "expiresAt": "2026-06-03T14:20:00Z",
  "receivedAt": null,
  "createdAt": "2026-06-03T13:45:00Z"
}
DELETE/api/v1/email-activations/:id

يلغي التفعيل. يعيد المبلغ إلى محفظتك إذا لم يتم استلام رمز OTP.

الطلب
curl -X DELETE https://smsbulk.net/api/v1/email-activations/cmox8h7pmicm3mkczzwhdz0yd \
  -H "x-api-key: YOUR_KEY"
الاستجابة
{
  "id": "cmox8h7pmicm3mkczzwhdz0yd",
  "site": "telegram.com",
  "domain": "gmx.com",
  "emailAddress": null,
  "status": "REFUNDED",
  "otpValue": null,
  "userCost": "0.04",
  "currency": "USD",
  "expiresAt": "2026-06-03T14:05:00Z",
  "receivedAt": null,
  "createdAt": "2026-06-03T13:45:00Z"
}

ملاحظات وحدود

  • الحصة اليومية مشتركة بين الرسائل القصيرة والبريد الإلكتروني: 10٬000 طلب لكل مفتاح API في اليوم بتوقيت UTC.
  • تعيد نقطة نهاية القائمة 100 صف كحد أقصى (الافتراضي 50) ولا تحتوي على ترقيم بالمؤشر بحكم التصميم.
  • تُطبَّق خصومات الولاء تلقائيًا على السعر المخصوم. يعكس userCost ما تدفعه فعليًا.

ابدأ التحقق بالبريد الإلكتروني

احصل على مفتاح API الخاص بك وأرسل طلبك الأول بأمر curl واحد.

احصل على مفتاح APIافتح Swaggerالعودة إلى الوثائق