Willkommen im Blink Entwicklerportal
Die Informationen in diesem Bereich sollen euch helfen, eine externe Anwendung mit den Blink APIs zu verbinden.
Für wen ist diese Anleitung gedacht?
Diese Dokumentation richtet sich an erfahrene Softwareentwickler, die bereits Schnittstellen zu anderen Anwendungen entwickelt haben und mit den grundlegenden Techniken und Protokollen vertraut sind.
Welche Technologien und Protokolle werden verwendet?
Die Blink System-APIs werden über HTTPS bereitgestellt und sind öffentlich zugänglich. Die Kommunikation erfolgt über REST API. Viele, aber nicht alle, APIs unterstützen das Auswählen, Filtern oder Erweitern des Abfrageergebnisses über OData-Abfragen. Anfragen müssen im JSON-Format gesendet werden und die API liefert das Ergebnis ebenfalls im JSON-Format.
Für die Kommunikation mit den APIs ist ein Authentifizierungstoken erforderlich. Es gibt REST-Endpunkte, um ein Authentifizierungstoken mit Benutzername und Passwort anzufordern und um ein abgelaufenes Token zu erneuern. Der Authentifizierungsprozess basiert auf dem OAuth 2.0 Verfahren. Die Tokens entsprechen dem JWT-Standard.
Wie ist eine Blink-Umgebung aufgebaut?
Ein Blink-System besteht aus der Blink Core API, die alle APIs für die Grundfunktionalität des Blink-Systems bereitstellt. Darüber hinaus stehen verschiedene Blink-Dienste zur Verfügung, die APIs für spezifische Anwendungsbereiche oder Modulfunktionalitäten bereitstellen.
Die folgenden Blink-Dienste sind derzeit verfügbar. Ersetzt [SYSTEM] jeweils durch den Namen eures Blink-Systems.
Blink Core API (Mitarbeiter, Objekte, Planungen, Zeiterfassung)
Die Core API stellt sowohl OData- als auch REST-Endpunkte in mehreren Versionen bereit.
Basis-URL: https://[SYSTEM]-api.blink.online
Blink Active Service (Tickets)
Basis-URL: https://[SYSTEM]-active-service.blink.online
Blink Automation Service (Workflows, Schnittstellen, Webhooks)
Basis-URL: https://[SYSTEM]-automation-service.blink.online
Blink BaseData Service (Stammdaten)
Basis-URL: https://[SYSTEM]-basedata-service.blink.online
Blink Check Service (Formulare)
Basis-URL: https://[SYSTEM]-check-service.blink.online
Blink eLearning Service (eLearning-Schnittstellen)
Basis-URL: https://[SYSTEM]-elearning-service.blink.online
Blink File Service (Dokumentenverwaltung)
Basis-URL: https://[SYSTEM]-file-service.blink.online
Blink Insight Service (Kundenportal)
Basis-URL: https://[SYSTEM]-insight-service.blink.online
Blink Invoicing Service (Abrechnung)
Basis-URL: https://[SYSTEM]-invoicing-service.blink.online
Blink ToolSense Service (ToolSense-Schnittstelle)
Basis-URL: https://[SYSTEM]-toolsense-service.blink.online
Blink WorkOrder Service (Aufträge)
Basis-URL: https://[SYSTEM]-workorder-service.blink.online