مركز توثيق واختبار واجهة برمجة تطبيقات البريد المؤقت

اقرأ التوثيق، اختبر نقاط النهاية وانسخ الشيفرة — كل ذلك في صفحة واحدة.

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

https://v1.boomlify.com

البدء السريع

البريد

💎 Dashboard API (Premium)

الحساب

POST /api/v1/emails/create

إنشاء عنوان بريد إلكتروني مؤقت جديد يدعم الآن المعامل الاختياري custom_username لإنشاء رسائل بريد إلكتروني بعناوين مخصصة.

يتطلب تسجيل الدخولمحدود المعدّل

التوثيق

المعلمات

استعلام

custom_username

اسم مستخدم مخصص اختياري لعنوان البريد الإلكتروني. يمكن أن يحتوي على أحرف وأرقام ونقاط وشرطات وشرطات سفلية. يجب أن يكون بين 3 و 30 حرفاً. إذا تم حذفه، سيتم إنشاء اسم مستخدم عشوائي.

:مثال john.doe

⚠️ ⚠️ يجب أن يكون بين 3 و 30 حرفاً. لا يمكن أن يبدأ/ينتهي بأحرف خاصة. يجب أن يكون فريداً. يُرجع 409 إذا كان مستخدماً بالفعل.

استعلام

time

وقت انتهاء الصلاحية

:مثال permanent

⚠️ يجب أن يكون أحد: 10min, 1hour, 1day, permanent

استعلام

domain

نطاق مخصص اختياري لعنوان البريد الإلكتروني. يجب أن يكون نطاقاً موثقاً في حسابك (استخدم نقطة النهاية custom_domains للتحقق). إذا لم يتم تحديده، سيتم استخدام نطاق عام عشوائي.

:مثال mail.yourdomain.com

⚠️ ⚠️ يجب أن يكون نطاقاً مخصصاً موثقاً أو نطاقاً عاماً. يُرجع 400 إذا لم يكن متاحاً.

استعلام

create_as_dashboard

💎 ميزة مميزة - اضبط على "true" لإنشاء بريد إلكتروني على نمط لوحة التحكم مخزن في قاعدة البيانات مع انتهاء صلاحية ثابت لمدة شهرين بدلاً من بريد API قائم على الوقت. احذف أو اضبط على "false" للرسائل القائمة على الوقت (افتراضي). رسائل لوحة التحكم تكلف 15 رصيداً. سيحصل مستخدمو المستوى المجاني على خطأ 403.

:مثال true

⚠️ ⚠️ يجب أن يكون "true" أو محذوفاً. رسائل لوحة التحكم تتطلب خطة Basic أو أعلى. انتهاء صلاحية ثابت لمدة شهرين (يتم تجاهل معامل الوقت).

أمثلة للأخطاء

400

INVALID_USERNAME

يجب أن يكون اسم المستخدم 3 أحرف على الأقل

فشل التحقق من اسم المستخدم المخصص. يجب أن يكون بين 3 و 30 حرفاً بأحرف صالحة فقط.

409

EMAIL_IN_USE

عنوان البريد الإلكتروني "[email protected]" مستخدم بالفعل

اسم المستخدم المخصص مستخدم بالفعل. اختر اسم مستخدم مختلفاً.

400

DOMAIN_NOT_FOUND

النطاق "custom.domain" غير متاح. يجب أن يكون نطاقاً مخصصاً موثقاً في حسابك أو نطاقاً عاماً.

النطاق المحدد غير موجود أو غير موثق. تحقق منه أولاً في حسابك.

400

DOMAIN_NOT_VERIFIED

النطاق المخصص "custom.domain" غير موثق. الحالة الحالية: قيد الانتظار

النطاق موجود لكنه لم يتم التحقق منه بعد. أكمل التحقق من النطاق أولاً.

429

DAILY_LIMIT_EXCEEDED

تم تجاوز الحد اليومي لرسائل الساعة الواحدة

