Démarrage rapide

D’une clé de staging à un appel fonctionnel en quelques minutes.

Il vous faut une credential PMS de staging. Si vous n’en avez pas encore, demandez l’accès.

​

1. Définissez deux variables d’environnement

export TATALLO_BASE_URL="https://staging.api.tatallo.com"
export TATALLO_API_KEY="tat_stg_sk_<credential-id>_<secret>"   # your staging key

Chaque exemple de cette documentation lit ces deux variables. Pour passer plus tard en production, remplacez TATALLO_BASE_URL par https://api.tatallo.com et utilisez votre clé de production.

​

2. Vérifiez votre clé

curl -s "$TATALLO_BASE_URL/v1/me" \
  -H "Authorization: Bearer $TATALLO_API_KEY"

Vous voyez quelle clé vous avez utilisée, votre PMS, l’environnement et les scopes :

{
  "credential_id": "5d4e040b-61c1-44a4-a4ca-9a751dc05133",
  "pms_name": "Test PMS",
  "environment": "staging",
  "scopes": [
    "properties:read"
  ]
}

credential_id est l’identifiant propre de votre clé : le vôtre peut donc différer de l’exemple. environment doit indiquer staging, et scopes doit inclure properties:read.

​

3. Listez vos propriétés

curl -s "$TATALLO_BASE_URL/v1/properties" \
  -H "Authorization: Bearer $TATALLO_API_KEY"

Sur le staging, vous obtenez les propriétés fictives connectées à votre PMS, exactement celles-ci :

{
  "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"
    },
    {
      "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"
    },
    {
      "id": "bef2859f-2444-47ec-b5f4-f1e6701f087f",
      "name": "Fixture Apartment Trastevere",
      "timezone": "Europe/Rome",
      "status": "active",
      "country": "Italy",
      "city": "Rome",
      "max_guests": 4,
      "currency": "EUR",
      "updated_at": "2026-10-01T09:00:00.000Z"
    }
  ],
  "page": {
    "next_cursor": null
  }
}

page.next_cursor vaut null : il s’agit donc de la liste complète. S’il y a plus de propriétés que n’en contient une page, suivez le curseur : consultez Découverte des propriétés sur le staging.

​

4. Lisez une propriété

curl -s "$TATALLO_BASE_URL/v1/properties/bef2859f-2444-47ec-b5f4-f1e6701f087f" \
  -H "Authorization: Bearer $TATALLO_API_KEY"

{
  "id": "bef2859f-2444-47ec-b5f4-f1e6701f087f",
  "name": "Fixture Apartment Trastevere",
  "timezone": "Europe/Rome",
  "status": "active",
  "country": "Italy",
  "city": "Rome",
  "max_guests": 4,
  "currency": "EUR",
  "updated_at": "2026-10-01T09:00:00.000Z"
}

Enregistrez l’id de chaque propriété dans votre table de correspondance : il ne change jamais. La signification de chaque champ : Propriétés.

​

Dépannage

Chaque erreur a la même forme, { "error": { "code", "message", "request_id" } }. Branchez votre logique sur code.

​

401 unauthorized

La clé est absente, mal formée, destinée à l’autre environnement, expirée ou révoquée. Vérifiez que TATALLO_API_KEY commence par tat_stg_sk_ lorsque TATALLO_BASE_URL pointe vers le staging, que l’en-tête est exactement Authorization: Bearer <key>, et que rien n’a été tronqué à la copie. Consultez Authentification.

​

403 insufficient_scope

La clé est valide, mais il lui manque properties:read. GET /v1/me affiche ses scopes. Demandez à [e-mail] une clé dotée du scope dont vous avez besoin.

​

404 property_not_found

La propriété n’est pas connectée à votre PMS, ou elle n’existe pas. Tatallo répond de la même façon dans les deux cas, volontairement. Listez d’abord vos propriétés et utilisez leurs id. Consultez pourquoi une propriété non connectée renvoie un 404.

​

429 rate_limited

Plus de 60 requêtes en une minute avec cette clé. Attendez le nombre de secondes indiqué dans l’en-tête Retry-After, puis réessayez.

Lorsque vous écrivez au support, citez l’en-tête X-Request-Id de la réponse en échec.