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

# Scoperta delle proprietà in staging

> Scorri ogni proprietà collegata al tuo PMS, leggine una e vedi perché un'altra risponde 404.

Questa guida costruisce il passo di corrispondenza di un'integrazione: trova ogni proprietà Tatallo che i tuoi host hanno collegato al tuo PMS, così puoi salvare ciascun `id` accanto al tuo annuncio. Si esegue in staging, dove le proprietà di prova coincidono esattamente con questi esempi. Usa le variabili dell'[Avvio rapido](https://tatallo-docs.mintlify.site/it/get-started/quickstart.md).

## 1. Scorri l'elenco intero

Gli elenchi arrivano una pagina alla volta. Chiedi una pagina piccola per vedere il cursore in azione:

```bash theme={"dark"}
curl -s "$TATALLO_BASE_URL/v1/properties?limit=1" \
  -H "Authorization: Bearer $TATALLO_API_KEY"
```

```json theme={"dark"}
{
  "data": [
    {
      "id": "6cfa992d-1805-4de6-892c-23785031aba0",
      "name": "Fixture Loft Kreuzberg",
      "timezone": "Europe/Berlin",
      "status": "active",
      "country": "Germany",
      "city": "Berlin",
      "max_guests": 2,
      "currency": "EUR",
      "updated_at": "2026-10-01T09:00:00.000Z"
    }
  ],
  "page": {
    "next_cursor": "pKZAA9cXZioUAmmXQVzN4RBwg8cC3KXflLg_Ys2qB0vNw7TfJ1kq3m8cWl5yHh0eE4tR6uD1aPo"
  }
}
```

`page.next_cursor` non è `null`, quindi c'è dell'altro. Rinvialo come `cursor`, esattamente come l'hai ricevuto, e ripeti finché `next_cursor` è `null`:

```bash theme={"dark"}
cursor=""
while :; do
  page=$(curl -s -G "$TATALLO_BASE_URL/v1/properties" \
    -H "Authorization: Bearer $TATALLO_API_KEY" \
    --data-urlencode "limit=100" \
    ${cursor:+--data-urlencode "cursor=$cursor"})
  echo "$page" | jq -r '.data[] | "\(.id)  \(.status)  \(.name)"'
  cursor=$(echo "$page" | jq -r '.page.next_cursor // empty')
  [ -z "$cursor" ] && break
done
```

In staging questo stampa tre proprietà:

```text theme={"dark"}
6cfa992d-1805-4de6-892c-23785031aba0  active  Fixture Loft Kreuzberg
934f807c-39d6-45de-b107-d5c9e03cb041  inactive  Fixture House Alfama
bef2859f-2444-47ec-b5f4-f1e6701f087f  active  Fixture Apartment Trastevere
```

L'ordine è stabile tra le pagine, quindi scorrere ogni pagina restituisce ciascuna proprietà esattamente una volta. Un cursore è opaco e funziona solo con la chiave e l'ambiente che l'hanno ricevuto: non conservarlo e non costruirne uno a mano.

## 2. Leggi una proprietà

```bash theme={"dark"}
curl -s "$TATALLO_BASE_URL/v1/properties/934f807c-39d6-45de-b107-d5c9e03cb041" \
  -H "Authorization: Bearer $TATALLO_API_KEY"
```

```json theme={"dark"}
{
  "id": "934f807c-39d6-45de-b107-d5c9e03cb041",
  "name": "Fixture House Alfama",
  "timezone": "Europe/Lisbon",
  "status": "inactive",
  "country": "Portugal",
  "city": "Lisbon",
  "max_guests": 6,
  "currency": "EUR",
  "updated_at": "2026-10-01T09:00:00.000Z"
}
```

Questa è `inactive`: il suo host l'ha sospesa, quindi gli ospiti non possono prenotarla. Resta nel tuo elenco, quindi conserva la corrispondenza.

## Una proprietà non collegata al tuo PMS

L'host di prova dello staging ha un'altra proprietà, `a7591591-4684-4bf6-b66f-4d039414e433`, che non è collegata al tuo PMS:

```bash theme={"dark"}
curl -s "$TATALLO_BASE_URL/v1/properties/a7591591-4684-4bf6-b66f-4d039414e433" \
  -H "Authorization: Bearer $TATALLO_API_KEY"
```

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

È voluto, non un malfunzionamento. Una proprietà che il tuo PMS non può vedere riceve esattamente la stessa risposta di una proprietà che non esiste, a parte il `request_id`: così l'API non rivela nulla sulle proprietà fuori dal tuo collegamento. La proprietà compare nel tuo elenco, e si legge normalmente, dal momento in cui il suo host la collega al tuo PMS.


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