لقد وصلت إلى حدك اليومي لهذا النوع من البريد الإلكتروني

طلب مثال

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

مقاطع الشيفرة

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

التوثيق

المعلمات

استعلام

include_expired

تضمين الرسائل منتهية الصلاحية

:مثال true

⚠️ يجب أن يكون "true" أو "false"

استعلام

permanent_only

إظهار صناديقك الدائمة المحفوظة فقط. يكلف 2 رصيد لكل طلب.

:مثال true

⚠️ يجب أن يكون "true" أو "false"

استعلام

include_permanent

تضمين صناديقك الدائمة المحفوظة مع الحديثة. يكلف 2 رصيد لكل طلب.

:مثال true

⚠️ يجب أن يكون "true" أو "false"

استعلام

limit

عدد الرسائل الإلكترونية المراد إرجاعها

:مثال 50

⚠️ 100 بريد إلكتروني كحد أقصى

أمثلة للأخطاء

402

INSUFFICIENT_CREDITS

أضف رصيدًا لإدراج الصناديق الدائمة.

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

طلب مثال

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

مقاطع الشيفرة

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

التوثيق

المعلمات

مسارإلزامي

معرف البريد الإلكتروني

:مثال 550e8400-e29b-41d4-a716-446655440000

⚠️ يجب أن يكون UUID صالحاً

أمثلة للأخطاء

404

EMAIL_NOT_FOUND

البريد الإلكتروني المطلوب غير موجود أو منتهي الصلاحية

معرف البريد الإلكتروني غير صالح أو البريد منتهي الصلاحية

طلب مثال

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

مقاطع الشيفرة

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

التوثيق

المعلمات

مسارإلزامي

معرف البريد الإلكتروني

:مثال 550e8400-e29b-41d4-a716-446655440000

⚠️ يجب أن يكون UUID صالحاً

استعلام

limit

عدد الرسائل المراد إرجاعها

:مثال 50

⚠️ 100 رسالة كحد أقصى

استعلام

offset

عدد الرسائل المراد تخطيها

:مثال 0

⚠️ يجب أن يكون عدداً صحيحاً غير سالب

أمثلة للأخطاء

404

EMAIL_NOT_FOUND

البريد الإلكتروني المطلوب غير موجود أو منتهي الصلاحية

معرف البريد الإلكتروني غير صالح أو البريد منتهي الصلاحية

400

INVALID_LIMIT

يجب أن يكون الحد بين 1 و 100

معامل الحد خارج النطاق الصالح

طلب مثال

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

مقاطع الشيفرة

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

التوثيق

المعلمات

مسارإلزامي

معرف البريد الإلكتروني (تنسيق UUID). يمكن أن يكون معرف بريد API قائم على الوقت أو معرف بريد لوحة تحكم تم إنشاؤه باستخدام create_as_dashboard=true

:مثال 550e8400-e29b-41d4-a716-446655440000

⚠️ يجب أن يكون UUID صالحاً

أمثلة للأخطاء

404

EMAIL_NOT_FOUND

البريد الإلكتروني المطلوب غير موجود أو منتهي الصلاحية

البريد الإلكتروني غير موجود أو تم حذفه بالفعل

طلب مثال

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

مقاطع الشيفرة

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

التوثيق

المعلمات

استعلامإلزامي

include_dashboard

يجب تعيينه على "true" للوصول إلى رسائل لوحة التحكم. هذا ينشط الميزة المميزة ويتقاضى 2 رصيد.

:مثال true

⚠️ يجب أن يكون "true" - سيحصل مستخدمو المستوى المجاني على خطأ 403

استعلام

include_expired

تضمين الرسائل منتهية الصلاحية في الاستجابة (رسائل API ورسائل لوحة التحكم)

:مثال false

استعلام

limit

الحد الأقصى لعدد الرسائل الإلكترونية المراد إرجاعها (الحد الأقصى: 100)

:مثال 50

