Menu
Accedi Crea account
API REST

API per invii programmatici.

Endpoint /v1/messages REST con autenticazione Bearer, idempotency key, rate limiting trasparente.

Autenticazione

Tutte le richieste richiedono l'header Authorization: Bearer tg_live_xxxxx. Le chiavi sono generate dal pannello (sezione API keys), sono permanenti finche non le revochi e possono avere scope (es. solo send, solo read).

Invio messaggio

curl -X POST https://api.targetsmtp.it/v1/messages \
  -H "Authorization: Bearer $TARGET_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "from":    "noreply@tuosito.it",
    "to":      ["utente@example.com"],
    "subject": "Conferma ordine #1024",
    "html":    "<p>Grazie!</p>",
    "tags":    ["order-confirmation"]
  }'

Idempotency

Passa un header Idempotency-Key (UUID v4 raccomandato): se ritenti la stessa richiesta in caso di timeout di rete, garantiamo che il messaggio non sia inviato due volte. La chiave e valida 24 ore.

Rate limit

Le risposte includono header X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. Quando esaurito, riceverai HTTP 429 con Retry-After. Il limite per ora dipende dal piano (vedi pricing).

Errori

Tutti gli errori restituiscono JSON con error.code, error.message, e error.field dove utile. Status code HTTP semantici: 400 validazione, 401 auth, 402 quota esaurita, 422 dato non processabile, 429 rate limit, 5xx server.

Funzionalità