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

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" }
]

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": "a1b2c3@gmx.com",
  "status": "WAITING",
  "otpValue": null,
  "userCost": "0.04",
  "currency": "USD",
  "expiresAt": "2026-06-03T14:05:00Z",
  "createdAt": "2026-06-03T13:45:00Z"
}

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": "a1b2c3@gmx.com",
    "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",
    "reorderBlockedAt": null
  }
]

curl https://smsbulk.net/api/v1/email-activations/cmox8h7pmicm3mkczzwhdz0yd \
  -H "x-api-key: YOUR_KEY"

{
  "id": "cmox8h7pmicm3mkczzwhdz0yd",
  "site": "telegram.com",
  "domain": "gmx.com",
  "emailAddress": "a1b2c3@gmx.com",
  "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",
  "reorderBlockedAt": null
}

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": "a1b2c3@gmx.com",
  "status": "WAITING",
  "otpValue": null,
  "userCost": "0.04",
  "currency": "USD",
  "expiresAt": "2026-06-03T14:20:00Z",
  "createdAt": "2026-06-03T13:45:00Z",
  "reorderBlockedAt": null
}

إذا حظر مزوّد البريد العنوان، يفشل reorder بالرمز 502 والكود EMAIL_BANNED ويُعاد المبلغ المخصوم. بعد ذلك يحمل التفعيل الحقل reorderBlockedAt (تاريخ بصيغة ISO، وإلا null) في ردود القائمة والتفاصيل وreorder، وكل reorder لاحق يعيد 409 مع الكود EMAIL_BANNED دون خصم. اشترِ عنوانًا جديدًا بدلًا من ذلك.

HTTP 409 Conflict
{
  "statusCode": 409,
  "code": "EMAIL_BANNED",
  "message": "Email address blocked by the provider; reorder is not possible"
}

curl -X DELETE https://smsbulk.net/api/v1/email-activations/cmox8h7pmicm3mkczzwhdz0yd \
  -H "x-api-key: YOUR_KEY"

{
  "ok": true
}

إذا تعثّر reorder على هذا التفعيل، يعيد الإلغاء مبلغ reorder بدلًا من إلغاء التفعيل. الاستجابة 200 وتحمل reorderRefunded: true والكود EMAIL_REORDER_REFUNDED، ويبقى العنوان الأصلي نشطًا.

HTTP 200 OK
{
  "ok": true,
  "reorderRefunded": true,
  "code": "EMAIL_REORDER_REFUNDED",
  "message": "Reorder failed and was refunded. Your original email address is still active."
}

إذا كان reorder لا يزال جاريًا على هذا التفعيل، يعيد الإلغاء 409 مع الكود EMAIL_REORDER_IN_PROGRESS والحقل retryAfterSec (عدد الثواني للانتظار). لا يُلغى شيء ولا يُخصم أي مبلغ؛ أعد المحاولة بعد هذه المدة.

HTTP 409 Conflict
{
  "statusCode": 409,
  "code": "EMAIL_REORDER_IN_PROGRESS",
  "message": "A reorder is in progress. Try again in a moment.",
  "retryAfterSec": 90
}