⚠️ يجب أن يكون بين 1 و 100

أمثلة للأخطاء

403

TIER_RESTRICTED

الوصول إلى رسائل لوحة التحكم يتطلب خطة مدفوعة (Basic أو أعلى)

هذه ميزة مميزة. لا يمكن لمستخدمي المستوى المجاني الوصول إلى رسائل لوحة التحكم عبر API.

402

INSUFFICIENT_CREDITS

تحتاج إلى 2 رصيد لإدراج رسائل لوحة التحكم

هذه العملية تكلف 2 رصيد. يرجى إضافة المزيد من الرصيد إلى حسابك.

طلب مثال

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

مقاطع الشيفرة

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

التوثيق

المعلمات

مسارإلزامي

معرف بريد لوحة التحكم (تنسيق UUID) - انسخ هذا من لوحة التحكم الخاصة بك أو من نقطة النهاية list-dashboard-emails

:مثال 550e8400-e29b-41d4-a716-446655440000

⚠️ يجب أن يكون UUID صالحاً من رسائل لوحة التحكم الخاصة بك

استعلامإلزامي

include_dashboard

يجب أن يكون "true" للبحث في رسائل لوحة التحكم. يتقاضى 1 رصيد.

:مثال true

أمثلة للأخطاء

403

TIER_RESTRICTED

ميزة مميزة

الوصول إلى رسائل لوحة التحكم يتطلب خطة مدفوعة

402

INSUFFICIENT_CREDITS

تحتاج إلى 1 رصيد للوصول إلى بريد لوحة التحكم

هذه العملية تكلف 1 رصيد

404

EMAIL_NOT_FOUND

البريد الإلكتروني غير موجود

البريد الإلكتروني المطلوب غير موجود أو منتهي الصلاحية

طلب مثال

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

مقاطع الشيفرة

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

التوثيق

المعلمات

مسارإلزامي

معرف بريد لوحة التحكم - UUID البريد الإلكتروني الذي تريد جلب الرسائل له

:مثال 550e8400-e29b-41d4-a716-446655440000

⚠️ يجب أن يكون UUID صالحاً من رسائل لوحة التحكم الخاصة بك

استعلامإلزامي

include_dashboard

يجب أن يكون "true" للوصول إلى رسائل بريد لوحة التحكم. يتقاضى 1 رصيد.

:مثال true

استعلام

limit

الحد الأقصى لعدد الرسائل المراد إرجاعها لكل صفحة (الحد الأقصى: 100)

:مثال 20

⚠️ يجب أن يكون بين 1 و 100

استعلام

offset

عدد الرسائل المراد تخطيها للتصفح (مثلاً، offset=20 مع limit=20 يحصل على الصفحة 2)

:مثال 0

⚠️ يجب أن يكون عدداً صحيحاً غير سالب

أمثلة للأخطاء

403

TIER_RESTRICTED

ميزة مميزة

الوصول إلى رسائل لوحة التحكم يتطلب خطة مدفوعة

402

INSUFFICIENT_CREDITS

تحتاج إلى 1 رصيد للوصول إلى رسائل بريد لوحة التحكم

هذه العملية تكلف 1 رصيد

404

EMAIL_NOT_FOUND

البريد الإلكتروني غير موجود

البريد الإلكتروني المطلوب غير موجود أو منتهي الصلاحية

طلب مثال

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

مقاطع الشيفرة

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

التوثيق

المعلمات

مسارإلزامي

Mailbox ID - Use a dashboard mailbox ID or a permanent API mailbox ID whose Telegram forwarding status you want to inspect

:مثال 550e8400-e29b-41d4-a716-446655440000

⚠️ Must be an owned dashboard mailbox ID or permanent API mailbox ID

استعلامإلزامي

include_dashboard

Must be set to "true" to access Telegram forwarding mailbox status. Charges 2 credits.

:مثال true

⚠️ Must be "true" - Free tier users will receive a 403 error

أمثلة للأخطاء

