Interfejs API do przesyłania e-maili

Biblioteki

W tej chwili nie wydaliśmy jeszcze żadnych wrapperów API, ale planujemy to zrobić w najbliższej przyszłości. Wysłać e-maila do api@forwardemail.net jeśli chcesz być powiadamiany o wydaniu wrappera API określonego języka programowania. W międzyczasie możesz użyć tych zalecanych bibliotek żądań HTTP w swojej aplikacji lub po prostu użyć kędzior jak w poniższych przykładach.

Język	Biblioteka
Rubin	Faradaya
Pyton	upraszanie
Jawa	OkHttp
PHP	chlać
JavaScript	superagent (jesteśmy konserwatorami)
Node.js	superagent (jesteśmy konserwatorami)
Udać się	netto / http
.NET	ResztaSharp

Podstawowy identyfikator URI

Bieżąca ścieżka podstawowego identyfikatora URI HTTP to: https://api.forwardemail.net.

Poświadczenie

Wszystkie punkty końcowe wymagają Twojego Klucz API być ustawionym jako wartość „nazwa użytkownika” żądania Podstawowa autoryzacja nagłówek. Nie martw się – poniżej znajdziesz przykłady, jeśli nie masz pewności, co to jest.

Błędy

Jeśli wystąpią jakiekolwiek błędy, treść odpowiedzi żądania API będzie zawierać szczegółowy komunikat o błędzie.

Kod	Imię
200	OK
400	Zła prośba
401	Nieautoryzowany
403	Zabroniony
404	Nie znaleziono
429	Zbyt dużo próśb
500	Wewnętrzny błąd serwera
501	Nie zaimplementowano
502	zła Brama
503	serwis niedostępny
504	Limit czasu bramki

Wskazówka: Jeśli otrzymasz kod statusu 5xx (co nie powinno mieć miejsca), skontaktuj się z nami pod adresem api@forwardemail.net a my pomożemy Ci natychmiast rozwiązać Twój problem.

Lokalizacja

Nasza usługa jest tłumaczona na ponad 25 różnych języków. Wszystkie komunikaty odpowiedzi API są tłumaczone na ostatnie wykryte ustawienia regionalne użytkownika zgłaszającego żądanie API. Możesz to zmienić, przekazując niestandardowy Accept-Language nagłówek. Wypróbuj go, korzystając z menu rozwijanego języka na dole tej strony.

Paginacja

Jeśli chcesz otrzymać powiadomienie o dostępności stronicowania, napisz e-mail api@forwardemail.net.

Konto

Utwórz konto

POST /v1/account

Parametr ciała	wymagany	Rodzaj	Opis
`email`	tak	Ciąg (e-mail)	Adres e-mail
`password`	tak	Strunowy	Hasło

Przykładowe zapytanie:

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

Odzyskać konto

GET /v1/account

Przykładowe zapytanie:

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

Zaktualizuj konto

PUT /v1/account

Parametr ciała	wymagany	Rodzaj	Opis
`email`	Nie	Ciąg (e-mail)	Adres e-mail
`given_name`	Nie	Strunowy	Imię
`family_name`	Nie	Strunowy	Nazwisko
`avatar_url`	Nie	Ciąg (URL)	Link do obrazu awatara

Przykładowe zapytanie:

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

Domeny

Wskazówka: Punkty końcowe domeny z nazwą domeny /v1/domains/:domain_name ponieważ ich ścieżka jest wymienna z identyfikatorem domeny :domain_id. Oznacza to, że możesz odwoływać się do domeny przez jej name lub id wartość.

Lista domen

GET /v1/domains

Parametr Querystring	wymagany	Rodzaj	Opis
`name`	Nie	Ciąg (obsługiwany RegExp)	Wyszukaj domeny według nazwy
`alias`	Nie	Ciąg (obsługiwany RegExp)	Wyszukaj domeny według nazwy aliasu
`recipient`	Nie	Ciąg (obsługiwany RegExp)	Wyszukaj domeny według odbiorcy

