Offisy OAuth API BETA

Schnittstelle im Aufbau

Die OAuth API befindet sich aktuell im Aufbau. Es kann auch kurzfristig zu Breaking Changes kommen. Wir empfehlen, die Schnittstelle noch nicht produktiv zu nutzen, und regelmäßig in die Release Notes zu schauen.

Die Offisy API ermöglicht den programmatischen Zugriff auf Unternehmensdaten über OAuth 2.0.

Authentifizierung

Die API verwendet den OAuth 2.0 Client Credentials Grant. Du benötigst eine Client-ID und ein Client-Secret, die du in den Offisy-Einstellungen erstellen kannst. → API-Zugang einrichten

Token anfordern

Endpoint: POST https://my.offisy.at/api/oauth/v2/token

Parameter:

Parameter	Wert
grant_type	client_credentials
client_id	Deine Client-ID
client_secret	Dein Client-Secret

Server

Client-ID

Client-Secret

Token verwenden

Sende den Token als Bearer-Token im Authorization-Header:

Authorization: Bearer {access_token}

Base-URL

Alle API-Endpoints verwenden die Base-URL:

https://my.offisy.at/api/oauth/v2/resource

Bereiche

Bereich	Beschreibung
Terminbuchung	Mitarbeiter, Standorte, Leistungen, Slots, Terminbuchung
Termine	Termine abrufen und verwalten
Kunden	Kunden abrufen, erstellen und bearbeiten
Leistungen	Leistungen abrufen
Leistungszuordnungen	Leistungszuordnungen abrufen
Unternehmen	Unternehmensprofil abrufen
Benutzer	Benutzer abrufen
Standorte	Standorte abrufen
Mandanten	Mandanten abrufen
Abrechnungsleistungen	Abrechnungsleistungen abrufen, erstellen und bearbeiten

Weitere Informationen

• Scopes — Welche Berechtigungen gibt es?
• Fehlerbehandlung — Error Codes und HTTP Status