Piani Pro ed Enterprise

Connetti Squadra ai tuoi strumenti

La nostra API consente di recuperare i tuoi dati (pianificazione, timbrature, dipendenti, ferie) da qualsiasi strumento esterno: Power BI, Metabase, HRIS, script Excel, dashboard interni… senza scrivere codice lato Squadra.

Genera una chiave API Specifica OpenAPI

A cosa serve davvero?

Dashboard Power BI / Metabase

Crea una dashboard BI su ore, costi, assenze.

Export Excel automatico

Script giornaliero che recupera le timbrature e riempie il foglio paghe.

Sync HRIS o CRM

Allinea organico e assenze con il tuo software HR o CRM.

Sola lettura

Nessuna scrittura, i dati non possono essere modificati via API.

Accessi limitati

Ogni chiave ha i suoi permessi. Una chiave per integrazione, più sicuro.

1000 chiamate / ora

Quota generosa, tracciabilità completa, revoca immediata.

Come funziona, in 3 passi

Genera una chiave

Da Admin → Chiavi API, clicca "Nuova chiave". Nome e permessi. La chiave è mostrata UNA SOLA VOLTA, copiala subito.

Genera una chiave API

Inviala in ogni richiesta

Nel tuo strumento, aggiungi la chiave nell'header HTTP "Authorization" formato Bearer.

Authorization: Bearer sqd_live_xxxxxxxxxxxxxxxxxxxx

Chiama una URL

Chiama la URL del dato desiderato. Ricevi JSON pulito, pronto all'uso.

curl https://www.squadraplanning.com/api/v1/employees \
  -H "Authorization: Bearer sqd_live_..."

Cosa puoi recuperare?

Elenco dei dati disponibili. Ogni URL inizia con https://www.squadraplanning.com/api

GET/v1/organization

Nome e piano della tua organizzazione

organization.read

GET/v1/employees

Dipendenti con ruolo, contratto, tariffa oraria

employees.read

GET/v1/locations

I tuoi negozi, indirizzo, GPS

locations.read

GET/v1/shifts

Turni pianificati in un intervallo di date

shifts.read

GET/v1/timesheets

Timbrature reali (entrata, uscita, anomalie)

timesheets.read

GET/v1/leave-requests

Richieste ferie (stato, date, tipo)

leave_requests.read

Filtra i risultati

Tutti gli endpoint lista accettano filtri via URL:

limit

Numero risultati (max 200, default 50)

offset

Salta i primi N (paginazione)

from

Data di inizio (ISO)

to

Data di fine (ISO)

user_id

Limita a un dipendente

location_id

Limita a un negozio

Esempio completo

Recuperare tutte le timbrature di Lucile per aprile:

curl "https://www.squadraplanning.com/api/v1/timesheets?user_id=LUCILE_ID&from=2026-04-01&to=2026-04-30" \
  -H "Authorization: Bearer sqd_live_xxxxxxxxxxxx"

# Response
{
  "data": [
    {
      "id": "a1b2c3...",
      "user_id": "LUCILE_ID",
      "check_in":  "2026-04-15T09:03:00Z",
      "check_out": "2026-04-15T17:58:00Z",
      "break_duration": 45,
      "status": "VALIDATED",
      "is_late": false
    }
  ]
}

Se non funziona

401Chiave mancante, non valida, revocata o scaduta

402API richiede piano Pro o Enterprise

403La tua chiave non ha il permesso per questo endpoint

429Troppe chiamate (max 1000/ora)

500Problema nostro, contatta il supporto

Pronto?

30 secondi per generare una chiave e testare.

Apri il mio spazio API

Serve aiuto?Il nostro team ti affianca nella prima integrazione.