- صفحة البحث
- جدول المحتويات
واجهة برمجة تطبيقات البريد الإلكتروني
مكتبات
في الوقت الحالي لم نصدر أي أغلفة لواجهة برمجة التطبيقات ، لكننا نخطط للقيام بذلك في المستقبل القريب. إرسال بريد إلكتروني إلى api@forwardemail.net إذا كنت ترغب في أن يتم إعلامك عندما يتم تحرير غلاف API الخاص بلغة برمجة معينة. في غضون ذلك ، يمكنك استخدام مكتبات طلبات HTTP الموصى بها في تطبيقك ، أو ببساطة استخدام لفة كما في الأمثلة أدناه.
لغة | مكتبة |
---|---|
روبي | فاراداي |
بيثون | الطلبات |
جافا | حسنًا |
PHP | أسرف في الشراب |
جافا سكريبت | وكيل فائق (نحن مشرفون) |
Node.js | وكيل فائق (نحن مشرفون) |
اذهب | صافي / http |
.NET | ريست شارب |
URI الأساسي
مسار URI الأساسي HTTP الحالي هو: https://api.forwardemail.net
.
المصادقة
تتطلب جميع نقاط النهاية الخاصة بك مفتاح API ليتم تعيينها كقيمة "اسم المستخدم" للطلب التفويض الأساسي رأس. لا تقلق - يتم توفير أمثلة أدناه لك إذا لم تكن متأكدًا من ماهية ذلك.
أخطاء
في حالة حدوث أي أخطاء ، سيتضمن نص الاستجابة لطلب واجهة برمجة التطبيقات رسالة خطأ مفصلة.
الشفرة | اسم |
---|---|
200 | OK |
400 | اقتراح غير جيد |
401 | غير مصرح |
403 | ممنوع |
404 | غير معثور عليه |
429 | طلبات كثيرة جدا |
500 | خطأ في الخادم الداخلي |
501 | لم تنفذ |
502 | مدخل خاطأ |
503 | الخدمة غير متوفرة |
504 | غمازة |
الموقع
تتم ترجمة خدمتنا إلى أكثر من 25 لغة مختلفة. تتم ترجمة جميع رسائل استجابة API إلى آخر لغة تم اكتشافها للمستخدم الذي يقوم بطلب واجهة برمجة التطبيقات. يمكنك تجاوز هذا بتمرير العرف Accept-Language
رأس. لا تتردد في تجربته باستخدام قائمة اللغة المنسدلة في أسفل هذه الصفحة.
ترقيم الصفحات
إذا كنت ترغب في أن يتم إعلامك عندما يكون ترقيم الصفحات متاحًا ، فيرجى إرسال بريد إلكتروني api@forwardemail.net.
السجلات
استرداد السجلات
تسمح لك واجهة برمجة التطبيقات (API) الخاصة بنا برمجيًا بتنزيل السجلات الخاصة بحسابك. سيؤدي إرسال طلب إلى نقطة النهاية هذه إلى معالجة جميع السجلات الخاصة بحسابك وإرسالها إليك بالبريد الإلكتروني كمرفق (غزيب مضغوط CSV ملف جدول البيانات) بمجرد اكتماله.
يتيح لك هذا إنشاء وظائف خلفية باستخدام ملف وظيفة كرون أو باستخدام لدينا برنامج جدولة المهام Node.js Bree لتلقي السجلات وقتما تشاء. لاحظ أن نقطة النهاية هذه تقتصر على 10
طلبات يوميا.
المرفق هو شكل صغير من email-deliverability-logs-YYYY-MM-DD-h-mm-A-z.csv.gz
ويحتوي البريد الإلكتروني نفسه على ملخص موجز للسجلات التي تم استردادها. يمكنك أيضًا تنزيل السجلات في أي وقت من حسابي ← السجلات
GET /v1/logs/download
معلمة Querystring | مطلوب | نوع | وصف |
---|---|---|---|
domain | لا | سلسلة (FQDN) | تصفية السجلات حسب المجال المؤهل بالكامل ("FQDN"). إذا لم تقم بتوفير ذلك، فسيتم استرداد جميع السجلات عبر جميع النطاقات. |
q | لا | خيط | ابحث عن السجلات حسب البريد الإلكتروني أو المجال أو الاسم المستعار أو عنوان IP أو التاريخ (M/Y , M/D/YY , M-D , M-D-YY ، أو M.D.YY شكل). |
طلب مثال:
curl https://api.forwardemail.net/v1/logs/download \
-u API_TOKEN:
مثال على وظيفة Cron (في منتصف الليل كل يوم):
0 0 * * * /usr/bin/curl https://api.forwardemail.net/v1/logs/download -u API_TOKEN: &>/dev/null
لاحظ أنه يمكنك استخدام خدمات مثل Crontab.guru للتحقق من صحة بناء جملة تعبير وظيفة cron الخاص بك.
مثال على وظيفة كرون (في منتصف الليل كل يوم ومع سجلات اليوم السابق):
For MacOS:
0 0 * * * /usr/bin/curl https://api.forwardemail.net/v1/logs/download?q=`date -v-1d -u "+%-m/%-d/%y"` -u API_TOKEN: &>/dev/null
For Linux and Ubuntu:
0 0 * * * /usr/bin/curl https://api.forwardemail.net/v1/logs/download?q=`date --date "-1 days" -u "+%-m/%-d/%y"` -u API_TOKEN: &>/dev/null
الحساب
إنشاء حساب
POST /v1/account
معلمة الجسم | مطلوب | نوع | وصف |
---|---|---|---|
email | نعم | سلسلة (البريد الإلكتروني) | عنوان بريد الكتروني |
password | نعم | خيط | كلمه السر |
طلب مثال:
curl -X POST https://api.forwardemail.net/v1/account \
-u API_TOKEN: \
-d "email=user%40gmail.com"
استرجاع الحساب
GET /v1/account
طلب مثال:
curl https://api.forwardemail.net/v1/account \
-u API_TOKEN:
تحديث الحساب
PUT /v1/account
معلمة الجسم | مطلوب | نوع | وصف |
---|---|---|---|
email | لا | سلسلة (البريد الإلكتروني) | عنوان بريد الكتروني |
given_name | لا | خيط | الاسم الاول |
family_name | لا | خيط | الكنية |
avatar_url | لا | سلسلة (URL) | رابط للصورة الرمزية |
طلب مثال:
curl -X PUT https://api.forwardemail.net/v1/account \
-u API_TOKEN: \
-d "email=user%40gmail.com"
رسائل البريد الإلكتروني
يرجى التأكد من اتباعك لإرشادات الإعداد الخاصة بنطاقك. يمكن العثور على هذه التعليمات في حسابي → المجالات → الإعدادات → تكوين SMTP الصادر. تحتاج إلى التأكد من إعداد DKIM و Return-Path و DMARC لإرسال SMTP للبريد الصادر مع نطاقك.
سرد رسائل البريد الإلكتروني
لاحظ أن نقطة النهاية هذه لا تُرجع بريدًا إلكترونيًا تم إنشاؤه بالفعل message
, headers
, accepted
، ولا rejectedErrors
ملكيات.
لإرجاع تلك الخصائص وقيمها ، يرجى استخدام استرجاع البريد الإلكتروني نقطة نهاية مع معرف البريد الإلكتروني.
ستعود نقطة النهاية هذه على الأكثر 50
النتائج في وقت واحد. إذا كنت تريد الاستعلام عن صفحات متعددة، فقم بالإلحاق ?page=NUMBER
أين NUMBER
هو عدد صحيح، على سبيل المثال. ?page=1
.
GET /v1/emails
معلمة Querystring | مطلوب | نوع | وصف |
---|---|---|---|
q | لا | سلسلة (RegExp مدعومة) | البحث عن رسائل البريد الإلكتروني عن طريق البيانات الوصفية |
domain | لا | سلسلة (RegExp مدعومة) | ابحث عن رسائل البريد الإلكتروني حسب اسم المجال |
page | لا | رقم | الصفحة لإرجاع النتائج (الافتراضي هو 1 ) |
`الحد | لا | رقم | عدد النتائج لكل صفحة لعرضها (الافتراضي هو 50 - الحد الأقصى هو 50 والحد الأدنى هو 10 ) |
طلب مثال:
curl https://api.forwardemail.net/v1/emails \
-u API_TOKEN:
إنشاء بريد إلكتروني
واجهة برمجة التطبيقات الخاصة بنا لإنشاء بريد إلكتروني مستوحاة من تكوين خيار رسالة Nodemailer وتعززه. يرجى الرجوع إلى تكوين رسالة Nodemailer لجميع معلمات الجسم أدناه.
لاحظ أنه باستثناء envelope
و dkim
(نظرًا لأننا قمنا بتعيينها تلقائيًا لك) ، فإننا ندعم جميع خيارات Nodemailer. نقوم تلقائيًا بتعيين disableFileAccess
و disableUrlAccess
خيارات true
لأغراض أمنية.
يجب عليك إما تمرير الخيار الوحيد لـ raw
مع بريدك الإلكتروني الخام الكامل بما في ذلك الرؤوس أو تمرير خيارات معلمات الجسم الفردية أدناه.
POST /v1/emails
معلمة الجسم | مطلوب | نوع | وصف |
---|---|---|---|
from | لا | سلسلة (البريد الإلكتروني) | عنوان البريد الإلكتروني للمرسل (يجب أن يكون موجودًا كاسم مستعار للمجال). |
to | لا | سلسلة أو صفيف | قائمة مفصولة بفواصل أو صفيف من المستلمين للرأس "إلى". |
cc | لا | سلسلة أو صفيف | قائمة مفصولة بفواصل أو صفيف من المستلمين لرأس "نسخة". |
bcc | لا | سلسلة أو صفيف | قائمة مفصولة بفواصل أو صفيف من المستلمين لرأس "نسخة مخفية الوجهة". |
subject | لا | خيط | موضوع البريد الإلكتروني. |
text | لا | سلسلة أو عازلة | نسخة النص العادي للرسالة. |
html | لا | سلسلة أو عازلة | نسخة HTML للرسالة. |
attachments | لا | مجموعة مصفوفة | مصفوفة من كائنات المرفقات (انظر الحقول المشتركة Nodemailer). |
sender | لا | خيط | عنوان البريد الإلكتروني لرأس "المرسل" (راجع حقول Nodemailer الأكثر تقدمًا). |
replyTo | لا | خيط | عنوان البريد الإلكتروني الخاص بالعنوان "الرد على". |
inReplyTo | لا | خيط | معرّف الرسالة الذي ترد عليه الرسالة. |
references | لا | سلسلة أو صفيف | قائمة مفصولة بمسافات أو صفيف من معرفات الرسالة. |
attachDataUrls | لا | منطقي | لو true ثم يتحول data: الصور في محتوى HTML للرسالة إلى المرفقات المضمنة. |
watchHtml | لا | خيط | إصدار HTML خاص بساعة Apple Watch للرسالة (وفقًا لمستندات Nodemailer، أحدث الساعات لا تتطلب ضبط هذا). |
amp | لا | خيط | إصدار HTML خاص بـ AMP4EMAIL للرسالة (راجع مثال Nodemailer). |
icalEvent | لا | هدف | حدث iCalendar لاستخدامه كمحتوى رسالة بديل (انظر أحداث تقويم Nodemailer). |
alternatives | لا | مجموعة مصفوفة | مصفوفة من محتوى الرسالة البديلة (انظر المحتوى البديل لـ Nodemailer). |
encoding | لا | خيط | ترميز النص وسلاسل HTML (الافتراضي هو "utf-8" ، لكنه يدعم "hex" و "base64" قيم الترميز أيضًا). |
raw | لا | سلسلة أو عازلة | رسالة مخصصة تم إنشاؤها بتنسيق RFC822 لاستخدامها (بدلاً من الرسالة التي تم إنشاؤها بواسطة Nodemailer - راجع مصدر مخصص لـ Nodemailer). |
textEncoding | لا | خيط | الترميز الذي يتم إجباره على استخدامه للقيم النصية (إما "quoted-printable" أو "base64" ). القيمة الافتراضية هي أقرب قيمة تم اكتشافها (لاستخدام ASCII "quoted-printable" ). |
priority | لا | خيط | مستوى الأولوية للبريد الإلكتروني (يمكن أن يكون "high" , "normal" (افتراضي) ، أو "low" ). لاحظ أن قيمة "normal" لا يقوم بتعيين رأس الأولوية (هذا هو السلوك الافتراضي). إذا كانت قيمة "high" أو "low" تم تعيينه ، ثم X-Priority , X-MSMail-Priority ، و Importance رؤوس وفقًا لذلك. |
headers | لا | كائن أو صفيف | كائن أو صفيف من حقول رأس إضافية لتعيينها (راجع رؤوس Nodemailer المخصصة). |
messageId | لا | خيط | قيمة معرف رسالة اختيارية لرأس "معرف الرسالة" (سيتم إنشاء قيمة افتراضية تلقائيًا إذا لم يتم تعيينها - لاحظ أن القيمة يجب تلتزم بمواصفات RFC2822). |
date | لا | سلسلة أو تاريخ | قيمة تاريخ اختيارية سيتم استخدامها إذا كان رأس التاريخ مفقودًا بعد التحليل ، وإلا فسيتم استخدام سلسلة UTC الحالية إذا لم يتم تعيينها. لا يمكن أن يكون رأس التاريخ أكثر من 30 يومًا مقدمًا من الوقت الحالي. |
list | لا | هدف | كائن اختياري من List-* رؤوس (انظر رؤوس قائمة Nodemailer). |
طلب مثال:
curl -X POST https://api.forwardemail.net/v1/emails \
-u API_TOKEN: \
-d "from=alias@example.com" \
-d "to=user%40gmail.com" \
-d "subject=test" \
-d "text=test"
طلب مثال:
curl -X POST https://api.forwardemail.net/v1/emails \
-u API_TOKEN: \
-d "raw=`cat file.eml`"
استرجاع البريد الإلكتروني
GET /v1/emails/:id
طلب مثال:
curl https://api.forwardemail.net/v1/emails/:id \
-u API_TOKEN:
حذف البريد الإلكتروني
سيؤدي حذف البريد الإلكتروني إلى تعيين الحالة إلى "rejected"
(وبالتالي لا يتم معالجتها في قائمة الانتظار) إذا وفقط إذا كانت الحالة الحالية واحدة من "pending"
, "queued"
، أو "deferred"
. قد نقوم بمسح رسائل البريد الإلكتروني تلقائيًا بعد 30 يومًا من إنشائها و / أو إرسالها - لذلك يجب عليك الاحتفاظ بنسخة من رسائل البريد الإلكتروني الصادرة من SMTP في عميلك أو قاعدة بياناتك أو تطبيقك. يمكنك الرجوع إلى قيمة معرف البريد الإلكتروني الخاص بنا في قاعدة البيانات الخاصة بك إذا رغبت في ذلك - يتم إرجاع هذه القيمة من كليهما إنشاء بريد إلكتروني و استرجاع البريد الإلكتروني نقاط النهاية.
DELETE /v1/emails/:id
طلب مثال:
curl -X DELETE https://api.forwardemail.net/v1/emails/:id \
-u API_TOKEN:
المجالات
/v1/domains/:domain_name
لأن مسارهم قابل للتبديل بمعرف النطاق :domain_id
. هذا يعني أنه يمكنك الرجوع إلى المجال إما من خلال name
أو id
القيمة.
قائمة المجالات
GET /v1/domains
معلمة Querystring | مطلوب | نوع | وصف |
---|---|---|---|
q | لا | سلسلة (RegExp مدعومة) | ابحث عن المجالات بالاسم |
name | لا | سلسلة (RegExp مدعومة) | ابحث عن المجالات بالاسم |
طلب مثال:
curl https://api.forwardemail.net/v1/domains \
-u API_TOKEN:
إنشاء مجال
POST /v1/domains
معلمة الجسم | مطلوب | نوع | وصف |
---|---|---|---|
domain | نعم | سلسلة (FQDN أو IP) | اسم المجال المؤهل بالكامل ("FQDN") أو عنوان IP |
plan | لا | السلسلة (قابلة للتعداد) | نوع الخطة (يجب أن يكون "free" , "enhanced_protection" ، أو "team" ، الافتراضيات إلى "free" أو الخطة المدفوعة الحالية للمستخدم إذا كانت واحدة) |
catchall | لا | سلسلة (عناوين بريد إلكتروني محددة) أو منطقية | أنشئ اسمًا مستعارًا افتراضيًا شاملاً ، وافتراضيًا إلى true (إذا true سيستخدم عنوان البريد الإلكتروني لمستخدم واجهة برمجة التطبيقات كمستلم ، وإذا كان false لن يتم إنشاء كل شيء). إذا تم تمرير سلسلة ، فهي قائمة محددة من عناوين البريد الإلكتروني لاستخدامها كمستلمين (مفصولة بفاصل أسطر و / أو مسافة و / أو فاصلة) |
has_adult_content_protection | لا | منطقي | ما إذا كان سيتم تمكين حماية محتوى البالغين من الماسح الضوئي للبريد العشوائي في هذا المجال |
has_phishing_protection | لا | منطقي | ما إذا كان سيتم تمكين الحماية من التصيد الاحتيالي لماسح البريد العشوائي في هذا المجال أم لا |
has_executable_protection | لا | منطقي | ما إذا كان سيتم تمكين الحماية القابلة للتنفيذ لـ Spam Scanner في هذا المجال أم لا |
has_virus_protection | لا | منطقي | ما إذا كان سيتم تمكين الحماية من الفيروسات Spam Scanner في هذا المجال |
has_recipient_verification | لا | منطقي | النطاق الافتراضي العام لمطالبة مستلمي الاسم المستعار بالنقر فوق ارتباط التحقق من البريد الإلكتروني لتتدفق رسائل البريد الإلكتروني من خلاله |
طلب مثال:
curl -X POST https://api.forwardemail.net/v1/domains \
-u API_TOKEN: \
-d domain=example.com \
-d plan=free
استرجاع المجال
GET /v1/domains/example.com
طلب مثال:
curl https://api.forwardemail.net/v1/domains/example.com \
-u API_TOKEN:
تحقق من سجلات المجال
GET /v1/domains/example.com/verify-records
طلب مثال:
curl https://api.forwardemail.net/v1/domains/example.com/verify-records \
-u API_TOKEN:
تحديث المجال
PUT /v1/domains/example.com
معلمة الجسم | مطلوب | نوع | وصف |
---|---|---|---|
smtp_port | لا | سلسلة أو رقم | منفذ مخصص للتهيئة لإعادة توجيه SMTP (الافتراضي هو "25" ) |
has_adult_content_protection | لا | منطقي | ما إذا كان سيتم تمكين حماية محتوى البالغين من الماسح الضوئي للبريد العشوائي في هذا المجال |
has_phishing_protection | لا | منطقي | ما إذا كان سيتم تمكين الحماية من التصيد الاحتيالي لماسح البريد العشوائي في هذا المجال أم لا |
has_executable_protection | لا | منطقي | ما إذا كان سيتم تمكين الحماية القابلة للتنفيذ لـ Spam Scanner في هذا المجال أم لا |
has_virus_protection | لا | منطقي | ما إذا كان سيتم تمكين الحماية من الفيروسات Spam Scanner في هذا المجال |
has_recipient_verification | لا | منطقي | النطاق الافتراضي العام لمطالبة مستلمي الاسم المستعار بالنقر فوق ارتباط التحقق من البريد الإلكتروني لتتدفق رسائل البريد الإلكتروني من خلاله |
طلب مثال:
curl -X PUT https://api.forwardemail.net/v1/domains/example.com \
-u API_TOKEN:
حذف المجال
DELETE /v1/domains/:domain_name
طلب مثال:
curl -X DELETE https://api.forwardemail.net/v1/domains/:domain_name \
-u API_TOKEN:
تدعو
قبول دعوة المجال
GET /v1/domains/:domain_name/invites
طلب مثال:
curl https://api.forwardemail.net/v1/domains/:domain_name/invites \
-u API_TOKEN:
إنشاء دعوة المجال
POST /v1/domains/example.com/invites
معلمة الجسم | مطلوب | نوع | وصف |
---|---|---|---|
email | نعم | سلسلة (البريد الإلكتروني) | عنوان البريد الإلكتروني لدعوته إلى قائمة أعضاء المجال |
group | نعم | السلسلة (قابلة للتعداد) | مجموعة لإضافة المستخدم إلى عضوية المجال مع (يمكن أن تكون واحدة من "admin" أو "user" ) |
طلب مثال:
curl -X POST https://api.forwardemail.net/v1/domains/example.com/invites \
-u API_TOKEN: \
-d "email=user%40gmail.com" \
-d group=admin
إزالة دعوة المجال
DELETE /v1/domains/:domain_name/invites
معلمة الجسم | مطلوب | نوع | وصف |
---|---|---|---|
email | نعم | سلسلة (البريد الإلكتروني) | عنوان البريد الإلكتروني لإزالته من قائمة أعضاء المجال |
طلب مثال:
curl -X DELETE https://api.forwardemail.net/v1/domains/:domain_name/invites \
-u API_TOKEN:
أفراد
تحديث عضو المجال
PUT /v1/domains/example.com/members/:member_id
معلمة الجسم | مطلوب | نوع | وصف |
---|---|---|---|
group | نعم | السلسلة (قابلة للتعداد) | مجموعة لتحديث المستخدم إلى عضوية المجال مع (يمكن أن تكون واحدة من "admin" أو "user" ) |
طلب مثال:
curl -X PUT https://api.forwardemail.net/v1/domains/example.com/members/:member_id \
-u API_TOKEN:
إزالة عضو المجال
DELETE /v1/domains/:domain_name/members/:member_id
طلب مثال:
curl -X DELETE https://api.forwardemail.net/v1/domains/:domain_name/members/:member_id \
-u API_TOKEN:
اسماء مستعارة
سرد أسماء النطاقات المستعارة
GET /v1/domains/example.com/aliases
معلمة Querystring | مطلوب | نوع | وصف |
---|---|---|---|
q | لا | سلسلة (RegExp مدعومة) | ابحث عن الأسماء المستعارة في مجال حسب الاسم أو التصنيف أو المستلم |
name | لا | سلسلة (RegExp مدعومة) | البحث عن الأسماء المستعارة في المجال بالاسم |
recipient | لا | سلسلة (RegExp مدعومة) | البحث عن الأسماء المستعارة في المجال عن طريق المستلم |
طلب مثال:
curl https://api.forwardemail.net/v1/domains/example.com/aliases \
-u API_TOKEN:
إنشاء اسم نطاق مستعار جديد
POST /v1/domains/example.com/aliases
معلمة الجسم | مطلوب | نوع | وصف |
---|---|---|---|
name | لا | خيط | اسم مستعار (إذا لم يتم توفيره أو إذا كان فارغًا ، فسيتم إنشاء اسم مستعار عشوائي) |
recipients | لا | سلسلة أو صفيف | قائمة المستلمين (يجب أن تكون سلسلة أو صفيف من عناوين البريد الإلكتروني الصالحة ، وأسماء المجال المؤهلة بالكامل ("FQDN") ، وعناوين IP ، و / أو عنوان URL للخطاف على الويب - إذا لم يتم توفيرها أو كانت فارغة صفيف ، ثم سيتم تعيين البريد الإلكتروني للمستخدم الذي يقوم بإجراء طلب واجهة برمجة التطبيقات كمستلم) |
description | لا | خيط | وصف الاسم المستعار |
labels | لا | سلسلة أو صفيف | قائمة التسميات (يجب أن تكون فاصل السطر / مسافة / سلسلة مفصولة بفواصل أو صفيف) |
has_recipient_verification | لا | منطقي | ما إذا كان سيتم تمكين مطالبة المستلمين بالنقر فوق ارتباط التحقق من البريد الإلكتروني حتى تتدفق رسائل البريد الإلكتروني من خلاله (يتم تعيين الإعدادات الافتراضية على النطاق إذا لم يتم تعيينها صراحة في نص الطلب) |
is_enabled | لا | منطقي | ما إذا كان سيتم تمكين تعطيل هذا الاسم المستعار (إذا تم تعطيله ، فلن يتم توجيه رسائل البريد الإلكتروني إلى أي مكان ولكن يتم إرجاع رموز الحالة الناجحة). افتراضات إلى true ، ولكن إذا تم تمرير قيمة ، يتم تحويلها إلى قيمة منطقية باستخدام منطقي) |
طلب مثال:
curl -X POST https://api.forwardemail.net/v1/domains/example.com/aliases \
-u API_TOKEN:
استرجاع اسم النطاق المستعار
يمكنك استرداد اسم نطاق مستعار إما من خلال id
أو لها name
القيمة.
GET /v1/domains/:domain_name/aliases/:alias_id
طلب مثال:
curl https://api.forwardemail.net/v1/domains/:domain_name/aliases/:alias_id \
-u API_TOKEN:
GET /v1/domains/:domain_name/aliases/:alias_name
طلب مثال:
curl https://api.forwardemail.net/v1/domains/:domain_name/aliases/:alias_name \
-u API_TOKEN:
تحديث اسم النطاق المستعار
PUT /v1/domains/example.com/aliases/:alias_id
معلمة الجسم | مطلوب | نوع | وصف |
---|---|---|---|
name | لا | خيط | اسم مستعار |
recipients | نعم | سلسلة أو صفيف | قائمة المستلمين (يجب أن تكون فاصل السطر / مسافة / سلسلة مفصولة بفواصل أو صفيف من عناوين البريد الإلكتروني الصالحة ، وأسماء النطاقات المؤهلة بالكامل ("FQDN") ، و / أو عناوين IP ، و / أو عناوين URL الخاصة بشبكة الويب) |
description | لا | خيط | وصف الاسم المستعار |
labels | لا | سلسلة أو صفيف | قائمة التسميات (يجب أن تكون فاصل السطر / مسافة / سلسلة مفصولة بفواصل أو صفيف) |
has_recipient_verification | لا | منطقي | ما إذا كان سيتم تمكين مطالبة المستلمين بالنقر فوق ارتباط التحقق من البريد الإلكتروني حتى تتدفق رسائل البريد الإلكتروني من خلاله (يتم تعيين الإعدادات الافتراضية على النطاق إذا لم يتم تعيينها صراحة في نص الطلب) |
is_enabled | لا | منطقي | ما إذا كان سيتم تمكين هذا الاسم المستعار (إذا تم تعطيله ، فلن يتم توجيه رسائل البريد الإلكتروني في أي مكان ولكن سيتم عرض رموز الحالة الناجحة) |
طلب مثال:
curl -X PUT https://api.forwardemail.net/v1/domains/example.com/aliases/:alias_id \
-u API_TOKEN:
حذف اسم النطاق المستعار
DELETE /v1/domains/:domain_name/aliases/:alias_id
طلب مثال:
curl -X DELETE https://api.forwardemail.net/v1/domains/:domain_name/aliases/:alias_id \
-u API_TOKEN: