> ## Documentation Index
> Fetch the complete documentation index at: https://docs.emailx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# La prima richiesta

> Dalla chiave con permessi limitati ai dati del tuo workspace.

L’API Emailx usa `https://app.emailx.ai`. L’accesso di produzione non è abilitato nella beta attuale: una richiesta può restituire `503 api_disabled`. Prima di procedere, chiedi al referente Emailx un ambiente abilitato e la chiave corrispondente. Le chiavi di test e di produzione non sono intercambiabili.

**1. Richiedi l'accesso beta**

Crea una chiave con scadenza in Emailx, da [Impostazioni > Chiavi API](https://docs.emailx.ai/it/overview/authentication.md#creare-una-chiave). Per questa guida servono `workspaces:read` e `campaigns:read`. L'accesso ai clienti di un'agenzia richiede anche `agency:read` e un'assegnazione attiva.

**2. Scegli l'ambiente corretto**

Usa l’origine ufficiale dell’app per un account di produzione abilitato:

```bash theme={null}
export EMAILX_BASE_URL="https://app.emailx.ai"
```

Carica `EMAILX_API_KEY` dal tuo gestore di segreti. Non inserire la chiave in URL, file versionati o log per l'assistenza. La produzione richiede un account abilitato e una chiave separata. Una chiave di test legge dati reali di staging: non crea una sandbox.

**3. Verifica la connessione**

```bash cURL theme={null}
curl "$EMAILX_BASE_URL/api/v1/me" \
  -H "Authorization: Bearer $EMAILX_API_KEY"
```

```python Python theme={null}
import json, os, urllib.request
request = urllib.request.Request(
    os.environ["EMAILX_BASE_URL"] + "/api/v1/me",
    headers={"Authorization": "Bearer " + os.environ["EMAILX_API_KEY"]},
)
with urllib.request.urlopen(request, timeout=30) as response:
    print(json.load(response))
```

```javascript JavaScript theme={null}
const response = await fetch(`${process.env.EMAILX_BASE_URL}/api/v1/me`, {
  headers: { Authorization: `Bearer ${process.env.EMAILX_API_KEY}` },
  signal: AbortSignal.timeout(30000),
});
if (!response.ok) throw new Error(`Emailx: ${response.status}`);
console.log(await response.json());
```

La risposta contiene i metadati della credenziale in `data`. Controlla ambiente, scadenza e scope prima di proseguire. I campi sono descritti in [Verificare la chiave API](https://docs.emailx.ai/it/api-reference/start/check-api-key.md).

**4. Scopri gli accessi attuali**

```bash theme={null}
curl "$EMAILX_BASE_URL/api/v1/workspaces?limit=25" \
  -H "Authorization: Bearer $EMAILX_API_KEY"
```

Scegli un ID presente in `data`. Gli accessi configurati sulla chiave sono solo il perimetro massimo; questa lista riflette i permessi attuali.

**5. Leggi le campagne di un canale**

Sostituisci `123` con l'ID appena ricevuto.

```bash theme={null}
curl "$EMAILX_BASE_URL/api/v1/workspaces/123/campaigns?channel=linkedin&limit=25" \
  -H "Authorization: Bearer $EMAILX_API_KEY"
```

Un array `data` vuoto è un risultato valido. Quando `has_more` è true, usa `next_cursor`.

## Passaggi successivi

[Prepara una bozza](https://docs.emailx.ai/it/overview/workflows.md), [gestisci la paginazione](https://docs.emailx.ai/it/api-reference/pagination.md) oppure [installa la CLI](https://docs.emailx.ai/it/cli/installation.md). Esegui le richieste dal backend o dal terminale: i cookie della sessione browser non le autenticano.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.