Pro und Enterprise

Verbinden Sie Squadra mit Ihren Tools

Unsere API ermöglicht den Zugriff auf Ihre Daten (Planung, Zeiterfassung, Mitarbeiter, Urlaube) aus jedem externen Tool: Power BI, Metabase, HRIS, Excel-Skripte, interne Dashboards – ohne Code auf Squadra-Seite.

API-Schlüssel erstellen OpenAPI-Spezifikation

Wofür?

Power BI / Metabase-Dashboard

BI-Dashboard zu Arbeitszeiten, Kosten, Abwesenheiten.

Automatischer Excel-Export

Tägliches Skript, das Zeiterfassungen abruft und Ihre Payroll-Datei füllt.

HRIS- oder CRM-Sync

Personalstand und Abwesenheiten mit HR-Software oder CRM abgleichen.

Nur lesen

Keine Schreibrechte, Daten können über die API nicht verändert werden.

Begrenzte Zugriffe

Jeder Schlüssel hat seine Berechtigungen. Ein Schlüssel pro Integration.

1000 Aufrufe / Stunde

Großzügiges Kontingent, volle Nachverfolgbarkeit, sofortiger Widerruf.

So funktioniert's, in 3 Schritten

API-Schlüssel generieren

Admin → API-Schlüssel, Klick auf "Neuer Schlüssel". Name und Berechtigungen wählen. Der Schlüssel wird NUR EINMAL angezeigt – sofort kopieren.

API-Schlüssel erstellen

Mit jeder Anfrage senden

In Ihrem Tool: Schlüssel im HTTP-Header "Authorization" als Bearer senden.

Authorization: Bearer sqd_live_xxxxxxxxxxxxxxxxxxxx

URL aufrufen

URL der gewünschten Daten aufrufen. Sie erhalten sauberes JSON, sofort nutzbar.

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

Was kann abgerufen werden?

Liste der verfügbaren Daten. Jede URL beginnt mit https://www.squadraplanning.com/api

GET/v1/organization

Name und Plan Ihrer Organisation

organization.read

GET/v1/employees

Mitarbeiter mit Rolle, Vertrag, Stundensatz

employees.read

GET/v1/locations

Ihre Filialen, Adresse, GPS

locations.read

GET/v1/shifts

Geplante Schichten in einem Zeitraum

shifts.read

GET/v1/timesheets

Tatsächliche Zeiterfassungen (Start, Ende, Anomalien)

timesheets.read

GET/v1/leave-requests

Urlaubsanträge (Status, Datum, Typ)

leave_requests.read

Ergebnisse filtern

Alle Listen-Endpoints akzeptieren URL-Filter:

limit

Anzahl der Ergebnisse (max 200, Standard 50)

offset

Erste N überspringen (Paginierung)

from

Startdatum (ISO)

to

Enddatum (ISO)

user_id

Auf einen Mitarbeiter beschränken

location_id

Auf eine Filiale beschränken

Vollständiges Beispiel

Alle Zeiterfassungen von Lucile für April abrufen:

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

Fehlerbehebung

401Schlüssel fehlt, ungültig, widerrufen oder abgelaufen

402API benötigt Pro- oder Enterprise-Plan

403Ihr Schlüssel hat keine Berechtigung für diesen Endpoint

429Zu viele Aufrufe (max 1000/Stunde)

500Unser Problem, Support kontaktieren

Bereit?

30 Sekunden, um einen Schlüssel zu erstellen.

Mein API-Bereich öffnen

Hilfe nötig?Unser Team unterstützt Sie bei der ersten Integration.