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.

​

1. Scorri l’elenco intero

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

curl -s "$TATALLO_BASE_URL/v1/properties?limit=1" \
  -H "Authorization: Bearer $TATALLO_API_KEY"

{
  "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:

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à:

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à

curl -s "$TATALLO_BASE_URL/v1/properties/934f807c-39d6-45de-b107-d5c9e03cb041" \
  -H "Authorization: Bearer $TATALLO_API_KEY"

{
  "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:

curl -s "$TATALLO_BASE_URL/v1/properties/a7591591-4684-4bf6-b66f-4d039414e433" \
  -H "Authorization: Bearer $TATALLO_API_KEY"

{
  "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.