Przykładowe zapytanie:

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

Utwórz domenę

POST /v1/domains

Parametr ciała	wymagany	Rodzaj	Opis
`domain`	tak	Ciąg (FQDN lub IP)	W pełni kwalifikowana nazwa domeny („FQDN”) lub adres IP
`plan`	Nie	Ciąg (wyliczalny)	Typ planu (musi być `"free"`, `"enhanced_protection"`, lub `"team"`, domyślnie `"free"` lub aktualny płatny abonament użytkownika, jeśli na jednym)
`catchall`	Nie	Ciąg (rozdzielane adresy e-mail) lub wartość logiczna	Utwórz domyślny alias typu catch-all, domyślnie `true` (jeśli `true` użyje adresu e-mail użytkownika API jako odbiorcy, a jeśli `false` nie zostanie utworzony żaden catch-all). Jeśli zostanie przekazany ciąg, to jest to rozdzielona lista adresów e-mail, które mają być używane jako odbiorcy (oddzielone podziałem wiersza, spacją i/lub przecinkiem)
`has_adult_content_protection`	Nie	Boole'a	Czy włączyć w tej domenie ochronę treści dla dorosłych w Skanerze spamu
`has_phishing_protection`	Nie	Boole'a	Czy włączyć ochronę przed phishingiem Skanera spamu w tej domenie
`has_executable_protection`	Nie	Boole'a	Czy włączyć ochronę plików wykonywalnych Skanera spamu w tej domenie
`has_virus_protection`	Nie	Boole'a	Czy włączyć ochronę antywirusową Skanera spamu w tej domenie
`has_recipient_verification`	Nie	Boole'a	Domyślna domena globalna określająca, czy wymagać od odbiorców aliasów kliknięcia linku weryfikacyjnego adresu e-mail w celu przepłynięcia wiadomości e-mail

Przykładowe zapytanie:

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

Odzyskaj domenę

GET /v1/domains/example.com

Przykładowe zapytanie:

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

Sprawdź rekordy domeny

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

Przykładowe zapytanie:

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

Zaktualizuj domenę

PUT /v1/domains/example.com

Parametr ciała	wymagany	Rodzaj	Opis
`smtp_port`	Nie	Ciąg lub liczba	Niestandardowy port do skonfigurowania dla przekazywania SMTP (domyślnie `"25"`)
`has_adult_content_protection`	Nie	Boole'a	Czy włączyć w tej domenie ochronę treści dla dorosłych w Skanerze spamu
`has_phishing_protection`	Nie	Boole'a	Czy włączyć ochronę przed phishingiem Skanera spamu w tej domenie
`has_executable_protection`	Nie	Boole'a	Czy włączyć ochronę plików wykonywalnych Skanera spamu w tej domenie
`has_virus_protection`	Nie	Boole'a	Czy włączyć ochronę antywirusową Skanera spamu w tej domenie
`has_recipient_verification`	Nie	Boole'a	Domyślna domena globalna określająca, czy wymagać od odbiorców aliasów kliknięcia linku weryfikacyjnego adresu e-mail w celu przepłynięcia wiadomości e-mail

Przykładowe zapytanie:

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

Usuń domenę

DELETE /v1/domains/:domain_name

Przykładowe zapytanie:

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

Zaprasza

Zaakceptuj zaproszenie do domeny

GET /v1/domains/:domain_name/invites

Przykładowe zapytanie:

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

Utwórz zaproszenie do domeny

POST /v1/domains/example.com/invites

Parametr ciała	wymagany	Rodzaj	Opis
`email`	tak	Ciąg (e-mail)	Adres e-mail do zaproszenia na listę członków domeny
`group`	tak	Ciąg (wyliczalny)	Grupa do dodania użytkownika do członkostwa w domenie (może być jedną z `"admin"` lub `"user"`)

Przykładowe zapytanie:

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