403

TIER_RESTRICTED

Dashboard email access requires a paid plan (Basic or higher)

This is a premium feature. Free tier users cannot access dashboard email forwarding via API.

402

INSUFFICIENT_CREDITS

Need 2 credits to access dashboard email Telegram forwarding status

This operation costs 2 credits. Please add more credits to your account.

404

EMAIL_NOT_FOUND

Email not found

The requested mailbox was not found, is unsupported, or has expired

طلب مثال

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

مقاطع الشيفرة

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

التوثيق

المعلمات

مسارإلزامي

Mailbox ID - Use a dashboard mailbox ID or a permanent API mailbox ID whose Telegram forwarding you want to update

:مثال 550e8400-e29b-41d4-a716-446655440000

⚠️ Must be an owned dashboard mailbox ID or permanent API mailbox ID

استعلامإلزامي

include_dashboard

Must be set to "true" to update Telegram mailbox forwarding. Charges 2 credits.

:مثال true

⚠️ Must be "true" - Free tier users will receive a 403 error

نصإلزامي

is_enabled

Boolean body field. Set true to enable forwarding or false to disable forwarding.

:مثال true

⚠️ Must be a boolean value

أمثلة للأخطاء

403

TIER_RESTRICTED

Dashboard email access requires a paid plan (Basic or higher)

This is a premium feature. Free tier users cannot update dashboard email forwarding via API.

402

INSUFFICIENT_CREDITS

Need 2 credits to update dashboard email Telegram forwarding

This operation costs 2 credits. Please add more credits to your account.

400

NO_TELEGRAM_BINDING

No active Telegram binding found. Please bind your Telegram account first.

Forwarding cannot be enabled until the account has an active verified Telegram binding.

403

FORWARDING_LIMIT_EXCEEDED

Forwarding limit exceeded

The user has reached the plan limit for active Telegram forwardings.

404

EMAIL_NOT_FOUND

Email not found

The requested mailbox was not found, is unsupported, or has expired

طلب مثال

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

مقاطع الشيفرة

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

التوثيق

المعلمات

استعلامإلزامي

include_dashboard

Must be set to "true" to bulk enable Telegram mailbox forwarding. Charges 2 credits.

:مثال true

⚠️ Must be "true" - Free tier users will receive a 403 error

نصإلزامي

email_ids

Body field containing a non-empty array of owned mailbox IDs. In the test form, you can enter a single mailbox ID or a JSON array.

:مثال ["550e8400-e29b-41d4-a716-446655440000"]

⚠️ Must resolve to a non-empty array of owned dashboard mailbox IDs or permanent API mailbox IDs. The bulk limit is 150 IDs per request.

أمثلة للأخطاء

403

TIER_RESTRICTED

Dashboard email access requires a paid plan (Basic or higher)

This is a premium feature. Free tier users cannot bulk enable dashboard email forwarding via API.

402

INSUFFICIENT_CREDITS

Need 2 credits to bulk enable dashboard email Telegram forwarding

This operation costs 2 credits total per bulk request.

400

NO_TELEGRAM_BINDING

No active Telegram binding found. Please bind your Telegram account first.

Forwarding cannot be enabled until the account has an active verified Telegram binding.

403

FORWARDING_LIMIT_EXCEEDED

Forwarding limit exceeded

The user has reached the plan limit for active Telegram forwardings.

404

EMAIL_NOT_FOUND

Email not found

No matching forwardable mailboxes were found.

طلب مثال

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

مقاطع الشيفرة

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

التوثيق

المعلمات

استعلام

create_as_dashboard

اضبط على "true" لإنشاء بريد إلكتروني على نمط لوحة التحكم مخزن في قاعدة البيانات مع انتهاء صلاحية ثابت لمدة شهرين. إذا تم حذفه، ينشئ بريد API قائم على الوقت في الذاكرة. كلاهما يدعم custom_username.

:مثال true

