Riferimento
Tutti gli endpoint
Tutti gli endpoint dell’API v2 di Emailit in un unico posto, raggruppati per risorsa, con metodo HTTP, percorso, il permesso della chiave API che richiedono e un link al riferimento.
Questa pagina elenca tutti gli endpoint dell’API di Emailit, raggruppati per risorsa. I percorsi sono relativi all’URL di base https://api.emailit.com/v2, e {id} indica l’ID dell’oggetto (oppure, dove l’endpoint lo consente, il suo nome o il suo indirizzo email).
La colonna Permesso indica quali chiavi API possono chiamare l’endpoint:
| Permesso | Funziona con |
|---|---|
sending |
Chiavi con il permesso sending o full. |
events |
Chiavi con il permesso events o full. |
full |
Solo chiavi con il permesso full. |
I token di accesso OAuth seguono le stesse regole delle chiavi API con lo stesso permesso. OAuth non ha un permesso events, quindi per quegli endpoint i token richiedono full.
Invia email, consulta i messaggi e il loro contenuto, e programmali, annullali, ritentali o inoltrali. Per il riferimento completo, vedi Email.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Invia un’email | POST |
/emails |
sending |
| Elenca le email | GET |
/emails |
full |
| Recupera un’email | GET |
/emails/{id} |
full |
| Recupera il MIME grezzo | GET |
/emails/{id}/raw |
full |
| Elenca gli allegati | GET |
/emails/{id}/attachments |
full |
| Recupera il corpo | GET |
/emails/{id}/body |
full |
| Recupera i metadati | GET |
/emails/{id}/meta |
full |
| Aggiorna un’email programmata | POST |
/emails/{id} |
sending |
| Annulla un’email | POST |
/emails/{id}/cancel |
sending |
| Ritenta un’email | POST |
/emails/{id}/retry |
sending |
| Inoltra un’email | POST |
/emails/{id}/forward |
sending |
| Recupera solo lo stato | GET |
/email/{id} |
full |
Domini
Aggiungi domini di invio, leggi i loro record DNS e lo stato della verifica, e verificali. Per il riferimento completo, vedi Domini.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Crea un dominio | POST |
/domains |
full |
| Recupera un dominio | GET |
/domains/{id} |
full |
| Verifica un dominio | POST |
/domains/{id}/verify |
full |
| Aggiorna un dominio | POST |
/domains/{id} |
full |
| Elenca i domini | GET |
/domains |
full |
| Elimina un dominio | DELETE |
/domains/{id} |
full |
Report DMARC
Leggi i report DMARC aggregati e forensi di un dominio di invio, o carica i tuoi. Per il riferimento completo, vedi Report DMARC.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Elenca i report aggregati | GET |
/domains/{id}/dmarc/reports |
full |
| Recupera un report | GET |
/domains/{id}/dmarc/reports/{report_id} |
full |
| Carica un report | POST |
/domains/{id}/dmarc/reports |
full |
| Elenca i report forensi | GET |
/domains/{id}/dmarc/forensic |
full |
| Recupera un report forense | GET |
/domains/{id}/dmarc/forensic/{report_id} |
full |
| Recupera le statistiche | GET |
/domains/{id}/dmarc/stats |
full |
| Elenca le sorgenti di invio | GET |
/domains/{id}/dmarc/sources |
full |
| Elenca i paesi | GET |
/domains/{id}/dmarc/countries |
full |
| Elenca le reti (ASN) | GET |
/domains/{id}/dmarc/asns |
full |
| Elenca i mittenti dei report | GET |
/domains/{id}/dmarc/reporters |
full |
Chiavi API
Crea, elenca, rinomina e revoca le chiavi API di un workspace. Per il riferimento completo, vedi Chiavi API.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Crea una chiave API | POST |
/api-keys |
full |
| Recupera una chiave API | GET |
/api-keys/{id} |
full |
| Elenca le chiavi API | GET |
/api-keys |
full |
| Aggiorna una chiave API | POST |
/api-keys/{id} |
full |
| Rigenera una chiave API | POST |
/api-keys/{id}/regenerate |
full |
| Elimina una chiave API | DELETE |
/api-keys/{id} |
full |
Liste
Gestisci le liste di iscritti usate dalle campagne e dai moduli di iscrizione. Per il riferimento completo, vedi Liste.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Crea una lista | POST |
/audiences |
full |
| Recupera una lista | GET |
/audiences/{id} |
full |
| Aggiorna una lista | POST |
/audiences/{id} |
full |
| Elenca le liste | GET |
/audiences |
full |
| Elimina una lista | DELETE |
/audiences/{id} |
full |
Iscritti
Aggiungi, aggiorna e rimuovi gli iscritti di una lista. Per il riferimento completo, vedi Iscritti.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Aggiungi un iscritto | POST |
/audiences/{audience_id}/subscribers |
full |
| Recupera un iscritto | GET |
/audiences/{audience_id}/subscribers/{id} |
full |
| Aggiorna un iscritto | POST |
/audiences/{audience_id}/subscribers/{id} |
full |
| Elenca gli iscritti | GET |
/audiences/{audience_id}/subscribers |
full |
| Elimina un iscritto | DELETE |
/audiences/{audience_id}/subscribers/{id} |
full |
Contatti
Gestisci i profili dei contatti e i campi personalizzati, in blocco o uno alla volta. Per il riferimento completo, vedi Contatti.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Crea un contatto | POST |
/contacts |
full |
| Recupera un contatto | GET |
/contacts/{id} |
full |
| Aggiorna un contatto | POST |
/contacts/{id} |
full |
| Elenca i contatti | GET |
/contacts |
full |
| Aggiorna i contatti in blocco | POST |
/contacts/bulk |
full |
| Esporta i contatti | GET, POST |
/contacts/export |
full |
| Elimina un contatto | DELETE |
/contacts/{id} |
full |
Segmenti
Salva filtri sui contatti, elenca chi corrisponde e segui nel tempo i segmenti tracciati. Per il riferimento completo, vedi Segmenti.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Crea un segmento | POST |
/segments |
full |
| Recupera un segmento | GET |
/segments/{id} |
full |
| Aggiorna un segmento | POST |
/segments/{id} |
full |
| Elenca i segmenti | GET |
/segments |
full |
| Elimina un segmento | DELETE |
/segments/{id} |
full |
| Elenca i contatti di un segmento | GET |
/segments/{id}/contacts |
full |
| Recupera la crescita di un segmento | GET |
/segments/{id}/growth |
full |
| Visualizza l’anteprima di un segmento | POST |
/segments/preview |
full |
| Elenca i campi dei segmenti | GET |
/segments/fields |
full |
Campagne
Crea campagne, scegli le loro liste e i loro segmenti, e inviale o programmale. Per il riferimento completo, vedi Campagne.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Crea una campagna | POST |
/campaigns |
full |
| Recupera una campagna | GET |
/campaigns/{id} |
full |
| Aggiorna una campagna | POST |
/campaigns/{id} |
full |
| Elenca le campagne | GET |
/campaigns |
full |
| Invia o programma una campagna | POST |
/campaigns/{id}/send |
full |
| Annulla una campagna | POST |
/campaigns/{id}/cancel |
full |
| Recupera le statistiche di una campagna | GET |
/campaigns/{id}/stats |
full |
| Elimina una campagna | DELETE |
/campaigns/{id} |
full |
Prodotti
Tieni il catalogo del tuo negozio in Emailit per le griglie di prodotti, i consigli e le righe degli ordini. Per il riferimento completo, vedi Prodotti. È in beta nei piani Pro, Business e Contract. Vedi Chi può usare l’e-commerce.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Crea o aggiorna un prodotto | POST |
/products |
events |
| Recupera un prodotto | GET |
/products/{id} |
full |
| Aggiorna un prodotto | POST |
/products/{id} |
events |
| Elenca i prodotti | GET |
/products |
full |
| Crea o aggiorna prodotti in blocco | POST |
/products/batch |
events |
| Elenca le categorie di prodotti | GET |
/products/categories |
full |
| Elimina un prodotto | DELETE |
/products/{id} |
full |
Ordini
Invia gli ordini del tuo negozio per attribuire i ricavi alle email e creare i profili acquisti. Per il riferimento completo, vedi Ordini. È in beta nei piani Pro, Business e Contract. Vedi Chi può usare l’e-commerce.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Crea o aggiorna un ordine | POST |
/orders |
events |
| Recupera un ordine | GET |
/orders/{id} |
full |
| Aggiorna un ordine | POST |
/orders/{id} |
events |
| Elenca gli ordini | GET |
/orders |
full |
| Importa ordini in blocco | POST |
/orders/batch |
events |
| Elimina un ordine | DELETE |
/orders/{id} |
full |
Carrelli
Invia i carrelli dei tuoi acquirenti perché Emailit rilevi i carrelli abbandonati. Per il riferimento completo, vedi Carrelli. È in beta nei piani Pro, Business e Contract. Vedi Chi può usare l’e-commerce.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Crea o aggiorna un carrello | POST |
/carts |
events |
| Recupera un carrello | GET |
/carts/{id} |
full |
| Elenca i carrelli | GET |
/carts |
full |
| Elimina un carrello | DELETE |
/carts/{id} |
full |
Coupon
Crea coupon e gestisci i loro pool di codici unici per le email. Per il riferimento completo, vedi Coupon. È in beta nei piani Pro, Business e Contract. Vedi Chi può usare l’e-commerce.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Crea un coupon | POST |
/coupons |
full |
| Recupera un coupon | GET |
/coupons/{id} |
full |
| Aggiorna un coupon | POST |
/coupons/{id} |
full |
| Elenca i coupon | GET |
/coupons |
full |
| Elimina un coupon | DELETE |
/coupons/{id} |
full |
| Elenca i codici di un coupon | GET |
/coupons/{id}/codes |
full |
| Aggiungi codici a un coupon | POST |
/coupons/{id}/codes |
full |
E-commerce
Le impostazioni e-commerce, il riepilogo dei ricavi e il profilo acquisti di un contatto. Per il riferimento completo, vedi E-commerce. È in beta nei piani Pro, Business e Contract. Vedi Chi può usare l’e-commerce.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Recupera le impostazioni e-commerce | GET |
/commerce/settings |
full |
| Aggiorna le impostazioni e-commerce | POST |
/commerce/settings |
full |
| Recupera il riepilogo e-commerce | GET |
/commerce/overview |
full |
| Recupera il profilo acquisti di un contatto | GET |
/contacts/{id}/commerce |
full |
Automazioni
Costruisci flussi di lavoro con trigger e passaggi, eseguili e analizza le loro esecuzioni. Per il riferimento completo, vedi Automazioni.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Crea un’automazione | POST |
/automations |
full |
| Recupera un’automazione | GET |
/automations/{id} |
full |
| Aggiorna un’automazione | POST |
/automations/{id} |
full |
| Elenca le automazioni | GET |
/automations |
full |
| Elimina un’automazione | DELETE |
/automations/{id} |
full |
| Avvia un’automazione | POST |
/automations/{id}/start |
full |
| Metti in pausa un’automazione | POST |
/automations/{id}/pause |
full |
| Interrompi un’automazione | POST |
/automations/{id}/stop |
full |
| Avvia un’esecuzione | POST |
/automations/{id}/trigger |
full |
| Elenca le esecuzioni | GET |
/automations/{id}/runs |
full |
| Recupera un’esecuzione | GET |
/automations/{id}/runs/{run_id} |
full |
| Recupera le statistiche | GET |
/automations/{id}/stats |
full |
| Recupera le statistiche dei passaggi | GET |
/automations/{id}/steps/{step_key}/stats |
full |
Moduli
Crea moduli di iscrizione, pubblicali e ruota il loro token pubblico. Per il riferimento completo, vedi Moduli.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Crea un modulo | POST |
/forms |
full |
| Recupera un modulo | GET |
/forms/{id} |
full |
| Aggiorna un modulo | POST |
/forms/{id} |
full |
| Elenca i moduli | GET |
/forms |
full |
| Pubblica un modulo | POST |
/forms/{id}/publish |
full |
| Ritira un modulo | POST |
/forms/{id}/unpublish |
full |
| Reimposta il token pubblico | POST |
/forms/{id}/reset-token |
full |
| Elimina un modulo | DELETE |
/forms/{id} |
full |
Template
Crea versioni dei template, pubblicane una per alias e usale per inviare. Per il riferimento completo, vedi Template.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Crea un template | POST |
/templates |
full |
| Recupera un template | GET |
/templates/{id} |
full |
| Aggiorna un template | POST |
/templates/{id} |
full |
| Elenca i template | GET |
/templates |
full |
| Pubblica un template | POST |
/templates/{id}/publish |
full |
| Elimina un template | DELETE |
/templates/{id} |
full |
Soppressioni
Leggi e gestisci gli indirizzi a cui Emailit non invia. Per il riferimento completo, vedi Soppressioni.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Crea una soppressione | POST |
/suppressions |
full |
| Recupera una soppressione | GET |
/suppressions/{id} |
full |
| Aggiorna una soppressione | POST |
/suppressions/{id} |
full |
| Elenca le soppressioni | GET |
/suppressions |
full |
| Elimina una soppressione | DELETE |
/suppressions/{id} |
full |
Webhook
Registra endpoint che ricevono notifiche di eventi firmate. Per il riferimento completo, vedi Webhook.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Crea un webhook | POST |
/webhooks |
full |
| Recupera un webhook | GET |
/webhooks/{id} |
full |
| Aggiorna un webhook | POST |
/webhooks/{id} |
full |
| Elenca i webhook | GET |
/webhooks |
full |
| Elimina un webhook | DELETE |
/webhooks/{id} |
full |
| Invia un evento di test | POST |
/webhooks/{id}/test |
full |
| Ruota il secret di firma | POST |
/webhooks/{id}/reset-secret |
full |
| Ritenta le richieste non riuscite | POST |
/webhooks/{id}/retry-failed |
full |
| Ritenta una richiesta | POST |
/webhooks/{id}/requests/{request_id}/retry |
full |
Eventi
Invia eventi di workspace e personalizzati, e leggi il flusso di eventi alla base dei webhook: consegne, bounce, aperture e altro. Per il riferimento completo, vedi Eventi.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Invia un evento | POST |
/events |
events |
| Invia eventi in batch | POST |
/events/batch |
events |
| Elenca gli eventi | GET |
/events |
full |
| Recupera un evento | GET |
/events/{id} |
full |
Eventi di workspace
Definisci gli eventi di workspace e i tipi delle loro proprietà. Per il riferimento completo, vedi Eventi di workspace.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Crea un evento di workspace | POST |
/workspace/events |
full |
| Recupera un evento di workspace | GET |
/workspace/events/{id} |
full |
| Aggiorna un evento di workspace | POST |
/workspace/events/{id} |
full |
| Elenca gli eventi di workspace | GET |
/workspace/events |
full |
| Elimina un evento di workspace | DELETE |
/workspace/events/{id} |
full |
Chiavi di tracciamento
Gestisci le chiavi pubbliche dello script di tracciamento. Per il riferimento completo, vedi Chiavi di tracciamento.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Crea una chiave di tracciamento | POST |
/tracking-keys |
full |
| Recupera una chiave di tracciamento | GET |
/tracking-keys/{id} |
full |
| Aggiorna una chiave di tracciamento | POST |
/tracking-keys/{id} |
full |
| Elenca le chiavi di tracciamento | GET |
/tracking-keys |
full |
| Elimina una chiave di tracciamento | DELETE |
/tracking-keys/{id} |
full |
Verifica email
Verifica un singolo indirizzo in tempo reale. Per il riferimento completo, vedi Verifica email.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Verifica un indirizzo | POST |
/email-verifications |
full |
Liste di verifica
Verifica fino a 10.000 indirizzi alla volta ed esporta gli esiti. Per il riferimento completo, vedi Liste di verifica.
| Endpoint | Metodo | Percorso | Permesso |
|---|---|---|---|
| Crea una lista | POST |
/email-verification-lists |
full |
| Elenca le liste | GET |
/email-verification-lists |
full |
| Recupera una lista | GET |
/email-verification-lists/{id} |
full |
| Elenca gli esiti | GET |
/email-verification-lists/{id}/results |
full |
| Esporta gli esiti | GET |
/email-verification-lists/{id}/export |
full |