HTTP / cURL Reference

Usa HTTP direttamente se non hai un SDK ufficiale o preferisci lavorare con richieste HTTP grezze.

URL di Base

Tutti gli endpoint API sono sotto:

https://api.tratto.email/v1/

Autenticazione

Includi la tua API key come bearer token:

Authorization: Bearer tratto_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Content-Type

Tutte le richieste e risposte usano JSON:

Content-Type: application/json

Formato Richiesta

curl -X POST https://api.tratto.email/v1/emails \
  -H "Authorization: Bearer tratto_live_..." \
  -H "Content-Type: application/json" \
  -d '{"from":"[email protected]","to":"[email protected]","subject":"Ciao","text":"Mondo"}'

Formato Risposta

Successo (2xx):

{
  "data": { ... }
}

Errore (4xx):

{
  "error": {
    "code": "FORBIDDEN",
    "message": "The sending domain is not verified.",
    "docs": "https://docs.tratto.email/it/domains"
  }
}

Paginazione

Gli endpoint di elenco supportano paginazione basata su cursor:

curl "https://api.tratto.email/v1/contacts?limit=50&after=cursor_value" \
  -H "Authorization: Bearer tratto_live_..."

Operazioni Comuni

Invia Email

curl -X POST https://api.tratto.email/v1/emails \
  -H "Authorization: Bearer tratto_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "[email protected]",
    "to": "[email protected]",
    "subject": "Benvenuto!",
    "text": "Grazie per la registrazione"
  }'

Ottieni Status Email

curl https://api.tratto.email/v1/emails/email_abc123 \
  -H "Authorization: Bearer tratto_live_..."

Elenca Contatti

curl "https://api.tratto.email/v1/contacts?status=subscribed&limit=50" \
  -H "Authorization: Bearer tratto_live_..."

Crea Dominio

curl -X POST https://api.tratto.email/v1/domains \
  -H "Authorization: Bearer tratto_live_..." \
  -H "Content-Type: application/json" \
  -d '{"domain":"hello.tuodominio.it"}'

Codici di Stato

Codice	Significato
200	Successo
201	Creato
400	Richiesta Non Valida
401	Non Autorizzato
404	Non Trovato
429	Troppi Tentativi (rate limit, o quota del piano raggiunta: controlla `error.code`)
500	Errore Server

Link: API Reference

HTTP / cURL Reference

In questa pagina