SwissSalary 365 ist eine etablierte Lohnsoftware für die Schweiz und Liechtenstein und basiert auf der modernen ERP-Lösung von Microsoft Dynamics 365 Business Central. Die SwissSalary 365-App kann über den AppSource-Store von Microsoft heruntergeladen werden. Für erweiterte Funktionen, wie etwa die Integration externer Systeme über REST API-Endpunkte, steht zusätzlich die kostenlose App SwissSalary Cloud Essentials im AppSource zur Verfügung. Diese ergänzt SwissSalary 365 um verschiedene Funktionalitäten, die eine nahtlose Anbindung und Kommunikation mit anderen Anwendungen ermöglichen und ist auf den folgenden Seiten dokumentiert.
Was ist eine REST API?
Eine REST API (Representational State Transfer) ermöglicht den sicheren und standardisierten
Datenaustausch zwischen verschiedenen Systemen über das Internet.
Sie basiert auf dem HTTP-Protokoll und verwendet etablierte Methoden wie GET, POST, PUT und DELETE, um
Daten zu lesen, zu erstellen, zu aktualisieren und zu löschen.
Dank dieser Technologie können Systeme in Echtzeit miteinander kommunizieren.
Alle angebundenen Anwendungen bleiben stets synchron – ohne manuelle Dateiübertragungen, sondern direkt
von Service zu Service, sicher und konform.
Die REST API von SwissSalary 365 ermöglicht eine einfache und effiziente Integration der Funktionen und
Daten der App in andere Systeme.
Sie unterstützt sowohl Lese- als auch Schreibzugriffe und bietet damit die Grundlage für moderne,
nahtlose Systemlandschaften.
REST-basierte Integrationen gelten heute als «State of the Art» und sind ein etablierter Standard in der
Entwicklung zeitgemäßer Softwarelösungen.
Was ist OAuth?
OAuth 2.0 (Open Authorization) ist ein offener Standard, der eine sichere und benutzerfreundliche
Autorisierung ermöglicht – ohne dass Benutzer ihre Passwörter weitergeben müssen.
Stattdessen erhalten Anwendungen nach ausdrücklicher Zustimmung des Nutzers zeitlich begrenzten Zugriff
auf bestimmte Ressourcen.
Mit OAuth 2.0 können Benutzer sicher und komfortabel auf die REST-Integration von SwissSalary 365 zugreifen und ihre Daten verwalten, ohne ihre Anmeldeinformationen direkt preiszugeben. Dieses Verfahren entspricht dem aktuellen Sicherheitsstandard und wird von führenden Anbietern – wie auch Microsoft – weltweit eingesetzt.
Warum sind REST API und OAUTH wichtig?
Die REST API und OAUTH sind entscheidend für die Integration und Sicherheit von SwissSalary 365.
Durch die REST API können Partner und Kunden die Funktionen der App in ihre eigenen Systeme einbinden
und automatisierte Prozesse erstellen.
OAUTH sorgt dafür, dass diese Integrationen sicher sind und die Daten der Benutzer geschützt bleiben.
Gemeinsam ermöglichen diese Technologien eine flexible und sichere Nutzung von SwissSalary 365.
Was ist OData?
OData (Open Data Protocol) ist ein von Microsoft entwickelter offener Standard, der den strukturierten
Zugriff auf Daten über das HTTP-Protokoll ermöglicht.
Basierend auf bewährten Webtechnologien wie HTTP, URI, AtomPub und JSON bietet OData eine einheitliche
Möglichkeit, Daten zu lesen, zu filtern, zu sortieren und zu aktualisieren – ganz ohne komplexe
Programmierung.
In der Welt von Microsoft Dynamics 365 Business Central erlaubt OData den Zugriff auf nahezu alle im
System verfügbaren Daten.
Dabei werden sogenannte Pages (Seitenobjekte) als Datenquelle verwendet.
Sie stellen die Informationen in einer vereinfachten Form bereit, sodass Entwickler auch ohne
detailliertes Wissen über die internen Tabellenstrukturen damit arbeiten können.
Über einfache URLs wie .../ODataV4/Customers
lassen sich beispielsweise Kunden, Artikel oder Buchungsblätter gezielt abfragen und bearbeiten.
Was ist der Unterschied zwischen OData und REST API?
REST APIs haben sich als führender Standard für die Integration moderner Webanwendungen etabliert.
Sie sind flexibel, leicht verständlich und dank ihrer klaren Struktur besonders einfach zu
implementieren.
REST APIs nutzen das HTTP-Protokoll und arbeiten in der Regel mit JSON – einem kompakten, weit
verbreiteten Datenformat.
Im Vergleich zu OData, das auf einem stärker formalen Modell mit festgelegtem Abfragevokabular basiert,
bieten REST APIs deutlich mehr Freiheit in der Gestaltung und Nutzung.
Diese Flexibilität ermöglicht massgeschneiderte Integrationen, die optimal auf individuelle
Anforderungen abgestimmt sind.
Zudem ist die REST-Technologie meist besser dokumentiert und wird von Entwicklern aufgrund ihrer
Einfachheit und Skalierbarkeit bevorzugt.
Für moderne Systemlandschaften, die auf Geschwindigkeit, Sicherheit und Zukunftsfähigkeit setzen, stellt
die REST API eine besonders leistungsfähige Lösung dar.