Inicio rápido

De una clave de staging a una llamada que funciona, en unos minutos.

Necesitas una credencial PMS de staging. Si aún no tienes una, solicita acceso.

​

1. Define dos variables de entorno

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

Todos los ejemplos de esta documentación leen estas dos variables. Para pasar más adelante a producción, cambia TATALLO_BASE_URL a https://api.tatallo.com y usa tu clave de producción.

​

2. Comprueba tu clave

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

Ves qué clave usaste, tu PMS, el entorno y los scopes:

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

credential_id es el ID de tu propia clave, así que el tuyo puede diferir del ejemplo. environment debe indicar staging, y scopes debe incluir properties:read.

​

3. Lista tus propiedades

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

En staging obtienes las propiedades fixture conectadas a tu PMS, exactamente estas:

{
  "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 es null, así que esta es la lista completa. Si hay más propiedades de las que caben en una página, sigue el cursor: consulta Descubrimiento de propiedades en staging.

​

4. Lee una propiedad

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

Guarda el id de cada propiedad en tu tabla de asignación: no cambia nunca. Qué significa cada campo: Propiedades.

​

Resolución de problemas

Todo error tiene la misma forma, { "error": { "code", "message", "request_id" } }. Decide según code.

​

401 unauthorized

La clave falta, está mal formada, es del otro entorno, ha caducado o está revocada. Comprueba que TATALLO_API_KEY empiece por tat_stg_sk_ cuando TATALLO_BASE_URL sea staging, que la cabecera sea exactamente Authorization: Bearer <key> y que no se haya cortado nada al copiarla. Consulta Autenticación.

​

403 insufficient_scope

La clave es válida, pero no tiene properties:read. GET /v1/me muestra sus scopes. Pide a [e-mail] una clave con el scope que necesitas.

​

404 property_not_found

La propiedad no está conectada a tu PMS, o no existe. Tatallo responde igual en ambos casos, a propósito. Lista primero tus propiedades y usa sus id. Consulta por qué una propiedad no conectada es un 404.

​

429 rate_limited

Más de 60 solicitudes en un minuto con esta clave. Espera el número de segundos de la cabecera Retry-After y vuelve a intentarlo.

Cuando escribas a soporte, cita la cabecera X-Request-Id de la respuesta que falla.