Email Forwarding API

Obsah

• Knihovny
• Základní URI
• Ověřování
• Chyby
• Lokalizace
• Stránkování
• Účet
  • Vytvořit účet
  • Načíst účet
  • Aktualizujte účet
• Domény
  • Seznam domén
  • Vytvořit doménu
  • Načíst doménu
  • Ověřte záznamy domény
  • Aktualizujte doménu
  • Smazat doménu
• Pozvánky
  • Přijmout pozvání do domény
  • Vytvořit pozvánku na doménu
  • Odebrat pozvánku na doménu
• Členové
  • Aktualizujte člena domény
  • Odebrat člena domény
• Aliasy
  • Vypsat aliasy domén
  • Vytvořit nový alias domény
  • Načíst alias domény
  • Aktualizujte alias domény
  • Odstranit alias domény

Knihovny

Momentálně jsme zatím žádné API obaly nevydali, ale v blízké budoucnosti to plánujeme. Pošlete e-mail na adresuapi@forwardemail.net pokud chcete být upozorněni, když se uvolní obálka API konkrétního programovacího jazyka. Mezitím můžete ve své aplikaci použít tyto doporučené knihovny požadavků HTTP nebo jednoduše použítkučera jako v níže uvedených příkladech.

Jazyk	Knihovna
Rubín	Faraday
Krajta	žádosti
Jáva	OkHttp
PHP	žrát
JavaScript	superagent
Node.js	superagent
Jít	net / http
.SÍŤ	RestSharp

Základní URI

Aktuální cesta URI základní HTTP je:https://api.forwardemail.net. Původní základní cesta URI protokolu HTTPhttps://forwardemail.net:4000 je k 1. lednu 2021 ukončena podpora.

Ověřování

Všechny koncové body vyžadují vašeAPI key to be set as the "username" value of the request's Základní autorizace záhlaví. Nebojte se - příklady jsou uvedeny níže, pokud si nejste jisti, co to je.

Chyby

Pokud dojde k chybě, tělo odpovědi požadavku API bude obsahovat podrobnou chybovou zprávu.

Kód	název
200	OK
400	Špatný požadavek
401	Neoprávněný
403	Zakázáno
404	Nenalezeno
429	Příliš mnoho žádostí
500	Interní chyba serveru
501	Není implementováno
502	Špatná brána
503	služba je nedostupná
504	Časový limit brány

Lokalizace

Naše služba je přeložena do více než 25 různých jazyků. Všechny zprávy s odpověďmi API jsou přeloženy do posledního detekovaného národního prostředí uživatele, který podal požadavek na rozhraní API. Můžete to přepsat předáním vlastníhoAccept-Language záhlaví. Neváhejte a vyzkoušejte to pomocí rozbalovací nabídky jazyků v dolní části této stránky.

Stránkování

Pokud chcete být upozorněni, když bude k dispozici stránkování, pošlete e-mailapi@forwardemail.net.

Účet

Vytvořit účet

POST /v1/account

Parametr těla	Požadované	Typ	Popis
email	Ano	Řetězec (e-mail)	Emailová adresa
password	Ano	Tětiva	Heslo

Příklad požadavku:

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

Načíst účet

GET /v1/account

Příklad požadavku:

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

Aktualizujte účet

PUT /v1/account

Parametr těla	Požadované	Typ	Popis
email	Ne	Řetězec (e-mail)	Emailová adresa
given_name	Ne	Tětiva	Jméno
family_name	Ne	Tětiva	Příjmení
avatar_url	Ne	Řetězec (URL)	Odkaz na obrázek avatar

Příklad požadavku:

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

Domény

Seznam domén

GET /v1/domains

Parametr dotazu	Požadované	Typ	Popis
name	Ne	Řetězec (podporováno RegExp)	Hledejte domény podle jména
alias	Ne	Řetězec (podporováno RegExp)	Hledejte domény podle aliasu
recipient	Ne	Řetězec (podporováno RegExp)	Vyhledejte domény podle příjemce

Příklad požadavku:

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

Vytvořit doménu

POST /v1/domains

