ต้องการเอกสารที่มีข้อมูลและกุญแจจริงหรือไม่?

เพียงลงทะเบียนหรือเข้าสู่ระบบเพื่อให้คีย์ API ของคุณและข้อมูลบัญชีจริงปรากฏขึ้นด้านล่าง

อ่าน นโยบายความเป็นส่วนตัว และ ข้อกำหนดของเรา

ไม่สนใจ? คลิกที่นี่เพื่ออ่านต่อ

เราได้สร้าง API สำหรับการเข้าถึงโดยทางโปรแกรมไปยังโดเมนนามแฝงและอื่น ๆ

🤖

เอกสาร API

การเข้าถึงข้อมูลของคุณแบบเป็นโปรแกรม

API การส่งต่ออีเมล

สารบัญ

ห้องสมุด

ตอนนี้เรายังไม่ได้เปิดตัว wraps API แต่เราวางแผนที่จะทำในอนาคตอันใกล้ ส่งอีเมลไปที่api@forwardemail.net หากคุณต้องการรับการแจ้งเตือนเมื่อมีการปล่อย API wrapper ของภาษาโปรแกรมเฉพาะ ในขณะเดียวกันคุณสามารถใช้ไลบรารีคำขอ HTTP ที่แนะนำเหล่านี้ในแอปพลิเคชันของคุณหรือใช้ขด ดังในตัวอย่างด้านล่าง

ภาษา ห้องสมุด
ทับทิม ฟาราเดย์
หลาม การร้องขอ
ชวา OkHttp
PHP ล่อ
JavaScript superagent
Node.js superagent
ไป สุทธิ / http
.สุทธิ RestSharp

URI ฐาน

เส้นทาง URI ฐาน HTTP ปัจจุบันคือ:https://api.forwardemail.net. เส้นทาง HTTP พื้นฐาน URI ดั้งเดิมของhttps://forwardemail.net:4000 จะเลิกใช้ในวันที่ 1 มกราคม 2564

การรับรอง

ปลายทางทั้งหมดต้องการของคุณรหัส 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 ของ webhook)
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 ของ webhook)
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: