API של אימייל

ספריות

כרגע עדיין לא שחררנו עטיפות API, אבל אנחנו מתכננים לעשות זאת בעתיד הקרוב. שלח דואר אלקטרוני ל api@forwardemail.net אם ברצונך לקבל הודעה כאשר שוחרר מעטפת ה-API של שפת תכנות מסוימת. בינתיים, אתה יכול להשתמש בספריות בקשות HTTP המומלצות ביישום שלך, או פשוט להשתמש סִלְסוּל כמו בדוגמאות שלהלן.

שפה	סִפְרִיָה
אוֹדֶם	פאראדיי
פִּיתוֹן	בקשות
Java	OkHttp
PHP	לִזלוֹל
JavaScript	סוכן על (אנחנו מתחזקים)
Node.js	סוכן על (אנחנו מתחזקים)
ללכת	net/http
.NET	RestSharp

URIs בסיסי

נתיב ה-URI הבסיסי של HTTP הוא: https://api.forwardemail.net.

אימות

כל נקודות הקצה דורשות שלך מפתח API להיות מוגדר כערך "שם משתמש" של הבקשה אישור בסיסי כּוֹתֶרֶת. אל תדאג - דוגמאות מסופקות להלן עבורך אם אינך בטוח מה זה.

שגיאות

אם מתרחשות שגיאות כלשהן, גוף התגובה של בקשת ה-API יכיל הודעת שגיאה מפורטת.

קוד	שֵׁם
200	OK
400	בקשה גרועה
401	לא מורשה
403	אסור
404	לא נמצא
429	יותר מדי בקשות
500	שגיאת שרת פנימית
501	לא מיושם
502	שער גרוע
503	שירותים לא זמינים
504	פסק זמן של שער

עֵצָה: אם אתה מקבל קוד סטטוס 5xx (מה שלא אמור לקרות), אנא צור איתנו קשר בכתובת api@forwardemail.net ואנו נעזור לך לפתור את הבעיה שלך באופן מיידי.

לוקליזציה

השירות שלנו מתורגם ליותר מ-25 שפות שונות. כל הודעות התגובה של ה-API מתורגמות למקום האחרון שזוהה של המשתמש שמבצע את בקשת ה-API. אתה יכול לעקוף זאת על ידי העברת מנהג Accept-Language כּוֹתֶרֶת. אל תהסס לנסות זאת באמצעות התפריט הנפתח של השפה בתחתית עמוד זה.

דִפּוּף

אם ברצונך לקבל הודעה כאשר העימוד זמין, אנא שלח דוא"ל api@forwardemail.net.

יומנים

אחזר יומנים

ה-API שלנו מאפשר לך באופן פרוגרמטי להוריד יומנים לחשבון שלך. שליחת בקשה לנקודת קצה זו תעבד את כל היומנים עבור חשבונך ותשלח אותם אליך בדוא"ל כקובץ מצורף (Gzip דָחוּס CSV קובץ הגיליון האלקטרוני) לאחר השלמתו.

זה מאפשר לך ליצור עבודות רקע עם א עבודת קרון או באמצעות שלנו תוכנת תזמון העבודה Node.js Bree לקבל יומנים בכל עת שתרצה. שימו לב שנקודת קצה זו מוגבלת ל 10 בקשות ליום.

הקובץ המצורף הוא צורת האותיות הקטנות של email-deliverability-logs-YYYY-MM-DD-h-mm-A-z.csv.gz והמייל עצמו מכיל סיכום קצר של היומנים שאוחזרו. אתה יכול גם להוריד יומנים בכל עת מ החשבון שלי ← יומנים

GET /v1/logs/download

פרמטרים של מחרוזת שאילתה	נדרש	סוּג	תיאור
`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 job שלך.

דוגמה לעבודת Cron (בחצות כל יום ועם יומנים ליום הקודם):

עבור 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

עבור לינוקס ואובונטו:

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`	לא	מחרוזת (כתובת אתר)	קישור לתמונת אווטאר

בקשה לדוגמה:

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

פרמטרים של מחרוזת שאילתה	נדרש	סוּג	תיאור
`q`	לא	מחרוזת (תמיכת RegExp)	חפש אימיילים לפי מטא נתונים
`domain`	לא	מחרוזת (תמיכת RegExp)	חפש אימיילים לפי שם דומיין
`page`	לא	מספר	דף להחזרת התוצאות (ברירת המחדל היא `1`)
`גבול	לא	מספר	מספר התוצאות בכל דף להחזר (ברירת המחדל היא `50` - המקסימום הוא `50` והמינימום הוא `10`)

בקשה לדוגמה:

curl https://api.forwardemail.net/v1/emails \
  -u API_TOKEN:

צור אימייל

ה-API שלנו ליצירת אימייל נוצר בהשראת וממנף את תצורת אפשרות ההודעות של 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`	לא	חוּט	ערך Message-ID אופציונלי עבור הכותרת "Message-ID" (ערך ברירת מחדל ייווצר אוטומטית אם לא מוגדר - שימו לב שהערך צריך היצמד למפרט 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

פרמטרים של מחרוזת שאילתה	נדרש	סוּג	תיאור
`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` הוא ישתמש בכתובת הדוא"ל של משתמש ה-API כנמען, ואם `false` לא ייווצר תכלס). אם מחרוזת עוברת, זוהי רשימה מופרדת של כתובות דוא"ל לשימוש כנמענים (מופרדות על ידי מעבר שורה, רווח ו/או פסיק)
`has_adult_content_protection`	לא	בוליאנית	האם להפעיל הגנה על תוכן למבוגרים בדומיין זה
`has_phishing_protection`	לא	בוליאנית	האם להפעיל הגנת דיוג של סורק דואר זבל בדומיין זה
`has_executable_protection`	לא	בוליאנית	האם להפעיל הגנת הפעלה של סורק דואר זבל בדומיין זה
`has_virus_protection`	לא	בוליאנית	האם להפעיל הגנה מפני וירוסים של סורק דואר זבל בדומיין זה
`has_recipient_verification`	לא	בוליאנית	ברירת המחדל של הדומיין הגלובלי אם לדרוש ממקבלי הכינוי ללחוץ על קישור לאימות דוא"ל כדי שהודעות הדוא"ל יזרום
`retention_days`	לא	מספר	מספר שלם בין `0` ו `30` שמתאים למספר ימי השמירה לאחסון הודעות דוא"ל SMTP יוצאות לאחר מסירה מוצלחת או שגיאה קבועה. ברירת מחדל ל `0`, מה שאומר שהודעות דוא"ל SMTP יוצאות נמחקות ומבוטלות מיד למען אבטחתך.

בקשה לדוגמה:

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`	לא	בוליאנית	האם להפעיל הגנת הפעלה של סורק דואר זבל בדומיין זה
`has_virus_protection`	לא	בוליאנית	האם להפעיל הגנה מפני וירוסים של סורק דואר זבל בדומיין זה
`has_recipient_verification`	לא	בוליאנית	ברירת המחדל של הדומיין הגלובלי אם לדרוש ממקבלי הכינוי ללחוץ על קישור לאימות דוא"ל כדי שהודעות הדוא"ל יזרום
`retention_days`	לא	מספר	מספר שלם בין `0` ו `30` שמתאים למספר ימי השמירה לאחסון הודעות דוא"ל SMTP יוצאות לאחר מסירה מוצלחת או שגיאה קבועה. ברירת מחדל ל `0`, מה שאומר שהודעות דוא"ל SMTP יוצאות נמחקות ומבוטלות מיד למען אבטחתך.

בקשה לדוגמה:

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

פרמטרים של מחרוזת שאילתה	נדרש	סוּג	תיאור
`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 של webhook - ואם לא מסופקים או ריק מערך, ואז האימייל של המשתמש שמבצע את בקשת ה-API יוגדר כנמען)
`description`	לא	חוּט	תיאור כינוי
`labels`	לא	מחרוזת או מערך	רשימת תוויות (חייב להיות מחרוזת או מערך מופרדים במעבר שורה/רווח/פסיק)
`has_recipient_verification`	לא	בוליאנית	דרישה מהנמענים ללחוץ על קישור לאימות דוא"ל כדי שהודעות הדוא"ל יזרמו (ברירת מחדל היא הגדרת הדומיין אם לא מוגדרת במפורש בגוף הבקשה)
`is_enabled`	לא	בוליאנית	האם להפעיל או להשבית את הכינוי הזה (אם מושבת, הודעות דוא"ל לא ינותבו לשום מקום אלא יחזירו קודי סטטוס מוצלחים). אם ערך מועבר, הוא מומר לערך בוליאני באמצעות בוליאני)
`has_imap`	לא	בוליאנית	האם להפעיל או להשבית אחסון IMAP עבור הכינוי הזה (אם מושבת, אזי אימיילים נכנסים שהתקבלו לא יאוחסנו ב אחסון IMAP. אם ערך מועבר, הוא מומר לערך בוליאני באמצעות בוליאני)
`has_pgp`	לא	בוליאנית	האם להפעיל או להשבית הצפנת OpenPGP ל אחסון דוא"ל מוצפן IMAP/POP3 באמצעות הכינוי `public_key`.
`public_key`	לא	חוּט	מפתח ציבורי OpenPGP בפורמט ASCII Armor (לחץ כאן לצפייה בדוגמה; לְמָשָׁל מפתח GPG עבור `support@forwardemail.net`). זה חל רק אם יש לך `has_pgp` מכוון ל `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 של webhook)
`description`	לא	חוּט	תיאור כינוי
`labels`	לא	מחרוזת או מערך	רשימת תוויות (חייב להיות מחרוזת או מערך מופרדים במעבר שורה/רווח/פסיק)
`has_recipient_verification`	לא	בוליאנית	דרישה מהנמענים ללחוץ על קישור לאימות דוא"ל כדי שהודעות הדוא"ל יזרמו (ברירת מחדל היא הגדרת הדומיין אם לא מוגדרת במפורש בגוף הבקשה)
`is_enabled`	לא	בוליאנית	האם להפעיל או להשבית את הכינוי הזה (אם מושבת, הודעות דוא"ל לא ינותבו לשום מקום אלא יחזירו קודי סטטוס מוצלחים)
`has_imap`	לא	בוליאנית	האם להפעיל או להשבית אחסון IMAP עבור הכינוי הזה (אם מושבת, אזי אימיילים נכנסים שהתקבלו לא יאוחסנו ב אחסון IMAP. אם ערך מועבר, הוא מומר לערך בוליאני באמצעות בוליאני)
`has_pgp`	לא	בוליאנית	האם להפעיל או להשבית הצפנת OpenPGP ל אחסון דוא"ל מוצפן IMAP/POP3 באמצעות הכינוי `public_key`.
`public_key`	לא	חוּט	מפתח ציבורי OpenPGP בפורמט ASCII Armor (לחץ כאן לצפייה בדוגמה; לְמָשָׁל מפתח GPG עבור `support@forwardemail.net`). זה חל רק אם יש לך `has_pgp` מכוון ל `true`. למידע נוסף על הצפנה מקצה לקצה בשאלות הנפוצות שלנו.

בקשה לדוגמה:

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: