Documentazione API
WeSeek / TIO

Overview

Le API TIO seguono lo standard REST. Tutte le richieste e risposte usano JSON. Il base URL per tutte le chiamate è:

https://api.weseek.io/v1

Ogni partner riceve credenziali dedicate (client_id e client_secret) per autenticarsi. I dati sono segmentati per origine — ogni partner vede solo i propri dati.

Autenticazione

TIO usa OAuth 2.0 con flusso Client Credentials. Ottieni un access token usando le credenziali fornite al momento dell'onboarding.

{
  "grant_type": "client_credentials",
  "client_id": "your_client_id",
  "client_secret": "your_client_secret"
}

{
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9...",
  "token_type": "Bearer",
  "expires_in": 3600
}

Includi il token in ogni richiesta nell'header Authorization: Bearer {token}.

Disponibilità

Controlla la disponibilità dei prodotti per una data o un range di date. La disponibilità è sincronizzata in real-time con Zucchetti Wellby.

{
  "date": "2026-08-15",
  "facility_id": "saturnia",
  "slots": [
    {
      "time": "09:00",
      "available": true,
      "capacity": 45,
      "products": ["ingresso-parco", "ingresso-club"]
    }
  ]
}

Prenotazioni

Crea, recupera e cancella prenotazioni. Ogni prenotazione genera automaticamente un ordine nel Back Office TIO.

{
  "facility_id": "saturnia",
  "product_id": "ingresso-parco",
  "date": "2026-08-15",
  "time_slot": "09:00",
  "guests": {
    "adults": 2,
    "kids": 1
  }
}

Webhook

TIO invia notifiche in real-time al tuo endpoint per gli eventi principali.

{
  "url": "https://tuosito.it/webhook/tio",
  "events": ["booking.created", "booking.cancelled"]
}

Gestione errori

TIO usa i codici HTTP standard. In caso di errore, il body include sempre un codice leggibile e un messaggio descrittivo.