זקוק למסמכים עם נתונים ומפתחות אמיתיים?

כל שעליך לעשות הוא להירשם או להתחבר כדי לאכלס את מפתחות ה- API שלך ואת נתוני החשבון האמיתיים שלך למטה.

קרא את מדיניות הפרטיות והתנאים שלנו

לא מעוניין? לחץ כאן כדי להמשיך לקרוא

יצרנו ממשק API לגישה פרוגרמטית לדומיינים, כינויים ועוד.

🤖

תיעוד API

גישה תכנתית לנתונים שלך

ממשק API להעברת דוא"ל

תוכן עניינים

ספריות

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

שפה ספריה
רובי פאראדיי
פייתון בקשות
ג'אווה OkHttp
PHP לפטפט
JavaScript סופרגנט
Node.js סופרגנט
ללכת net / http
.נֶטוֹ RestSharp

בסיס URI

נתיב ה- URI של בסיס ה- HTTP הנוכחי הוא:https://api.forwardemail.net. נתיב ה- URI של בסיס HTTP מדור קודם שלhttps://forwardemail.net:4000 יבוטל ב -1 בינואר 2021.

אימות

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

שגיאות

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

קוד שם
200 בסדר
400 בקשה רעה
401 לא מורשה
403 אסור
404 לא נמצא
429 יותר מדי בקשות
500 שגיאת שרת פנימית
501 לא מיושם
502 שער רע
503 שירותים לא זמינים
504 פסק זמן של שער
Tip: If you receive a 5xx status code (which should not happen), then please contact us at api@forwardemail.net and we will help you to resolve your issue immediately.

לוקליזציה

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

עימוד

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

חשבון

צור חשבון

POST /v1/account

פרמטר גוף נדרש סוג תיאור
email כן מחרוזת (אימייל) כתובת דוא"ל
password כן מחרוזת סיסמה

בקשת דוגמה:

curl -X POST https://api.forwardemail.net/v1/account \
  -u API_TOKEN: \
  -d "email=user%40gmail.com"

Example Response:

{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "Password was invalid."
}

אחזר חשבון

GET /v1/account

בקשת דוגמה:

curl -X GET https://api.forwardemail.net/v1/account \
  -u API_TOKEN:

Example Response:

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid 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"

Example Response:

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid API token."
}

דומיינים

Tip: Domain endpoints with a domain's name /v1/domains/:domain_name as their path are interchangeable with a domain's ID :domain_id. This means you can refer to the domain by either its name or id value.

רשימת תחומים

GET /v1/domains

פרמטר מחרוזת קווריסט נדרש סוג תיאור
name לא מחרוזת (RegExp נתמך) חפש דומיינים לפי שם
alias לא מחרוזת (RegExp נתמך) חפש דומיינים לפי שם הכינוי
recipient לא מחרוזת (RegExp נתמך) חפש דומיינים לפי הנמען

בקשת דוגמה:

curl -X GET https://api.forwardemail.net/v1/domains \
  -u API_TOKEN:

Example Response:

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid API token."
}

צור דומיין

POST /v1/domains

פרמטר גוף נדרש סוג תיאור
domain כן מחרוזת (FQDN או IP) שם תחום מוסמך לחלוטין ("FQDN") או כתובת IP
plan לא מחרוזת (אין ספור) סוג תוכנית (חייב להיות"free","enhanced_protection", או"team", ברירת מחדל ל"free")
catchall לא String (delimited email addresses) or Boolean Create a default catch-all alias, defaults to true (if true it will use the API user's email address as a recipient, and if false no catch-all will be created). If a String is passed, then it is a delimited list of email addresses to use as recipients (separated by line break, space, and/or comma)

בקשת דוגמה:

curl -X POST https://api.forwardemail.net/v1/domains \
  -u API_TOKEN: \
  -d domain=example.com \
  -d plan=free

Example Response:

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid API token."
}

אחזר דומיין

GET /v1/domains/example.com

בקשת דוגמה:

curl -X GET https://api.forwardemail.net/v1/domains/example.com \
  -u API_TOKEN:

Example Response:

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid API token."
}

אמת את רשומות הדומיין

GET /v1/domains/example.com/verify-records

בקשת דוגמה:

curl -X GET https://api.forwardemail.net/v1/domains/example.com/verify-records \
  -u API_TOKEN:

Example Response:

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid API token."
}

עדכן תחום

PUT /v1/domains/example.com

פרמטר גוף נדרש סוג תיאור
smtp_port לא מחרוזת או מספר יציאה מותאמת אישית להגדרה להעברת SMTP (ברירת המחדל היא"25")

בקשת דוגמה:

curl -X PUT https://api.forwardemail.net/v1/domains/example.com \
  -u API_TOKEN:

Example Response:

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid 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 -X GET 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

Example Response:

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid API token."
}

הסר את ההזמנה לדומיין

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

בקשת דוגמה:

curl -X GET https://api.forwardemail.net/v1/domains/example.com/aliases \
  -u API_TOKEN:

Example Response:

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid API token."
}

צור כינוי דומיין חדש

POST /v1/domains/example.com/aliases

פרמטר גוף נדרש סוג תיאור
name כן מחרוזת שם הכינוי
recipients כן מחרוזת או מערך רשימת נמענים (חייבים להיות מופרדים בין מחרוזת שורה / רווח / פסיק או מערך של כתובות דוא"ל תקפות, שמות דומיין מלאים ("FQDN"), כתובות IP ו / או כתובות URL של רשת האינטרנט)
description לא מחרוזת תיאור הכינוי
labels לא מחרוזת או מערך רשימת התוויות (חייבת להיות מחרוזת או מערך מופרדים בפסקי שורות / רווח / פסיק)
is_enabled לא בוליאני האם לאפשר להשבית כינוי זה (אם מושבת, דוא"ל ינותב לשום מקום אלא יחזיר קודי סטטוס מוצלחים)

בקשת דוגמה:

curl -X POST https://api.forwardemail.net/v1/domains/example.com/aliases \
  -u API_TOKEN:

Example Response:

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid API token."
}

עדכן כינוי דומיין

PUT /v1/domains/example.com/aliases/:alias_id

פרמטר גוף נדרש סוג תיאור
name לא מחרוזת שם הכינוי
recipients כן מחרוזת או מערך רשימת נמענים (חייבים להיות מופרדים בין מחרוזת שורה / רווח / פסיק או מערך של כתובות דוא"ל תקפות, שמות דומיין מלאים ("FQDN"), כתובות IP ו / או כתובות URL של רשת האינטרנט)
description לא מחרוזת תיאור הכינוי
labels לא מחרוזת או מערך רשימת התוויות (חייבת להיות מחרוזת או מערך מופרדים בפסקי שורות / רווח / פסיק)
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: