Documentazione API di invio

Una API per inviare email di registrazione, reset password e notifiche dal tuo sito — senza SMTP.

Ottieni una API key

Disponibile ora Proprietà, MX, SPF, DKIM e DMARC sono verificati separatamente. Quando pronti, invia con una API key e monitora nel pannello i risultati per destinatario: consegnato, fallito, in attesa.

Avvio rapido

  1. 1

    Collega un dominio

    Aggiungi il tuo dominio di invio in Invio per siti.

  2. 2

    Verifica il DNS

    Aggiungi i record SPF / DKIM / DMARC e il TXT di verifica, poi verifica con un clic.

  3. 3

    Crea una chiave

    Crea una chiave te_live_ — il testo è mostrato una sola volta, salvalo subito.

Invia un’email

Una richiesta POST con la chiave te_live_ nell’header Authorization.

curl -X POST https://tutuemail.com/api/sending/send \
  -H "Authorization: Bearer te_live_xxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: signup-user-123" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "noreply@your-domain.com",
    "to": "user@example.com",
    "subject": "欢迎注册",
    "html": "<p>点击验证你的邮箱</p>"
  }'

Campi della richiesta

from Indirizzo mittente, deve essere sotto un dominio verificato
to Indirizzo destinatario (singolo o array)
subject Oggetto email
html / text Corpo email (HTML o testo semplice)
Idempotency-Key Header facoltativo; riusa il valore nei retry per evitare invii doppi

Una richiesta accettata restituisce HTTP 202 con id e stato accepted. Con la stessa API key, GET /api/sending/messages/{id} restituisce per destinatario: consegnato, fallito, in attesa o sconosciuto.

Errori e limiti

401 Chiave non valida o revocata — rigenera una chiave te_live_
403 Dominio mittente non verificato o indirizzo non sotto un dominio verificato
429 Frequenza di invio superata; la risposta contiene retry_after — riprova come indicato
503 Motore email temporaneamente non disponibile; riprova con la stessa Idempotency-Key

Numero di destinatari, dimensione del corpo e frequenza hanno limiti di protezione. L’uso è conteggiato solo dopo la validazione, così le richieste non valide non consumano la tua quota.

Pronto a integrare?

Ottieni una API key Leggi le FAQ