> ## 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.

# JSON e codici di uscita

> Distingui successo, accesso negato ed esiti incerti negli script.

Usa `--json` per ottenere un solo oggetto risultato o errore su stdout. La diagnostica va su stderr. Il successo conserva `data` e paginazione e aggiunge `meta.http_status`, `meta.request_id` e `meta.idempotent_replayed`.

Gli errori includono `code`, `message`, `http_status`, `request_id`, `retry_after` e `mutation_may_have_succeeded`. Usa stato di uscita e codice, senza interpretare il testo del messaggio.

| Uscita | Significato |
| - | - |
| 0 | Successo |
| 2 | Input o configurazione non validi |
| 3 | Autenticazione o autorizzazione |
| 4 | Risorsa mancante o inaccessibile |
| 5 | Duplicato, stato o conflitto di idempotenza |
| 6 | Limite richieste; rispettare retry\_after |
| 7 | Rete, servizio remoto, funzione non disponibile o risultato incerto |
| 1 | Errore locale inatteso |
| 130 | Interruzione o annullamento |

## Limita l'automazione

Le liste non leggono automaticamente tutte le pagine. Letture e modifiche non riprovano da sole. Rispetta i budget e conserva le chiavi delle operazioni logiche. Con timeout o risultato in attesa, controlla la risorsa prima di decidere come riprovare.

Un'uscita zero da `--dry-run` dimostra solo la validazione locale. Un errore dopo una modifica può corrispondere a dati già salvati: controlla `mutation_may_have_succeeded` e la guida al [recupero](https://docs.emailx.ai/it/api-reference/idempotency.md).

## Un job shell di sola lettura

```bash theme={null}
if emailx analytics get --workspace 123 --channel linkedin --json > report.json; then
  jq '.data' report.json
else
  status=$?
  jq '.error' report.json
  exit "$status"
fi
```

`jq` è uno strumento esterno opzionale. Report e anteprime oscurate possono contenere dati dei clienti: conserva l'output in modo adeguato e non stampare chiavi nei log.


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