Documentazione API

Integra LegallyMail nella tua applicazione con la nostra API REST

Introduzione

L'API di LegallyMail ti permette di inviare email certificate dalla tua applicazione. Tutti gli invii vengono registrati e puoi ottenere certificati legali di consegna e lettura.

Nota: Solo gli utenti che hanno effettuato almeno un pagamento possono usare l'API e creare token.

Autenticazione

Tutte le richieste all'API richiedono autenticazione tramite un token di accesso. Puoi ottenere il tuo token dal pannello utente.

Metodo 1: Header Authorization

Includi il token nell'header Authorization:

Authorization: Bearer YOUR_TOKEN_HERE

Metodo 2: Nel corpo della richiesta

Includi il token nel JSON del corpo:

{
  "token": "YOUR_TOKEN_HERE",
  "recipient": "example@example.com",
  ...
}

Ottenere un Token

Per ottenere un token API, devi prima aver effettuato almeno un pagamento. Successivamente puoi creare token dal tuo pannello utente.

Accedi

Endpoint

POST /api/send

Invia un'email certificata.

Parametri
Parametro Tipo Richiesto Descrizione
Authorization string (header) Token di autenticazione in formato "Bearer {token}" o solo il token
recipient / to string Indirizzo email del destinatario
Destinatari Multipli: È possibile inviare a più destinatari separando gli indirizzi email con virgole (es: "email1@example.com, email2@example.com, email3@example.com")
Limite predefinito: 10 destinatari. Questo limite può essere esteso su richiesta contattando il supporto.
subject string Oggetto dell'email
message / body / content string (HTML) Contenuto dell'email in formato HTML
reply_to string (email) No Indirizzo e-mail per le risposte. Deve essere un mittente registrato e verificato nel tuo account (opzionale).
reply_to_name string No Nome per le risposte (opzionale)
attachments array No Array di file allegati (opzionale). Ogni file deve avere: filename, content (base64), mime_type
Ejemplos de código
curl -X POST https://legallymail.com/api/send \
  -H "Authorization: Bearer YOUR_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": "recipient1@example.com, recipient2@example.com, recipient3@example.com",
    "subject": "Test Email with Multiple Recipients",
    "message": "<h1>Hello World</h1><p>This email is sent to multiple recipients.</p>",
    "attachments": [
      {
        "filename": "document.pdf",
        "content": "base64_encoded_file_content_here",
        "mime_type": "application/pdf"
      }
    ]
  }'