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

# Errori

> Una sola forma di errore, sei codici stabili.

Ogni errore dell'API PMS Tatallo ha la stessa forma:

```json theme={"dark"}
{
  "error": {
    "code": "property_not_found",
    "message": "Property not found.",
    "request_id": "385c1118-7082-4e15-97a7-16703f74d58b"
  }
}
```

| Campo | Significato |
| - | - |
| `code` | Un codice stabile, in snake\_case. **Decidi in base a questo.** |
| `message` | Una spiegazione in inglese, per chi legge, qualunque sia il tuo `Accept-Language`. Può cambiare in qualsiasi momento: non decidere mai in base a essa. |
| `request_id` | Lo stesso valore dell'header `X-Request-Id` della risposta. Citalo al [supporto](https://tatallo-docs.mintlify.site/it/platform/support.md). |

## Codici

| Stato | `code` | Significato | Che cosa fare |
| - | - | - | - |
| `400` | `invalid_limit` | `limit` non è un numero intero da 1 a 100. | Invia un `limit` da 1 a 100, oppure omettilo per il valore predefinito di 25. |
| `400` | `invalid_cursor` | `cursor` non è un cursore ricevuto da questa chiave: è stato modificato, costruito a mano, oppure emesso per un'altra chiave o un altro ambiente. | Ricomincia lo scorrimento senza cursore. Vedi [Paginazione](https://tatallo-docs.mintlify.site/it/platform/pagination.md). |
| `401` | `unauthorized` | La chiave manca, è malformata, appartiene all'altro ambiente, è scaduta oppure è stata revocata. | Controlla la chiave e la base URL. Vedi [Autenticazione](https://tatallo-docs.mintlify.site/it/get-started/authentication.md). |
| `403` | `insufficient_scope` | La chiave è valida, ma non ha lo scope richiesto dalla route. | Chiedi una chiave con quello scope. |
| `404` | `property_not_found` | La proprietà non è collegata al tuo PMS, oppure non esiste. I due casi ricevono la stessa risposta. | Usa un `id` ottenuto da `GET /v1/properties`. |
| `429` | `rate_limited` | Troppe richieste in questo minuto. | Attendi i secondi indicati in `Retry-After`. Vedi [Limiti di frequenza](https://tatallo-docs.mintlify.site/it/platform/rate-limits.md). |

Dentro `/v1` i codici non cambiano significato. Possono arrivare codici nuovi per situazioni nuove, quindi gestisci un codice sconosciuto in base al suo stato HTTP.


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