- דף חיפוש
- תוכן העניינים
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 | פסק זמן של שער |
לוקליזציה
השירות שלנו מתורגם ליותר מ-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: