Tarvitsetko asiakirjoja, joissa on todelliset tiedot ja avaimet?

Sinun tarvitsee vain rekisteröityä tai kirjautua sisään, jotta API-avaimet ja oikeat tilitiedot täytetään alla.

Lue tietosuojakäytäntömme ja ehdot

Etkö ole kiinnostunut? Napsauta tätä jatkaaksesi lukemista

Olemme luoneet sovellusliittymän verkkotunnusten, aliasten ja muun ohjelmalliseen käyttöön.

API-dokumentaatio

Ohjelmoitu pääsy tietoihisi

Email Forwarding API

Sisällysluettelo

Kirjastot

Tällä hetkellä emme ole vielä julkaisseet mitään API-kääreitä, mutta aiomme tehdä sen lähitulevaisuudessa. Lähetä sähköposti osoitteeseenapi@forwardemail.net jos haluat ilmoituksen, kun tietyn ohjelmointikielen API-kääre vapautetaan. Sillä välin voit käyttää näitä suositeltuja HTTP-pyyntökirjastoja sovelluksessasi tai käyttää yksinkertaisestikiemura kuten alla olevissa esimerkeissä.

Kieli Kirjasto
Rubiini Faraday
Python pyynnöt
Java OkHttp
PHP ahmia
JavaScript superagentti
Node.js superagentti
Mennä net / http
.NETTO LepoTerävä

Perus-URI

Nykyinen HTTP-perus-URI-polku on:https://api.forwardemail.net. Aiempi HTTP-pohjainen URI-polkuhttps://forwardemail.net:4000 on poistettu käytöstä 1. tammikuuta 2021.

Todennus

Kaikki päätepisteet vaativat sinunilmainen API-avain : tada: asetetaan pyynnön "käyttäjänimi" -arvoksiPeruslupa otsikko. Älä huoli - alla on sinulle esimerkkejä, jos et ole varma mikä tämä on.

Virheet

Jos virheitä tapahtuu, API-pyynnön vastausrunko sisältää yksityiskohtaisen virhesanoman.

Koodi Nimi
200 OK
400 Virheellinen pyyntö
401 Luvaton
403 Kielletty
404 Ei löydetty
429 Liian monta pyyntöä
500 Sisäinen palvelinvirhe
501 Ei toteutettu
502 Huono yhdyskäytävä
503 palvelu ei saatavilla
504 Yhdyskäytävän aikakatkaisu
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.

Lokalisointi

Palvelumme käännetään yli 25 eri kielelle. Kaikki API-vastausviestit käännetään API-pyynnön esittäneen käyttäjän viimeksi havaitulle kielelle. Voit ohittaa tämän välittämällä mukautetunAccept-Language otsikko. Voit kokeilla sitä vapaasti tämän sivun alaosassa olevalla avattavalla kielellä.

Sivunumerointi

Jos haluat ilmoituksen, kun sivutus on käytettävissä, lähetä sähköpostiaapi@forwardemail.net.

Tili

Luo tili

POST /v1/account

Kehon parametri Edellytetään Tyyppi Kuvaus
email Joo Merkkijono (sähköposti) Sähköpostiosoite
password Joo Merkkijono Salasana

Esimerkkipyyntö:

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

Nouda tili

GET /v1/account

Esimerkkipyyntö:

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

Päivitä tili

PUT /v1/account

Kehon parametri Edellytetään Tyyppi Kuvaus
email Ei Merkkijono (sähköposti) Sähköpostiosoite
given_name Ei Merkkijono Etunimi
family_name Ei Merkkijono Sukunimi
avatar_url Ei Merkkijono (URL) Linkki avatar-kuvaan

Esimerkkipyyntö:

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

Verkkotunnukset

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.

Luettelo verkkotunnuksista

GET /v1/domains

Kyselymerkkiparametri Edellytetään Tyyppi Kuvaus
name Ei Merkkijono (RegExp tuettu) Hae verkkotunnuksia nimen mukaan
alias Ei Merkkijono (RegExp tuettu) Hae verkkotunnuksia aliaksen nimen perusteella
recipient Ei Merkkijono (RegExp tuettu) Hae verkkotunnuksia vastaanottajan mukaan

Esimerkkipyyntö:

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

Luo verkkotunnus

POST /v1/domains