⚠️ ⚠️ رسائل لوحة التحكم تكلف 15 رصيداً. انتهاء صلاحية ثابت لمدة شهرين (لا يوجد معامل وقت). سيحصل مستخدمو المستوى المجاني على خطأ 403. احذف هذا المعامل لإنشاء بريد API قائم على الوقت مع خيارات وقت مخصصة.

استعلام

custom_username

:مثال john.doe

⚠️ ⚠️ يجب أن يكون بين 3 و 30 حرفاً. لا يمكن أن يبدأ/ينتهي بأحرف خاصة. يجب أن يكون فريداً عبر جميع رسائلك الإلكترونية. إذا كان مستخدماً بالفعل، يُرجع 409 Conflict.

استعلام

domain

اسم نطاق مخصص اختياري لعنوان البريد الإلكتروني. إذا لم يتم تحديده، سيتم استخدام نطاق عام عشوائي.

:مثال mail.yourdomain.com

⚠️ يجب أن يكون نطاقاً موثقاً في حسابك

أمثلة للأخطاء

403

TIER_RESTRICTED

ميزة مميزة

إنشاء رسائل لوحة التحكم يتطلب خطة مدفوعة

402

INSUFFICIENT_CREDITS

تحتاج إلى 15 رصيداً لإنشاء بريد لوحة التحكم

هذه العملية تكلف 15 رصيداً

400

INVALID_USERNAME

يجب أن يكون اسم المستخدم 3 أحرف على الأقل

فشل التحقق من اسم المستخدم المخصص. يجب أن يكون بين 3 و 30 حرفاً بأحرف صالحة فقط.

409

EMAIL_IN_USE

عنوان البريد الإلكتروني "[email protected]" مستخدم بالفعل

اسم المستخدم المخصص مستخدم بالفعل. اختر اسم مستخدم مختلفاً.

400

INVALID_TIME_PARAMETER

معامل وقت غير صالح

يجب أن يكون الوقت أحد: 10min, 1hour, 1day, permanent

طلب مثال

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

مقاطع الشيفرة

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

التوثيق

أمثلة للأخطاء

401

UNAUTHORIZED

مفتاح API غير صالح أو مفقود

مفتاح API مطلوب ويجب أن يكون صالحاً

طلب مثال

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

مقاطع الشيفرة

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

التوثيق

أمثلة للأخطاء

401

UNAUTHORIZED

مفتاح API غير صالح أو مفقود

مفتاح API مطلوب ويجب أن يكون صالحاً

طلب مثال

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

مقاطع الشيفرة

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

التوثيق

أمثلة للأخطاء

401

UNAUTHORIZED

مفتاح API غير صالح أو مفقود

مفتاح API مطلوب ويجب أن يكون صالحاً

طلب مثال

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

مقاطع الشيفرة

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

منشئ الطلبات

POST

المسار

https://v1.boomlify.com/api/v1/emails/create

رمز الواجهة البرمجية

تذكر الرمزاحتفظ بالمفتاح فقط على الأجهزة الموثوقة

المعلمات

custom_username

time

وقت انتهاء الصلاحية

⚠️ يجب أن يكون أحد: 10min, 1hour, 1day, permanent

domain

⚠️ ⚠️ يجب أن يكون نطاقاً مخصصاً موثقاً أو نطاقاً عاماً. يُرجع 400 إذا لم يكن متاحاً.

create_as_dashboard

نص الطلب

الحد: 60 RPMمركز الواجهة البرمجية

اختبار الواجهة البرمجية

مركز توثيق واختبار واجهة برمجة تطبيقات البريد المؤقت

اقرأ التوثيق، اختبر نقاط النهاية وانسخ الشيفرة — كل ذلك في صفحة واحدة.

POST /api/v1/emails/create

التوثيق

المعلمات

أمثلة للأخطاء

طلب مثال

مقاطع الشيفرة

دردشة المجتمع

Temp Mail - Free Temporary Email Generator with Custom Domain Support