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 |
Token verwenden
Sende den Token als Bearer-Token im Authorization-Header:
Authorization: Bearer {access_token}Der Token wird ausschließlich im Header akzeptiert. Anfragen mit dem Token als Query-Parameter oder Body-Feld werden abgewiesen.
Base-URL
Alle API-Endpoints verwenden die Base-URL:
https://my.offisy.at/api/oauth/v2/resourceBereiche
| Bereich | Beschreibung |
|---|---|
| Terminbuchung | Mitarbeiter, Standorte, Leistungen, Slots, Terminbuchung |
| Standorte | Standorte abrufen |
| Benutzer | Benutzer abrufen |
| Leistungen | Leistungen abrufen |
| Leistungszuordnungen | Leistungszuordnungen abrufen |
| Termine | Termine abrufen und verwalten |
| Kunden | Kunden abrufen, erstellen und bearbeiten |
| Notizen | Notizen abrufen und erstellen |
| Abrechnungsleistungen | Abrechnungsleistungen abrufen, erstellen und bearbeiten |
| Diagnosen | Diagnosen abrufen und erstellen |
| Dateien | Dateien abrufen, herunterladen und hochladen |
| Anamnesen | Anamnesen abrufen und erstellen |
| Messwerte | Messwerte abrufen und erstellen |
| Dauermedikationen | Dauermedikationen abrufen und erstellen |
| Sportbefreiungen | Sportbefreiungen abrufen und erstellen |
| Überweisungen | Überweisungen abrufen und erstellen |
| Verordnungen | Verordnungen abrufen und erstellen |
| Arztbesuchsbestätigungen | Arztbesuchsbestätigungen abrufen und erstellen |
| Eingehende Überweisungen | Eingehende Überweisungen abrufen und erstellen |
| Arztbriefe | Arztbriefe abrufen und erstellen |
| Patientenbriefe | Patientenbriefe abrufen und erstellen |
| Transportscheine | Transportscheine abrufen und erstellen |
| Laborbefunde | Laborbefunde abrufen und erstellen |
| Arbeitsunfähigkeiten | Arbeitsunfähigkeiten abrufen und erstellen |
| Gesundmeldungen | Gesundmeldungen abrufen und erstellen |
| Rechnungen | Rechnungen abrufen |
| Bareinnahmen | Bareinnahmen abrufen |
| Honorarnoten | Honorarnoten abrufen |
| Mandanten | Mandanten abrufen |
| Unternehmen | Unternehmensprofil abrufen |
Weitere Informationen
- Scopes – Welche Berechtigungen gibt es?
- Rate Limits – Lizenzstufen, Limits und Header
- Fehlerbehandlung – Error Codes und HTTP Status
- Inkrementeller Abgleich – Zeitstempel-Filter, Cursor-Strategie und Restrisiken