- KYBERNA AI
-
ITSM & ESM Software
- ITSM & ESM Software ky2help®
- Lösung nach Branchen
- Bauunternehmen & Baugewerbe
- Finanzdienstleistungen & Banken
- Gesundheitswesen & Kliniken
- Hospitality & Hotelgruppen
- Industrie & Fertigung
- IT-Dienstleister, MSPs & Systemhäuser
- Öffentliche Verwaltung & Behörden
- Sicherheitsdienste & Leitstellen
- Telekommunikation & Netzbetreiber
- Versicherungen & Sozialversicherungen
- ky2help® Referenzen
- Kontakt
- ITSM & ESM Wissenswelt
- Glossar
- IT Services
- eAuktion
- Über uns
- News & Blog
- Support

Glossar
Fachbegriffe einfach erklärt
API einfach erklärt: wie Programme im IT-Alltag Daten austauschen
Eine API (Application Programming Interface) ist eine vereinbarte Schnittstelle, über die ein Programm einem anderen Daten oder Funktionen zur Verfügung stellt. Das aufrufende Programm muss nur wissen, wie es fragt und was zurückkommt, nicht wie das andere intern arbeitet.
Ein Vergleich: Wer beim Großhändler bestellt, füllt ein Formular mit Artikelnummer und Menge aus. Wie das Lager organisiert ist, muss er nicht wissen. Eine API ist dieses Bestellformular für Software. Für kleine IT-Teams sind APIs vor allem deshalb wichtig, weil fast jeder Cloud-Dienst über sie angebunden wird, von Microsoft 365 bis zum Monitoring des IT-Dienstleisters. Wer die Anbindungen kennt und sauber einrichtet, spart sich viel händisches Übertragen zwischen Programmen.
Das Wichtigste in Kürze
- Im Alltag: Fast jede Synchronisierung zwischen zwei Programmen läuft über eine API, etwa wenn ein Tool Benutzer, Postfächer oder Teams-Kanäle aus Microsoft 365 ausliest.
- Ohne Programmierung: Viele Anbindungen richtet man über fertige Konnektoren oder Einstellungen ein. Entwickeln muss man erst, wenn es keinen passenden Baustein gibt.
- Eigene Zugänge: Jede Anbindung bekommt eine eigene Identität mit möglichst wenigen Rechten. Microsoft empfiehlt Zertifikate oder verwaltete Identitäten statt geheimer Schlüssel.
- Überblick: Eine einfache Liste aller Anbindungen mit Zuständigen und Ablaufdaten verhindert, dass ein abgelaufenes Zertifikat eine Synchronisierung unbemerkt stoppt.
Stand: November 2026 · Abgeglichen mit Microsoft Learn (Microsoft Graph, Microsoft Entra ID), der OWASP API Security Top 10 und den Spezifikationen zu OpenAPI, GraphQL und gRPC (Quellen am Ende des Artikels)
Wo Ihnen APIs im IT-Alltag begegnen
Auch wer nie eine Zeile Code schreibt, arbeitet ständig mit APIs. Drei Ebenen lassen sich unterscheiden.
1. Im Programm selbst
Programme bestehen aus fertigen Bausteinen, den Bibliotheken. Deren Funktionen ruft das Programm über Bibliotheks-APIs auf. Dabei verlassen keine Daten das Gerät.
2. Zwischen Programm und Betriebssystem
Speichert eine Anwendung eine Datei, druckt sie oder öffnet sie eine Netzwerkverbindung, nutzt sie die API des Betriebssystems, unter Windows die Windows-API (Win32). Ändert sich eine solche Funktion mit einem Update, kann das ältere Fachprogramme beeinträchtigen. Deshalb lohnt es sich, Updates zuerst auf einem Testgerät auszurollen.
3. Zwischen Anwendungen über das Netz
Das sind die Web-APIs, um die es in den meisten Gesprächen mit Dienstleistern geht. Ein Beispiel ist Microsoft Graph: Über einen einzigen Endpunkt, graph.microsoft.com, erreichen berechtigte Anwendungen Daten aus Microsoft 365, Windows und Enterprise Mobility + Security. Backup-Lösungen, Telefonanlagen oder Ticketsysteme greifen so auf Benutzer, Postfächer oder Kalender zu.
Dazu kommt die Frage, wer zugreifen darf. Interne APIs nutzt nur das eigene Unternehmen, auch wenn sie in der Cloud laufen. Partner-APIs öffnet ein Anbieter nur für ausgewählte Firmen, zum Beispiel für den IT-Dienstleister. Öffentliche APIs stehen allen registrierten Entwicklern offen.
API-Typen erkennen: was in Dokumentationen steht
In Handbüchern, Ausschreibungen und Angeboten von Dienstleistern tauchen immer wieder dieselben Begriffe auf. Diese Übersicht hilft beim Einordnen:
| Woran Sie es erkennen | Wo es Ihnen begegnet |
|---|---|
| REST | |
| Eigene Adressen je Datenart, Antworten in JSON | Microsoft Graph und die meisten Cloud-Dienste |
| SOAP | |
| XML-Nachrichten und eine WSDL-Datei | Ältere Fach- und ERP-Programme |
| GraphQL | |
| Ein Endpunkt, Abfragen mit Feldliste | Zum Beispiel die GraphQL-API von GitHub |
| gRPC | |
| Binäre Daten, Dateien mit Endung .proto | Zwischen internen Diensten, selten in der Administration |
| Webhook | |
| Sie tragen eine Ziel-Adresse im Dienst ein | Alarme, Formulare, Statusmeldungen |
Mit REST arbeiten die meisten modernen Dienste. Wie Adressen, Methoden und Statuscodes zusammenspielen, zeigt der Artikel REST API. Bei Webhooks ist die Richtung umgekehrt: Der Dienst meldet sich, statt gefragt zu werden. Mehr dazu im Artikel Webhook. GraphQL ist eine Abfragesprache, bei der das aufrufende Programm genau die Felder anfordert, die es braucht. gRPC verwendet standardmäßig Protocol Buffers und kommt vor allem zwischen Diensten innerhalb einer Anwendung zum Einsatz.
Was eine brauchbare API-Dokumentation enthält
- eine Beschreibung im Format OpenAPI (bei REST-artigen Schnittstellen) oder ein Schema (bei GraphQL),
- die Art der Anmeldung und die nötigen Berechtigungen,
- Grenzen für die Zahl der Aufrufe und was passiert, wenn man sie überschreitet,
- wie lange eine alte Version noch unterstützt wird.
Fehlt einer dieser Punkte, lohnt eine Nachfrage beim Anbieter, bevor die Anbindung in Betrieb geht. Microsoft Graph etwa schränkt Anwendungen, die zu viele Anfragen senden, für einige Zeit ein und schickt mit der Fehlermeldung eine empfohlene Wartezeit mit. Ein Tool, das diese Wartezeit nicht beachtet, wird weiter abgewiesen, und die Synchronisierung bleibt unvollständig.
Fünf typische Anbindungen im IT-Alltag
Angenommen, ein Handelsbetrieb mit 180 Beschäftigten hat Filialen in Linz, Graz und Wels, eine IT-Abteilung mit zwei Personen und einen externen Dienstleister für Netzwerk und Server. In so einem Umfeld kommen diese Anbindungen häufig vor:
- Benutzer aus dem Verzeichnis: Das Ticketsystem übernimmt Name, Abteilung und Standort aus Active Directory oder Microsoft Entra ID. Neue Kolleginnen und Kollegen können sich so ab dem ersten Tag im Self-Service-Portal melden.
- E-Mail und Teams: Anfragen aus dem Support-Postfach oder einem Teams-Kanal werden zu Tickets, Antworten gehen auf demselben Weg zurück.
- Telefon: Bei einem Anruf zeigt die CTI-Anbindung, wer anruft und welche Tickets offen sind.
- Inventar: Ein Inventarisierungs-Tool meldet Geräte und installierte Software. Bei einer Störung in der Filiale Wels ist damit gleich klar, welcher Laptop betroffen ist.
- Dienstleister: Tickets für Netzwerk oder Server gehen an das System des Dienstleisters, der Status kommt zurück. Niemand muss per E-Mail nachfragen.
Durchgespielt: ein Eintritt in der Filiale Graz
Bleiben wir beim angenommenen Handelsbetrieb. Eine neue Verkäuferin beginnt am Montag in Graz. Die Personalabteilung legt sie am Freitag im Verzeichnis an. Über die Verzeichnisanbindung kennt das Ticketsystem sie damit bereits, inklusive Filiale und Abteilung. Ihr Service Request für Kassenzugang und Laptop landet automatisch beim richtigen Team. Das Inventar zeigt, welches Gerät für Graz noch frei ist, und den Netzwerkzugang richtet der Dienstleister über ein weitergeleitetes Ticket ein. Keiner dieser Schritte braucht eigene Programmierung, aber jeder hängt an einer Anbindung, die jemand eingerichtet hat und betreut.
Wer kümmert sich, wenn eine Anbindung hakt?
Mit dem Dienstleister sollte schriftlich geregelt sein, wer welche Anbindung einrichtet, überwacht und bei Störungen repariert, und in welcher Zeit. Verarbeitet der Dienstleister dabei personenbezogene Daten in Ihrem Auftrag, braucht es nach Art. 28 DSGVO einen Auftragsverarbeitungsvertrag. Ein allgemeiner Satz wie „Schnittstellen nach Aufwand“ im Wartungsvertrag klärt keine Zuständigkeit.
Checkliste: APIs sicher betreiben, auch mit kleinem Team
Die OWASP API Security Top 10 beschreiben die wichtigsten Risiken von APIs. Für Teams, die Schnittstellen vor allem nutzen und nicht selbst entwickeln, lassen sich daraus acht Punkte ableiten:
- Eine Identität je Anbindung: Kein gemeinsames Admin-Konto für mehrere Tools. So lässt sich eine Anbindung sperren, ohne die anderen zu stören.
- Rechte knapp halten: In Microsoft 365 gilt: delegierte Berechtigungen, wo sie ausreichen. Anwendungsberechtigungen wirken ohne angemeldeten Benutzer, Microsoft stuft sie als hoch privilegiert ein.
- Zertifikate statt Kennwörter: Für App-Registrierungen in Entra ID empfiehlt Microsoft verwaltete Identitäten oder Zertifikate und rät von geheimen Clientschlüsseln ab.
- Ablaufdaten im Kalender: Zertifikate und Schlüssel laufen ab. Eine Erinnerung einige Wochen vorher erspart den Montag, an dem die Synchronisierung steht.
- Liste aller Anbindungen: was verbunden ist, wer zuständig ist, welche Rechte vergeben sind. Vergessene Schnittstellen führt OWASP als eigenes Risiko (API9:2023).
- Zugänge von Dienstleistern befristen: Projektzugänge nach Abschluss entziehen, dauerhafte Anbindungen einmal im Jahr prüfen.
- Anmeldungen anschauen: Die Anmeldeprotokolle von Entra ID enthalten auch die Anmeldungen von Anwendungen. Ungewöhnliche Uhrzeiten oder Herkunftsländer fallen dort auf.
- Fremden Daten nicht blind vertrauen: Auch Antworten externer APIs können fehlerhaft oder manipuliert sein. OWASP nennt die ungeprüfte Übernahme als Risiko (API10:2023).
Wer dafür Unterstützung von außen sucht, findet bei KYBERNA Cybersecurity Services und Leistungen rund um Microsoft 365.
Häufige Fragen aus der Praxis
Was ist eine API einfach erklärt?
Eine API ist eine vereinbarte Schnittstelle, über die ein Programm Daten oder Funktionen eines anderen Programms nutzt. Man kann sie sich wie ein Bestellformular vorstellen: Wer die Felder richtig ausfüllt, bekommt eine Antwort, ohne zu wissen, wie das andere System intern arbeitet.
Muss ich programmieren können, um eine API zu nutzen?
Meist nicht. Viele Anbindungen richtet man über fertige Konnektoren oder Einstellungen im jeweiligen Programm ein. Programmierkenntnisse braucht es erst, wenn kein passender Baustein existiert und eine eigene Integration entwickelt werden muss.
Welche API-Arten gibt es?
Grob drei: Bibliotheks-APIs innerhalb eines Programms, Betriebssystem-APIs wie die Windows-API und Web-APIs, die über das Netz erreichbar sind. Bei Web-APIs begegnet einem vor allem REST, seltener SOAP, GraphQL oder gRPC, dazu Webhooks für Benachrichtigungen.
Was ist ein API-Schlüssel?
Ein API-Schlüssel ist eine Zeichenfolge, mit der sich eine Anwendung bei einer API ausweist. Er identifiziert meist nur die Anwendung, nicht einen Benutzer. Schlüssel sind wie Kennwörter zu behandeln: nicht per E-Mail weitergeben, nicht in Skripte schreiben und bei Verdacht sofort tauschen.
Wer ist zuständig, wenn eine Schnittstelle zum Dienstleister ausfällt?
Das sollte vorab im Vertrag oder in einem Service Level Agreement mit dem Dienstleister geregelt sein: wer die Anbindung überwacht, wer sie repariert und in welcher Zeit. Fehlt diese Regelung, bleibt eine Störung oft liegen, bis ein Fachbereich sie bemerkt.
Welche Schnittstellen zu Microsoft 365 hat ky2help®?
Im Standard bindet ky2help® Azure AD (heute Microsoft Entra ID) inklusive Single Sign-on, E-Mail (ein- und ausgehend) und MS Teams an, dazu Active Directory. Weitere Standardschnittstellen gibt es unter anderem zu Telefonanlagen (CTI), Jira, ServiceNow, LOGINventory und Baramundi.
Quellen und weiterführende Artikel
Quellen
- Microsoft Learn: Übersicht über Microsoft Graph
- Microsoft Learn: Übersicht über Microsoft Graph-Berechtigungen
- Microsoft Learn: Microsoft Graph-Drosselungsleitfaden
- Microsoft Learn: Bewährte Sicherheitsmethoden für App-Registrierungen
- Microsoft Learn: Anmeldeprotokolle in Microsoft Entra ID
- Microsoft Learn: Windows-API-Index
- OWASP: API Security Top 10 – 2023
- OpenAPI Initiative: OpenAPI Specification
- GraphQL Foundation: Introduction to GraphQL
- gRPC: Introduction to gRPC
- EUR-Lex: Datenschutz-Grundverordnung (EU) 2016/679
Weiterlesen im Glossar und auf kyberna.at
Alle Glossar-Artikel in der Übersicht
Erfahren Sie, wie Microsofts Verzeichnisdienst Benutzer, Geräte und Rechte zentral verwaltet – sicher & zukunftsfähig für Unternehmen.
Mehr zu Active Directory
Was ist eine API? Erfahren Sie, wie Programmierschnittstellen Anwendungen verbinden, Prozesse automatisieren und Innovation in der digitalen Wirtschaft ermöglichen.
Was ist Authentifizierung? Erfahren Sie, wie Identitäten geprüft, Konten geschützt und moderne Anmeldeverfahren wie Zwei-Faktor-Authentifizierung Ihre Sicherheit erhöhen.
Was ist ein Backlog? Erfahren Sie, wie priorisierte Aufgabenlisten Teams helfen, Projekte agil zu steuern, Prioritäten zu setzen und Fortschritte transparent zu machen.
Erfahren Sie, wie eine Balanced Scorecard Unternehmen hilft, Strategie, Ziele und Kennzahlen zu verbinden und Erfolge messbar zu machen.
Das Change Advisory Board (CAB) berät bei der Bewertung und Freigabe von Changes im IT Service Management. Erfahren Sie, wann ein CAB gebraucht wird und wie ITIL 4 die Freigabe regelt.
Mehr zum CAB
Gesteuerter Change-Prozess mit Risikoanalyse, CAB-Freigaben und Kommunikation, um Ausfallzeiten zu reduzieren und Releasessicher in Produktionsumgebungen zu bringen.
Erfahren Sie, wie KI-gestützte Chatbots Kommunikation automatisieren, Kundenservice verbessern und Prozesse effizienter gestalten.
Was ist Continuous Integration? Erfahren Sie, wie automatisierte Builds und Tests Entwicklungsprozesse beschleunigen, Fehler vermeiden und Softwarequalität steigern.
Zentrale Konfigurationsdatenbank mit CIs und Beziehungen für Transparenz, Abhängigkeits-/Impact-Analysen, Audit-Sicherheit und Change-/Incident-Beschleunigung.
Was ist CSI? Erfahren Sie, wie Continual Service Improvement in ITIL hilft, IT-Services dauerhaft zu optimieren, Qualität zu steigern und Kundenzufriedenheit zu sichern.
Der Customer Effort Score ist eine Kennzahl, die beschreibt, wie viel Aufwand ein Kunde betreiben muss, um sein Anliegen mit einem Unternehmen zu lösen.
Was ist DevOps? Erfahren Sie, wie Entwicklung und IT-Betrieb durch Automatisierung, Zusammenarbeit und CI/CD zu schnelleren, stabileren Software-Releases führen.
Was ist die DSGVO? Erfahren Sie, wie die Datenschutz-Grundverordnungpersonenbezogene Daten schützt, welche Pflichten Unternehmen haben und welche Rechte Betroffene haben.
Was ist ESM? Erfahren Sie, wie Enterprise Service Management Prozesse vereinheitlicht, Services digitalisiert und alle Abteilungen effizient miteinander verbindet.
Was ist Hardware Asset Management? Erfahren Sie, wie Unternehmen mit HAM ihre IT-Geräte effizient verwalten, Kosten senken und Sicherheit im gesamten Lebenszyklus sichern.
Ein Helpdesk ist die zentrale Schnittstelle zwischen den Anwendern eines Unternehmens und den dafür zuständigen Support-Teams.
Ein Incident ist eine Beeinträchtigung eines IT-Services, die dazu führt, dass der Service nicht wie vorgesehen genutzt werden kann.
Erfahren Sie, wie der internationale Standard Unternehmen hilft, Informationssicherheit systematisch aufzubauen, Risiken zu minimieren und Vertrauen zu schaffen.
Erfahren Sie, wie das Framework IT-Prozesse strukturiert, Qualität sichert und die IT an den Geschäftszielen ausrichtet – praxisnah und modern mit ITIL 4 oder ITIL 5.
IT Service Management (ITSM) beschreibt die Gesamtheit spezialisierter organisatorischer Fähigkeiten, um IT-Services effizient zu betreiben.
Erfahren Sie, wie die japanische Kaizen-Methode durch kleine, stetige Verbesserungen Prozesse optimiert, Qualität steigert und Mitarbeitende einbindet.
Erfahren Sie, wie die Kanban-Methode durch Visualisierung, Flusssteuerung und kleine Verbesserungen Teams effizienter und flexibler arbeiten lässt.
Key Performance Indicators (KPIs) machen Ziele messbar, bewerten Leistung und unterstützen datenbasierte Entscheidungen im Unternehmen.
Erfahren Sie, wie KI funktioniert, wo sie eingesetzt wird und warum sie unsere Arbeitswelt verändert – zwischen Innovation und Verantwortung.
Machine Learning ist ein Teilgebiet der Künstlichen Intelligenz (KI). Es ermöglicht Systemen, Muster und Zusammenhänge in Daten eigenständig zu erkennen.
Erfahren Sie, wie Multi-Faktor-Authentifizierung funktioniert, warum sie Konten wirksam schützt und welche Methoden besonders sicher und benutzerfreundlich sind.
Erfahren Sie, wie die systematische Überwachung von IT-Systemen Leistung, Sicherheit und Verfügbarkeit verbessert – für stabile und effiziente Prozesse.
Erfahren Sie, wie Natural Language Processing funktioniert, wo es eingesetzt wird und warum es Kommunikation, Analyse und Serviceprozesse revolutioniert.
Der Net Promoter Score (NPS) gehört zu den bekanntesten Kennzahlen zur Messung von Kundenzufriedenheit und -loyalität im Umfeld von IT-Ticket-Systemen.
Der Net Promoter Score (NPS) gehört zu den bekanntesten Kennzahlen zur Messung von Kundenzufriedenheit und -loyalität im Umfeld von IT-Ticket-Systemen.
Operational Level Agreements (OLA) regelt interne Zusammenarbeit, unterstützt SLA-Ziele unterstützen und macht Serviceprozesse verlässlicher.
Operational Performance Indicator (OPI) sind ein zentrales Instrument, um die Leistungsfähigkeit operativer Prozesse in Unternehmen messbar zu machen.
Predictive Maintenance ist ein moderner Instandhaltungsansatz, der nicht auf starre Intervalle setzt, sondern auf datenbasierte Vorhersagen.
Die Root Cause Analysis (RCA) ist eine strukturierte Methode, um Ursachen eines Problems oder einer Störung zu identifizieren und zu beseitigen.
Was ist eine REST API? Erfahren Sie, wie REST-Schnittstellen Systeme verbinden, Daten austauschen und moderne Anwendungen schnell, flexibel und skalierbar machen.
Was ist eine Root Cause Analysis? Lernen Sie Methoden wie 5 Why, Ishikawa und Fehlerbaum kennen und erfahren Sie, welche Methode zu welcher Störung passt.
Was ist Scrum? Erfahren Sie, wie das agile Framework Teams hilft, flexibel zu arbeiten, schneller Ergebnisse zu liefern und Projekte kontinuierlich zu verbessern.
Verständlich erklärt: Wie Service Level Agreements Leistungen definieren, Qualität messbar machen und Servicebeziehungen strukturieren.
Was ist SSO? Erfahren Sie, wie Single Sign-On funktioniert, wie es Sicherheit und Komfort verbindet und warum es in modernen IT-Landschaften unverzichtbar ist.
Erfahren Sie, wie das Software Asset Management (SAM) Softwarebestände transparent macht, Kosten optimiert und Compliance sowie IT-Sicherheit stärkt.
Kompakt erklärt: Wie Sprints Teams helfen, in kurzen Zyklen zu planen, zu liefern und sich kontinuierlich zu verbessern.
Was ist eine SOP? Erfahren Sie, wie Standard Operating Procedures Abläufe standardisieren, Qualität sichern und Organisationen zuverlässiger machen.
Erfahren Sie, wie User Experience entsteht, warum sie entscheidend für Erfolg und Zufriedenheit ist und wie gute Nutzererlebnisse gestaltet werden.
Webhooks ermöglichen es, Ereignisse aus einem System in Echtzeit an ein anderes zu übermitteln, ohne dass ständige Abfragen erforderlich sind.
Was ist ein Workflow? Erfahren Sie, wie strukturierte Abläufe Prozesse vereinfachen, Qualität sichern und Unternehmen effizienter machen.