Parametr těla	Požadované	Typ	Popis
domain	Ano	Řetězec (FQDN nebo IP)	Plně kvalifikovaný název domény („FQDN“) nebo adresa IP
plan	Ne	Řetězec (počet)	Typ plánu (musí být"free","enhanced_protection", nebo"team", výchozí nastavení"free" or the user's current paid plan if on one)
catchall	Ne	Řetězec (oddělené e-mailové adresy) nebo logická hodnota	Vytvořit výchozí univerzální alias, výchozítrue (litrue jako příjemce použije e-mailovou adresu uživatele API, pokudfalse nebude vytvořen žádný catch-all). Pokud je předán řetězec, jedná se o oddělený seznam e-mailových adres, které se použijí jako příjemci (oddělené zalomením řádku, mezerou nebo čárkou)
has_adult_content_protection	Ne	Booleovský	Whether to enable Spam Scanner adult content protection on this domain
has_phishing_protection	Ne	Booleovský	Whether to enable Spam Scanner phishing protection on this domain
has_executable_protection	Ne	Booleovský	Whether to enable Spam Scanner executable protection on this domain
has_virus_protection	Ne	Booleovský	Whether to enable Spam Scanner virus protection on this domain
has_recipient_verification	Ne	Booleovský	Global domain default for whether to require alias recipients to click an email verification link for emails to flow through

Příklad požadavku:

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

Načíst doménu

GET /v1/domains/example.com

Příklad požadavku:

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

Ověřte záznamy domény

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

Příklad požadavku:

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

Aktualizujte doménu

PUT /v1/domains/example.com

Parametr těla	Požadované	Typ	Popis
smtp_port	Ne	Řetězec nebo číslo	Vlastní port pro konfiguraci pro předávání SMTP (výchozí je"25")
has_adult_content_protection	Ne	Booleovský	Whether to enable Spam Scanner adult content protection on this domain
has_phishing_protection	Ne	Booleovský	Whether to enable Spam Scanner phishing protection on this domain
has_executable_protection	Ne	Booleovský	Whether to enable Spam Scanner executable protection on this domain
has_virus_protection	Ne	Booleovský	Whether to enable Spam Scanner virus protection on this domain
has_recipient_verification	Ne	Booleovský	Global domain default for whether to require alias recipients to click an email verification link for emails to flow through

Příklad požadavku:

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

Smazat doménu

DELETE /v1/domains/:domain_name

Příklad požadavku:

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

Pozvánky

Přijmout pozvání do domény

GET /v1/domains/:domain_name/invites

Příklad požadavku:

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

Vytvořit pozvánku na doménu

POST /v1/domains/example.com/invites

Parametr těla	Požadované	Typ	Popis
email	Ano	Řetězec (e-mail)	E-mailová adresa pro pozvání do seznamu členů domény
group	Ano	Řetězec (počet)	Skupina pro přidání uživatele do členství v doméně s (může být jedním z"admin" nebo"user")

Příklad požadavku:

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

Odebrat pozvánku na doménu

DELETE /v1/domains/:domain_name/invites

Parametr těla	Požadované	Typ	Popis
email	Ano	Řetězec (e-mail)	E-mailová adresa, kterou chcete odstranit ze seznamu členů domény

Příklad požadavku:

curl -X DELETE https://api.forwardemail.net/v1/domains/:domain_name/invites \
  -u API_TOKEN:

Členové

Aktualizujte člena domény

PUT /v1/domains/example.com/members/:member_id

Parametr těla	Požadované	Typ	Popis
group	Ano	Řetězec (počet)	Skupina pro aktualizaci uživatele na členství v doméně s (může být jedním z"admin" nebo"user")

Příklad požadavku:

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

Odebrat člena domény

DELETE /v1/domains/:domain_name/members/:member_id

Příklad požadavku:

curl -X DELETE https://api.forwardemail.net/v1/domains/:domain_name/members/:member_id \
  -u API_TOKEN:

Aliasy

Vypsat aliasy domén

GET /v1/domains/example.com/aliases

Parametr dotazu	Požadované	Typ	Popis
name	Ne	Řetězec (podporováno RegExp)	Vyhledejte aliasy v doméně podle názvu
recipient	Ne	Řetězec (podporováno RegExp)	Vyhledejte aliasy v doméně podle příjemce

Příklad požadavku:

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

Vytvořit nový alias domény

POST /v1/domains/example.com/aliases

Parametr těla	Požadované	Typ	Popis
name	Ano	Tětiva	Jméno aliasu
recipients	Ano	Řetězec nebo pole	Seznam příjemců (musí být řetězec oddělený mezerou / mezerou / čárkou nebo pole platných e-mailových adres, plně kvalifikovaných doménových jmen („FQDN“), IP adres a / nebo adres URL pro webhook)
description	Ne	Tětiva	Popis aliasu
labels	Ne	Řetězec nebo pole	Seznam štítků (musí být řetězec oddělený mezerou / mezerou nebo čárkou)
has_recipient_verification	Ne	Booleovský	Whether to enable to require recipients to click an email verification link for emails to flow through (defaults to the domain's setting if not explicitly set in the request body)
is_enabled	Ne	Booleovský	Zda se má zakázat tento alias (pokud je zakázán, e-maily nebudou směrovány nikde, ale vrátí úspěšné stavové kódy)

Příklad požadavku:

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

Načíst alias domény

Alias domény můžete načíst buď jehoid nebo jehoname hodnota.

GET /v1/domains/:domain_name/aliases/:alias_id

Příklad požadavku:

curl https://api.forwardemail.net/v1/domains/:domain_name/aliases/:alias_id \
  -u API_TOKEN:

GET /v1/domains/:domain_name/aliases/:alias_name

Příklad požadavku:

curl https://api.forwardemail.net/v1/domains/:domain_name/aliases/:alias_name \
  -u API_TOKEN:

Aktualizujte alias domény

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

Parametr těla	Požadované	Typ	Popis
name	Ne	Tětiva	Jméno aliasu
recipients	Ano	Řetězec nebo pole	Seznam příjemců (musí být řetězec oddělený mezerou / mezerou / čárkou nebo pole platných e-mailových adres, plně kvalifikovaných doménových jmen („FQDN“), IP adres a / nebo adres URL pro webhook)
description	Ne	Tětiva	Popis aliasu
labels	Ne	Řetězec nebo pole	Seznam štítků (musí být řetězec oddělený mezerou / mezerou nebo čárkou)
has_recipient_verification	Ne	Booleovský	Whether to enable to require recipients to click an email verification link for emails to flow through (defaults to the domain's setting if not explicitly set in the request body)
is_enabled	Ne	Booleovský	Zda se má zakázat tento alias (pokud je zakázán, e-maily nebudou směrovány nikde, ale vrátí úspěšné stavové kódy)

Příklad požadavku:

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

Odstranit alias domény

DELETE /v1/domains/:domain_name/aliases/:alias_id

Příklad požadavku:

curl -X DELETE https://api.forwardemail.net/v1/domains/:domain_name/aliases/:alias_id \
  -u API_TOKEN: