Découverte des propriétés sur le staging

Parcourez chaque propriété connectée à votre PMS, lisez-en une, et voyez pourquoi une autre renvoie un 404.

Ce guide construit l’étape de correspondance d’une intégration : trouver chaque propriété Tatallo que vos hôtes ont connectée à votre PMS, afin d’enregistrer chaque id à côté de votre propre annonce. Il s’exécute sur le staging, où les propriétés fictives correspondent exactement à ces exemples. Il utilise les variables du démarrage rapide.

​

1. Parcourez toute la liste

Les listes arrivent une page à la fois. Demandez une petite page pour voir le curseur à l’œuvre :

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 n’est pas null : il reste donc des éléments. Renvoyez-le dans cursor, exactement tel que vous l’avez reçu, et répétez jusqu’à ce que next_cursor vaille 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

Sur le staging, ceci affiche trois propriétés :

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’ordre est stable d’une page à l’autre : parcourir toutes les pages renvoie donc chaque propriété exactement une fois. Un curseur est opaque et ne fonctionne qu’avec la clé et l’environnement qui l’ont reçu : ne le stockez pas, et n’en construisez pas un à la main.

​

2. Lisez une propriété

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"
}

Celle-ci est inactive : son hôte l’a suspendue, les voyageurs ne peuvent donc pas la réserver. Elle reste dans votre liste : conservez sa correspondance.

​

Une propriété non connectée à votre PMS

L’hôte fictif du staging possède une propriété supplémentaire, a7591591-4684-4bf6-b66f-4d039414e433, qui n’est pas connectée à votre 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"
  }
}

Ce n’est pas un bug. Une propriété que votre PMS n’a pas le droit de voir répond exactement comme une propriété qui n’existe pas, à l’exception du request_id : l’API ne révèle donc rien sur les propriétés hors de votre connexion. La propriété apparaît dans votre liste, et se lit normalement, dès l’instant où son hôte la connecte à votre PMS.