Kehon parametri Edellytetään Tyyppi Kuvaus
domain Joo Merkkijono (FQDN tai IP) Täysin hyväksytty verkkotunnus ("FQDN") tai IP-osoite
plan Ei Merkkijono (lueteltava) Suunnitelman tyyppi (on oltava"free","enhanced_protection"tai"team", oletuksena"free")
catchall Ei Merkkijono (erotetut sähköpostiosoitteet) tai Boolean Luo oletusarvoinen allias, oletuksenatrue (jostrue se käyttää API-käyttäjän sähköpostiosoitetta vastaanottajana ja josfalse kaikkia ei luoda. Jos merkkijono välitetään, se on erotettu luettelo sähköpostiosoitteista, joita käytetään vastaanottajina (erotettu rivinvaihdolla, välilyönnillä ja / tai pilkulla)

Esimerkkipyyntö:

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

Hae verkkotunnus

GET /v1/domains/example.com

Esimerkkipyyntö:

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

Vahvista verkkotunnustietueet

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

Esimerkkipyyntö:

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

Päivitä verkkotunnus

PUT /v1/domains/example.com

Kehon parametri Edellytetään Tyyppi Kuvaus
smtp_port Ei Merkkijono tai numero Mukautettu portti SMTP-edelleenlähetystä varten (oletus on"25")

Esimerkkipyyntö:

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

Poista verkkotunnus

DELETE /v1/domains/:domain_name

Esimerkkipyyntö:

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

Kutsuu

Hyväksy verkkotunnuksen kutsu

GET /v1/domains/:domain_name/invites

Esimerkkipyyntö:

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

Luo verkkotunnuksen kutsu

POST /v1/domains/example.com/invites

Kehon parametri Edellytetään Tyyppi Kuvaus
email Joo Merkkijono (sähköposti) Sähköpostiosoite, jota kutsutaan verkkotunnuksen jäsenluetteloon
group Joo Merkkijono (lueteltava) Ryhmä, jolla käyttäjä lisätään verkkotunnusjäsenyyteen (voi olla yksi"admin" tai"user")

Esimerkkipyyntö:

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

Poista verkkotunnuksen kutsu

DELETE /v1/domains/:domain_name/invites

Kehon parametri Edellytetään Tyyppi Kuvaus
email Joo Merkkijono (sähköposti) Sähköpostiosoite, joka poistetaan verkkotunnuksen jäsenluettelosta

Esimerkkipyyntö:

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

Jäsenet

Päivitä verkkotunnuksen jäsen

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

Kehon parametri Edellytetään Tyyppi Kuvaus
group Joo Merkkijono (lueteltava) Ryhmä päivittää käyttäjän verkkotunnuksen jäseneksi (voi olla yksi"admin" tai"user")

Esimerkkipyyntö:

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

Poista verkkotunnuksen jäsen

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

Esimerkkipyyntö:

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

Aliakset

Hae verkkotunnuksen aliakset

GET /v1/domains/example.com/aliases

Kyselymerkkiparametri Edellytetään Tyyppi Kuvaus
name Ei Merkkijono (RegExp tuettu) Etsi aliaksia verkkotunnuksesta nimen perusteella
recipient Ei Merkkijono (RegExp tuettu) Etsi aliaksia verkkotunnuksesta vastaanottajan mukaan

Esimerkkipyyntö:

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

Luo uusi verkkotunnuksen alias

POST /v1/domains/example.com/aliases

Kehon parametri Edellytetään Tyyppi Kuvaus
name Joo Merkkijono Alias nimi
recipients Joo Merkkijono tai Array Luettelo vastaanottajista (täytyy olla rivinvaihto / välilyönti / pilkuilla erotettu merkkijono tai taulukko kelvollisista sähköpostiosoitteista, täysin hyväksytyistä verkkotunnuksista ("FQDN"), IP-osoitteista ja / tai webhook-URL-osoitteista)
description Ei Merkkijono Aliaksen kuvaus
labels Ei Merkkijono tai Array Luettelo tarroista (täytyy olla rivinvaihto / välilyönti / pilkulla erotettu merkkijono tai taulukko)
is_enabled Ei Boolen Otetaanko tämän aliaksen poistaminen käytöstä (jos se on poistettu käytöstä, sähköpostit reititetään mihinkään, mutta palauttavat onnistuneet tilakoodit)

Esimerkkipyyntö:

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

Päivitä verkkotunnuksen alias

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

Kehon parametri Edellytetään Tyyppi Kuvaus
name Ei Merkkijono Alias nimi
recipients Joo Merkkijono tai Array Luettelo vastaanottajista (täytyy olla rivinvaihto / välilyönti / pilkuilla erotettu merkkijono tai taulukko kelvollisista sähköpostiosoitteista, täysin hyväksytyistä verkkotunnuksista ("FQDN"), IP-osoitteista ja / tai webhook-URL-osoitteista)
description Ei Merkkijono Aliaksen kuvaus
labels Ei Merkkijono tai Array Luettelo tarroista (täytyy olla rivinvaihto / välilyönti / pilkulla erotettu merkkijono tai taulukko)
is_enabled Ei Boolen Otetaanko tämän aliaksen poistaminen käytöstä (jos se on poistettu käytöstä, sähköpostit reititetään mihinkään, mutta palauttavat onnistuneet tilakoodit)

Esimerkkipyyntö:

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

Poista verkkotunnuksen alias

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

Esimerkkipyyntö:

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