API di inoltro email

Sommario

biblioteche
URI di base
Autenticazione
Errori
Localizzazione
paginatura
account
domini
Inviti
Membri
- Aggiorna membro del dominio
- Rimuovi membro del dominio
alias

biblioteche

Al momento non abbiamo ancora rilasciato alcun wrapper API, ma prevediamo di farlo nel prossimo futuro. Invia una mail aapi@forwardemail.net se desideri ricevere una notifica quando viene rilasciato il wrapper API di un particolare linguaggio di programmazione. Nel frattempo, puoi utilizzare queste librerie di richieste HTTP consigliate nella tua applicazione o semplicemente usarearricciare come negli esempi seguenti.

linguaggio	Biblioteca
Rubino	Faraday
Pitone	richieste
Giava	OkHttp
PHP	gozzovigliare
JavaScript	superagent
Node.js	superagent
Partire	net / http
.NETTO	RestSharp

URI di base

Il percorso URI di base HTTP corrente è:https://api.forwardemail.net. Il percorso URI di base HTTP legacy dihttps://forwardemail.net:4000 sarà deprecato il 1 ° gennaio 2021.

Autenticazione

Tutti gli endpoint richiedono il tuochiave API gratuita 🎉 da impostare come valore "username" della richiestaAutorizzazione di base intestazione. Non preoccuparti: di seguito sono riportati degli esempi se non sei sicuro di cosa si tratti.

Errori

Se si verificano errori, il corpo della risposta della richiesta API conterrà un messaggio di errore dettagliato. Oltre ad avere oltre dieci anni di esperienza nella scrittura di API e nella loro documentazione, sono stati ispiratiStrisce bella documentazione API quando abbiamo creato il nostro 😄.

Codice	Nome
200	ok
400	Brutta richiesta
401	non autorizzato
403	Vietato
404	Non trovato
429	Troppe richieste
500	Errore interno del server
501	Non implementato
502	Bad Gateway
503	Servizio non disponibile
504	Timeout gateway

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.

Localizzazione

Il nostro servizio è tradotto in oltre 25 lingue diverse. Tutti i messaggi di risposta API vengono tradotti nell'ultima localizzazione rilevata dall'utente che ha effettuato la richiesta API. Puoi ignorarlo passando un'abitudineAccept-Language intestazione. Sentiti libero di provarlo usando il menu a discesa nella parte inferiore di questa pagina.

paginatura

Se desideri ricevere una notifica quando è disponibile l'impaginazione, invia un'e-mailapi@forwardemail.net.

account

Creare un profilo

POST /v1/account

Parametro del corpo	necessario	genere	Descrizione
`email`	sì	String (email)	Indirizzo email
`password`	sì	Corda	Parola d'ordine

Richiesta di esempio:

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."
}

Recupera account

GET /v1/account

Richiesta di esempio:

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

Example Response:

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

Aggiorna account

PUT /v1/account

Parametro del corpo	necessario	genere	Descrizione
`email`	No	String (email)	Indirizzo email
`given_name`	No	Corda	nome di battesimo
`family_name`	No	Corda	Cognome
`avatar_url`	No	String (URL)	Link all'immagine avatar

Richiesta di esempio:

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."
}

domini

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.

Elenca domini

GET /v1/domains

Parametro Querystring	necessario	genere	Descrizione
`name`	No	String (supportato da RegExp)	Cerca domini per nome
`alias`	No	String (supportato da RegExp)	Cerca domini per nome alias
`recipient`	No	String (supportato da RegExp)	Cerca domini per destinatario

Richiesta di esempio:

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

Example Response:

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

Crea dominio

POST /v1/domains

Parametro del corpo	necessario	genere	Descrizione
`domain`	sì	String (FQDN o IP)	Nome di dominio completo ("FQDN") o indirizzo IP
`plan`	No	String (enumerabile)	Tipo di piano (deve essere`"free"`,`"enhanced_protection"`, o`"team"`, il valore predefinito è`"free"`)
`catchall`	No	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)

Richiesta di esempio:

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."
}

Recupera dominio

GET /v1/domains/example.com

Richiesta di esempio:

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

Example Response:

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

Verifica i record di dominio

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

