# URL di iscrizione
> Ogni lista ha un URL di iscrizione ospitato che aggiunge persone senza chiave API. Scopri il formato della richiesta, come chiamarlo in sicurezza, i suoi limiti e come reimpostarlo.
Ogni lista ha un URL di iscrizione: un endpoint pubblico che aggiunge una persona alla lista senza chiave API. Usalo per collegare a una lista un modulo di iscrizione del tuo sito, o uno strumento no-code in grado di inviare una richiesta JSON.
```text
POST https://api.emailit.com/subscribe/{token}
```
Il `token` è un segreto della lista. Chiunque abbia l’URL può aggiungere indirizzi alla lista, quindi trattalo come una password.
## Trova l’URL
1. **Apri la lista.** Vai a **Email Marketing → Audiences** e seleziona la lista.
2. **Copia l’URL.** Seleziona **Subscribe URL** e copia l’URL dalla finestra.
Con l’API, [Recupera una lista](/it/docs/api-reference/audiences/get/) restituisce lo stesso valore in `token`.
## Formato della richiesta
Invia una richiesta `POST` con un corpo JSON e `Content-Type: application/json`. Non serve l’header `Authorization`.
- `email` (string, obbligatorio): L’indirizzo da iscrivere. Viene memorizzato in minuscolo.
- `first_name` (string): Il nome della persona. Sovrascrive il nome memorizzato di un contatto esistente.
- `last_name` (string): Il cognome della persona. Sovrascrive il cognome memorizzato di un contatto esistente.
- `custom_fields` (object): Valori indicizzati per chiave del [campo personalizzato](/it/docs/contacts/custom-fields/). Sostituisce tutti i valori dei campi personalizzati di un contatto esistente, quindi invialo solo quando hai l’insieme completo.
L’endpoint legge solo JSON. I corpi codificati come modulo, quelli che invia un semplice `
```
2. **Gestisci il modulo sul server.** Scarta gli invii che compilano l’honeypot, controlla un CAPTCHA se ne usi uno, poi inoltra i campi all’URL di iscrizione come JSON. Tieni il token in una variabile d’ambiente come `EMAILIT_SUBSCRIBE_TOKEN`. Vedi gli [esempi lato server](#server-examples) qui sotto.
3. **Provalo.** Invia il modulo con il tuo indirizzo e controlla di comparire nella tabella degli iscritti della lista.
### Esempi lato server
**Node.js**
```javascript title="server.js"
import express from 'express';
const app = express();
app.post('/newsletter', express.urlencoded({ extended: false }), async (req, res) => {
// Bots fill in the honeypot. Pretend it worked and stop.
if (req.body.website) return res.redirect(303, '/thanks');
const response = await fetch(
`https://api.emailit.com/subscribe/${process.env.EMAILIT_SUBSCRIBE_TOKEN}`,
{
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
email: req.body.email,
first_name: req.body.first_name || undefined,
}),
},
);
if (!response.ok) {
const { error } = await response.json().catch(() => ({}));
return res.status(response.status).send(error || 'Could not subscribe.');
}
res.redirect(303, '/thanks');
});
app.listen(3000);
```
**PHP**
```php title="newsletter.php"
true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode([
'email' => $_POST['email'] ?? '',
'first_name' => $_POST['first_name'] ?? null,
]),
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
if ($status !== 200) {
http_response_code($status);
echo json_decode($body, true)['error'] ?? 'Could not subscribe.';
exit;
}
header('Location: /thanks', true, 303);
```
**cURL**
```bash
curl "https://api.emailit.com/subscribe/$EMAILIT_SUBSCRIBE_TOKEN" \
-X POST \
-H "Content-Type: application/json" \
-d '{ "email": "ada@example.com", "first_name": "Ada" }'
```
Se la pagina invia il modulo con JavaScript invece di ricaricarsi per intero, chiama il tuo endpoint con `fetch` e tieni la chiamata a Emailit sul server:
```javascript title="signup.js"
document.querySelector('#signup').addEventListener('submit', async (event) => {
event.preventDefault();
const form = new FormData(event.target);
const response = await fetch('/newsletter', { method: 'POST', body: new URLSearchParams(form) });
event.target.querySelector('.status').textContent = response.ok
? 'Thanks, you are subscribed.'
: 'Something went wrong. Please try again.';
});
```
### Limite di frequenza e volumi più alti
L’URL di iscrizione accetta 30 richieste al minuto da ciascun indirizzo IP e oltre restituisce `429`. Se il server inoltra ogni iscrizione, provengono tutte dall’IP del server, quindi il limite di 30 al minuto vale per l’intero sito. Se prevedi volumi maggiori, chiama invece [Aggiungi un iscritto](/it/docs/api-reference/audiences/subscribers/add/) dal server con una chiave API. Quell’endpoint restituisce anche `409` per le persone già iscritte e avvia le automazioni **Added to audience**, ad esempio per inviare un’email di benvenuto.
## Conferma le iscrizioni
L’URL di iscrizione aggiunge le persone subito. Emailit non invia un’email di conferma e non chiede alla persona di confermare il proprio indirizzo (double opt-in).
Se vuoi iscrizioni confermate, integra la conferma nel tuo flusso: quando qualcuno invia il modulo, memorizza la richiesta sul server e [inviagli un’email](/it/docs/email-api/send-email/) con un link di conferma che rimanda al tuo sito. Chiama l’URL di iscrizione solo dopo che la persona ha aperto quel link.
## Reimposta l’URL
Reimposta il token se l’URL è trapelato o se ricevi iscrizioni di spam. Il vecchio URL smette subito di funzionare e restituisce `404`.
1. **Apri la finestra.** Nella pagina della lista, seleziona **Subscribe URL**.
2. **Reimposta.** Seleziona **Reset token** e conferma. Emailit genera un nuovo URL.
3. **Aggiorna le integrazioni.** Sostituisci il token ovunque lo usi, ad esempio nella variabile `EMAILIT_SUBSCRIBE_TOKEN` del server.
Il token si può reimpostare solo dal pannello.
## Vedi anche
- [Gestisci gli iscritti](/it/docs/audiences/subscribers/): Aggiungi persone con l’API e gestisci le reiscrizioni.
- [Disiscrizioni](/it/docs/audiences/unsubscribes/): Permetti alle persone di lasciare le liste.
---
Fonte: https://emailit.com/it/docs/audiences/subscribe-url/