Usuń zaproszenie do domeny

DELETE /v1/domains/:domain_name/invites

Parametr ciała	wymagany	Rodzaj	Opis
`email`	tak	Ciąg (e-mail)	Adres e-mail do usunięcia z listy członków domeny

Przykładowe zapytanie:

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

Członkowie

Zaktualizuj członka domeny

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

Parametr ciała	wymagany	Rodzaj	Opis
`group`	tak	Ciąg (wyliczalny)	Grupa do aktualizacji użytkownika do członkostwa w domenie (może być jedną z `"admin"` lub `"user"`)

Przykładowe zapytanie:

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

Usuń członka domeny

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

Przykładowe zapytanie:

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

Skróty

Wyświetlanie listy aliasów domen

GET /v1/domains/example.com/aliases

Parametr Querystring	wymagany	Rodzaj	Opis
`name`	Nie	Ciąg (obsługiwany RegExp)	Wyszukaj aliasy w domenie według nazwy
`recipient`	Nie	Ciąg (obsługiwany RegExp)	Wyszukaj aliasy w domenie według odbiorcy

Przykładowe zapytanie:

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

Utwórz nowy alias domeny

POST /v1/domains/example.com/aliases

Parametr ciała	wymagany	Rodzaj	Opis
`name`	tak	Strunowy	Pseudonim
`recipients`	tak	Łańcuch lub tablica	Lista adresatów (musi być oddzielona linią / spacją / przecinkiem Ciąg lub tablica prawidłowych adresów e-mail, w pełni kwalifikowanych nazw domen („FQDN”), adresów IP i / lub adresów URL haka internetowego)
`description`	Nie	Strunowy	Opis aliasu
`labels`	Nie	Łańcuch lub tablica	Lista etykiet (musi być ciągiem lub tablicą z podziałem wiersza / spacją / przecinkiem)
`has_recipient_verification`	Nie	Boole'a	Czy włączyć wymaganie od odbiorców kliknięcia linku weryfikacyjnego wiadomości e-mail w celu przepłynięcia wiadomości e-mail (domyślnie jest to ustawienie domeny, jeśli nie zostało to wyraźnie określone w treści żądania)
`is_enabled`	Nie	Boole'a	Określa, czy włączyć tę alias (jeśli wyłączona, wiadomości e-mail nie będą kierowane nigdzie, ale zwracają pomyślne kody stanu)

Przykładowe zapytanie:

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

Pobierz alias domeny

Możesz pobrać alias domeny przez jego id lub jego name wartość.

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

Przykładowe zapytanie:

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

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

Przykładowe zapytanie:

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

Zaktualizuj alias domeny

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

Parametr ciała	wymagany	Rodzaj	Opis
`name`	Nie	Strunowy	Pseudonim
`recipients`	tak	Łańcuch lub tablica	Lista adresatów (musi być oddzielona linią / spacją / przecinkiem Ciąg lub tablica prawidłowych adresów e-mail, w pełni kwalifikowanych nazw domen („FQDN”), adresów IP i / lub adresów URL haka internetowego)
`description`	Nie	Strunowy	Opis aliasu
`labels`	Nie	Łańcuch lub tablica	Lista etykiet (musi być ciągiem lub tablicą z podziałem wiersza / spacją / przecinkiem)
`has_recipient_verification`	Nie	Boole'a	Czy włączyć wymaganie od odbiorców kliknięcia linku weryfikacyjnego wiadomości e-mail w celu przepłynięcia wiadomości e-mail (domyślnie jest to ustawienie domeny, jeśli nie zostało to wyraźnie określone w treści żądania)
`is_enabled`	Nie	Boole'a	Określa, czy włączyć tę alias (jeśli wyłączona, wiadomości e-mail nie będą kierowane nigdzie, ale zwracają pomyślne kody stanu)

Przykładowe zapytanie:

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

Usuń alias domeny

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

Przykładowe zapytanie:

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