Richiesta di esempio:

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."
}

Aggiorna dominio

PUT /v1/domains/example.com

Parametro del corpo	necessario	genere	Descrizione
`smtp_port`	No	Stringa o numero	Porta personalizzata da configurare per l'inoltro SMTP (impostazione predefinita è`"25"`)

Richiesta di esempio:

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

Example Response:

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

Elimina dominio

DELETE /v1/domains/:domain_name

Richiesta di esempio:

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

Inviti

Accetta l'invito al dominio

GET /v1/domains/:domain_name/invites

Richiesta di esempio:

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

Crea un invito al dominio

POST /v1/domains/example.com/invites

Parametro del corpo	necessario	genere	Descrizione
`email`	sì	String (email)	Indirizzo email da invitare all'elenco dei membri del dominio
`group`	sì	String (enumerabile)	Gruppo con cui aggiungere l'utente all'appartenenza al dominio (può essere uno dei`"admin"` o`"user"`)

Richiesta di esempio:

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."
}

Rimuovi l'invito al dominio

DELETE /v1/domains/:domain_name/invites

Parametro del corpo	necessario	genere	Descrizione
`email`	sì	String (email)	Indirizzo e-mail da rimuovere dall'elenco dei membri del dominio

Richiesta di esempio:

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

Membri

Aggiorna membro del dominio

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

Parametro del corpo	necessario	genere	Descrizione
`group`	sì	String (enumerabile)	Gruppo per aggiornare l'utente con l'appartenenza al dominio (può essere uno dei`"admin"` o`"user"`)

Richiesta di esempio:

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

Rimuovi membro del dominio

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

Richiesta di esempio:

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

alias

Recupera gli alias di dominio

GET /v1/domains/example.com/aliases

Richiesta di esempio:

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."
}

Crea un nuovo alias di dominio

POST /v1/domains/example.com/aliases

Parametro del corpo	necessario	genere	Descrizione
`name`	sì	Corda	Pseudonimo
`recipients`	sì	String o Array	Elenco di destinatari (deve essere una stringa / spazio / virgola separati da stringa o matrice di indirizzi e-mail validi, nomi di dominio completi ("FQDN"), indirizzi IP e / o URL di webhook)
`description`	No	Corda	Descrizione alias
`labels`	No	String o Array	Elenco di etichette (deve essere un'interruzione di riga / spazio / virgola separati String o Array)
`is_enabled`	No	booleano	Se abilitare per disabilitare questo alias (se disabilitato, le e-mail non verranno indirizzate da nessuna parte ma restituiranno codici di stato riusciti)

Richiesta di esempio:

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."
}

Aggiorna alias di dominio

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

Parametro del corpo	necessario	genere	Descrizione
`name`	No	Corda	Pseudonimo
`recipients`	sì	String o Array	Elenco di destinatari (deve essere una stringa / spazio / virgola separati da stringa o matrice di indirizzi e-mail validi, nomi di dominio completi ("FQDN"), indirizzi IP e / o URL di webhook)
`description`	No	Corda	Descrizione alias
`labels`	No	String o Array	Elenco di etichette (deve essere un'interruzione di riga / spazio / virgola separati String o Array)
`is_enabled`	No	booleano	Se abilitare per disabilitare questo alias (se disabilitato, le e-mail non verranno indirizzate da nessuna parte ma restituiranno codici di stato riusciti)

Richiesta di esempio:

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

Elimina alias di dominio

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

Richiesta di esempio:

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

Hai bisogno di documenti con dati e chiavi reali?

Documentazione API

API di inoltro email

Sommario

biblioteche

URI di base

Autenticazione

Errori

Localizzazione

paginatura

account

Creare un profilo

Recupera account

Aggiorna account

domini

Elenca domini

Crea dominio

Recupera dominio

Verifica i record di dominio

Aggiorna dominio

Elimina dominio

Inviti

Accetta l'invito al dominio

Crea un invito al dominio

Rimuovi l'invito al dominio

Membri

Aggiorna membro del dominio

Rimuovi membro del dominio

alias

Recupera gli alias di dominio

Crea un nuovo alias di dominio

Aggiorna alias di dominio

Elimina alias di dominio