API Literacy - Schnittstellen sinnvoll einsetzen - aiMOOC

Einleitung

API Literacy bedeutet, APIs zu verstehen, gezielt zu nutzen, kritisch zu bewerten und verantwortungsvoll in Bildung, Kultur, Wirtschaft, Verwaltung und KI einzusetzen. Eine API ist eine Schnittstelle, über die Software, Datenbanken, Webdienste, Apps, KI-Agenten oder Geräte miteinander kommunizieren können. Wenn Du eine Wetter-App öffnest, einen Routenplaner nutzt, eine Lernplattform mit einem Kalender verbindest oder offene Verwaltungsdaten auswertest, arbeiten im Hintergrund oft mehrere Schnittstellen zusammen.

Das Thema ist besonders wichtig, weil Daten und digitale Infrastrukturen heute zentrale Grundlagen von Lernen, Forschung, öffentlicher Verwaltung, Kulturarbeit, Medienproduktion und Geschäftsmodellen sind. Wer APIs sinnvoll einsetzen kann, versteht nicht nur technische Befehle, sondern auch Fragen nach Datenschutz, IT-Sicherheit, Interoperabilität, digitaler Souveränität, Datenräumen, Open Data, Lizenzen, Dokumentation und gesellschaftlicher Verantwortung.

Das folgende Video bildet den Ausgangspunkt dieses aiMOOCs. Es behandelt APIs als Schnittstellen für Bildung, Kultur und Wirtschaft in Deutschland und ordnet sie in größere Fragen von digitaler Souveränität, Datenräumen, KI-Agenten und Zukunftsinfrastruktur ein.

{{#ev:youtube| https://www.youtube.com/watch?v=hWo5AwCktcM |500|center}}

Was bedeutet API Literacy?

API Literacy ist eine Form von digitaler Kompetenz. Sie umfasst die Fähigkeit, Programmierschnittstellen zu erkennen, zu lesen, zu testen, einzuschätzen und für ein sinnvolles Ziel einzusetzen. Dabei geht es nicht darum, jede Person sofort zur professionellen Softwareentwicklerin oder zum professionellen Softwareentwickler zu machen. Entscheidend ist, dass Du verstehst, wie Datenflüsse entstehen, welche Regeln dabei gelten und welche Folgen eine technische Verbindung haben kann.

Eine Person mit API Literacy kann zum Beispiel erkennen, ob eine API offen dokumentiert ist, welche Datenformate verwendet werden, ob personenbezogene Daten betroffen sind, welche Authentifizierung notwendig ist, ob Nutzungsgrenzen bestehen und ob die Verbindung langfristig wartbar ist. Diese Fähigkeiten sind für Schule, Ausbildung, Studium, Journalismus, Kulturvermittlung, Verwaltung, Unternehmen und Zivilgesellschaft relevant.

Leitfrage

Wie kannst Du APIs so einsetzen, dass sie Daten sinnvoll nutzbar machen, ohne Sicherheit, Datenschutz, Qualität, Fairness und digitale Souveränität zu gefährden?

Lernziele

Grundverständnis: Du erklärst, was eine API, ein Endpunkt, ein Request, eine Response, ein Token und ein Datenformat sind.
Lesekompetenz: Du entnimmst einer API-Dokumentation, welche Funktionen, Parameter, Datenformate und Bedingungen gelten.
Datenbewertung: Du prüfst, ob Daten aktuell, verständlich, rechtlich nutzbar und für Deine Fragestellung geeignet sind.
Sicherheitsbewusstsein: Du erkennst Risiken wie offengelegte API-Keys, zu weit gefasste Rechte, fehlende Fehlerbehandlung oder unkontrollierte Automatisierung.
Souveränität: Du reflektierst, wann APIs Abhängigkeiten verringern oder verstärken.
KI-Agenten: Du verstehst, warum APIs für KI-Agenten als Werkzeuge dienen und warum klare Grenzen, Protokolle und menschliche Kontrolle wichtig sind.
Transfer: Du planst ein eigenes kleines API-Projekt mit Ziel, Datenquelle, Prüfschritten, Datenschutzbewertung und Ergebnisdarstellung.

Grundlagen: Was ist eine API?

Eine Programmierschnittstelle ist ein definierter Zugang zu Funktionen oder Daten eines Softwaresystems. Die API legt fest, wie eine Anfrage gestellt werden muss und wie die Antwort aufgebaut ist. Eine API ist also kein beliebiger Datenzugriff, sondern eine geregelte Kommunikationsform.

Ein einfaches Alltagsbild ist ein Restaurant: Du gehst nicht direkt in die Küche, sondern bestellst über eine Karte. Die Karte sagt Dir, was möglich ist. Die Bedienung nimmt Deine Bestellung entgegen und bringt eine Antwort. Ähnlich funktioniert eine API-Dokumentation: Sie beschreibt, welche Anfragen erlaubt sind, welche Parameter benötigt werden und welche Antwort Du erwarten kannst.

Zentrale Begriffe

Begriff	Bedeutung	Beispiel
API	Geregelte Schnittstelle zwischen Softwaresystemen	Eine Lernplattform ruft Kalenderdaten ab
Endpunkt	Konkrete Adresse oder Funktion einer API	Eine URL für die Suche nach Datensätzen
Request	Anfrage an die API	Eine App fragt aktuelle Wetterdaten ab
Response	Antwort der API	Die API liefert Daten im Format JSON
Parameter	Zusatzangabe, die eine Anfrage genauer macht	Suchwort, Zeitraum, Sprache oder Ort
Header	Metadaten einer Anfrage oder Antwort	Sprache, Datenformat oder Zugriffstoken
Statuscode	Kurze Rückmeldung über Erfolg oder Fehler	200 für Erfolg, 404 für nicht gefunden
Authentifizierung	Prüfung, wer eine Anfrage stellt	Anmeldung mit Schlüssel oder Token
Autorisierung	Prüfung, was eine angemeldete Person oder Anwendung darf	Nur lesen, aber nicht löschen
Rate Limit	Nutzungsgrenze für Anfragen	Maximal 1000 Anfragen pro Stunde

API-Typen im Überblick

Nicht jede API ist eine Web-API. APIs gibt es auf verschiedenen Ebenen eines digitalen Systems.

Bibliotheks-API: Eine Programmbibliothek stellt Funktionen bereit, die in einem Programm verwendet werden können.
Betriebssystem-API: Ein Betriebssystem bietet Schnittstellen für Dateien, Fenster, Geräte oder Netzwerkzugriffe.
Web-API: Ein Dienst im Internet stellt Daten oder Funktionen über Netzwerkprotokolle bereit.
REST-API: Eine verbreitete Form von Web-API, die häufig mit HTTP und Ressourcen arbeitet.
GraphQL: Eine Abfragesprache für APIs, bei der Clients genauer angeben können, welche Daten sie benötigen.
Webhook: Eine Schnittstelle, bei der ein System ein anderes System automatisch informiert, wenn ein Ereignis eintritt.
Event-API: Eine Schnittstelle, die auf Ereignisse, Nachrichten oder Datenströme reagiert.

Request und Response

Eine Web-API arbeitet häufig nach dem Muster Anfrage und Antwort. Ein Client sendet eine Anfrage an einen Server. Der Server prüft die Anfrage und liefert eine Antwort. Diese Antwort kann Daten, eine Fehlermeldung oder eine Bestätigung enthalten.

GET https://www.beispiel.de/api/suche?q=bildung
Accept: application/json
Authorization: Bearer DEIN_TOKEN

Die Antwort kann zum Beispiel im Datenformat JSON erscheinen:

{
  "suchwort": "bildung",
  "treffer": 2,
  "daten": [
    {
      "titel": "Offene Bildungsdaten",
      "lizenz": "CC BY"
    },
    {
      "titel": "Digitale Lernangebote",
      "lizenz": "CC0"
    }
  ]
}

Wichtig ist: Eine API-Antwort ist nicht automatisch wahr, vollständig oder rechtlich frei nutzbar. Du musst prüfen, woher die Daten stammen, wie aktuell sie sind, welche Lizenz gilt, ob Fehler möglich sind und ob sensible Daten betroffen sein können.

HTTP-Methoden

Viele Web-APIs verwenden HTTP. Die Methode beschreibt, welche Art von Handlung ausgeführt werden soll.

Methode	Typische Bedeutung	Beispiel
GET	Daten abrufen	Einen Datensatz suchen
POST	Neue Daten senden oder eine Aktion auslösen	Ein Formular absenden
PUT	Einen Datensatz vollständig ersetzen	Profil vollständig aktualisieren
PATCH	Einen Datensatz teilweise ändern	Nur die E-Mail-Adresse ändern
DELETE	Daten löschen	Einen Eintrag entfernen

Beim sinnvollen Einsatz von APIs ist besonders wichtig, zwischen lesenden und schreibenden Zugriffen zu unterscheiden. Eine Lern-App, die nur freie Metadaten abruft, hat ein anderes Risiko als ein System, das personenbezogene Leistungsdaten verändern kann.

Datenformate: JSON, XML, CSV und RDF

APIs liefern Daten in bestimmten Datenformaten. Diese Formate beeinflussen, wie leicht Daten maschinell verarbeitet, kombiniert und geprüft werden können.

Format	Stärke	Typischer Einsatz
JSON	Kompakt, gut lesbar, in Web-APIs sehr verbreitet	Webdienste, Apps, KI-Werkzeuge
XML	Stark strukturiert, gut für komplexe Dokumente	Verwaltung, ältere Standards, Austauschformate
CSV	Einfach für Tabellen	Datensätze, Tabellenkalkulation, Statistik
RDF	Gut für verknüpfte Daten und semantische Beziehungen	Linked Open Data, Wissensgraphen, Kultur- und Forschungsdaten

Für API Literacy reicht es nicht, ein Format nur technisch zu öffnen. Du solltest auch verstehen, welche Bedeutung die Felder haben. Ein Feld mit dem Namen "date" kann ein Veröffentlichungsdatum, ein Änderungsdatum, ein Ereignisdatum oder ein Abrufdatum sein. Ohne Metadaten kann dasselbe Feld missverstanden werden.

APIs lesen: Die Dokumentation als Landkarte

Eine gute API-Dokumentation ist wie eine Landkarte. Sie beschreibt, wo die Endpunkte liegen, welche Parameter erlaubt sind, welche Antworten zu erwarten sind, welche Fehler auftreten können und welche Regeln gelten. Moderne APIs werden oft mit OpenAPI beschrieben. Eine OpenAPI-Spezifikation kann von Menschen gelesen und von Werkzeugen verarbeitet werden. Daraus lassen sich Dokumentationen, Tests oder Software-Bausteine erzeugen.

Bestandteile einer guten API-Dokumentation

Zweck: Die Dokumentation erklärt, wofür die API gedacht ist und wofür nicht.
Endpunkte: Alle wichtigen Adressen und Funktionen sind beschrieben.
Methoden: Es ist klar, ob Daten gelesen, erstellt, geändert oder gelöscht werden.
Parameter: Pflichtfelder, optionale Felder, Datentypen und Beispiele sind angegeben.
Antworten: Erfolgsantworten und Fehlerantworten sind dokumentiert.
Authentifizierung: Der Zugang über API-Key, OAuth, Token oder andere Verfahren wird erklärt.
Nutzungsgrenzen: Die maximale Zahl an Anfragen und Fair-Use-Regeln sind transparent.
Versionierung: Änderungen an der API werden nachvollziehbar kommuniziert.
Lizenz: Die Rechte zur Datennutzung sind eindeutig.
Support: Kontakt, Statusseite oder Änderungsprotokoll sind vorhanden.

Beispiel: Dokumentation prüfen

Stelle Dir vor, Du möchtest eine API für offene Bildungsdaten verwenden. Bevor Du sie in einem Projekt nutzt, solltest Du mindestens diese Fragen beantworten:

Prüffrage	Warum ist sie wichtig?
Welche Daten liefert die API?	Du musst wissen, ob die Daten zu Deiner Fragestellung passen.
Wer betreibt die API?	Die Quelle beeinflusst Vertrauen, Wartung und Verantwortung.
Welche Lizenz gilt?	Ohne passende Lizenz darfst Du Daten möglicherweise nicht weiterverwenden.
Werden personenbezogene Daten verarbeitet?	Dann sind DSGVO, Zweckbindung und Datensparsamkeit zentral.
Welche Authentifizierung ist nötig?	Zugangsdaten müssen geschützt und Rechte begrenzt werden.
Gibt es eine Versionierung?	Ohne Versionierung kann eine Anwendung plötzlich nicht mehr funktionieren.
Gibt es Nutzungsgrenzen?	Zu viele Anfragen können einen Dienst überlasten oder Kosten verursachen.
Wie werden Fehler gemeldet?	Gute Fehlerbehandlung verhindert falsche Ergebnisse.

APIs sinnvoll einsetzen

Eine Schnittstelle ist nicht schon deshalb sinnvoll, weil sie technisch funktioniert. Sinnvoll ist ein API-Einsatz, wenn Ziel, Datenqualität, Recht, Sicherheit, Aufwand, Nachhaltigkeit und gesellschaftliche Folgen zusammenpassen. API Literacy verbindet deshalb Informatik, Medienbildung, Datenkompetenz, Recht, Ethik und Projektmanagement.

Entscheidungsmatrix für den API-Einsatz

Dimension	Leitfrage	Gute Praxis
Zielklärung	Welches Problem soll gelöst werden?	Erst Bedarf formulieren, dann Schnittstelle auswählen
Datenqualität	Sind Daten korrekt, aktuell und vollständig genug?	Stichproben, Metadaten und Plausibilität prüfen
Datenschutz	Sind personenbezogene oder sensible Daten betroffen?	Datensparsamkeit, Rechtsgrundlage und Schutzmaßnahmen klären
Sicherheit	Können Rechte, Schlüssel oder Systeme missbraucht werden?	Minimale Rechte, sichere Speicherung, Protokollierung nutzen
Interoperabilität	Lassen sich Daten mit anderen Systemen verbinden?	Offene Standards, eindeutige IDs und dokumentierte Formate bevorzugen
Digitale Souveränität	Entstehen problematische Abhängigkeiten?	Portabilität, offene Spezifikationen und Exit-Strategien beachten
Nachhaltigkeit	Ist die Lösung langfristig wartbar?	Versionierung, Monitoring und Verantwortlichkeiten planen
Barrierefreiheit	Können unterschiedliche Menschen und Systeme die Ergebnisse nutzen?	Verständliche Darstellung, offene Formate und zugängliche Oberflächen einsetzen

Häufige Fehler beim API-Einsatz

API-Keys werden öffentlich in Quelltexten, Screenshots oder Lernmaterialien gezeigt.
Datenschutz wird erst nach der technischen Umsetzung geprüft.
Eine API-Antwort wird mit Wahrheit verwechselt, ohne Herkunft und Aktualität zu prüfen.
Fehlercodes werden ignoriert, sodass falsche oder leere Daten weiterverarbeitet werden.
Zu viele Anfragen werden ohne Rücksicht auf Nutzungsgrenzen gesendet.
Eine Anwendung hängt vollständig von einem Anbieter ab, ohne Alternativen oder Exportmöglichkeiten.
Eine KI darf über APIs handeln, ohne ausreichende Begrenzung, Protokollierung oder menschliche Kontrolle.
Eine Schnittstelle wird genutzt, obwohl die Lizenz keine Weiterverwendung erlaubt.
Es wird nur die technische Verbindung getestet, nicht aber die fachliche Bedeutung der Daten.
Begriffe und Datenfelder werden nicht dokumentiert, sodass andere das Projekt nicht nachvollziehen können.

API Literacy in Bildung, Kultur und Wirtschaft

APIs sind keine Spezialtechnik am Rand. Sie verbinden zentrale Bereiche der Gesellschaft. API Literacy hilft Dir, diese Verbindungen zu verstehen und aktiv mitzugestalten.

Bildung

In der Bildung können APIs Lernplattformen, Kalender, Aufgabenverwaltung, OER, Kompetenzraster, Videokonferenzsysteme, Bibliothekskataloge oder Schulverwaltungsdaten miteinander verbinden. Eine sinnvolle API-Nutzung kann Lernprozesse vereinfachen, Materialien auffindbarer machen und Daten für Lernanalysen bereitstellen. Gleichzeitig entstehen Risiken, wenn personenbezogene Daten von Lernenden unklar verarbeitet, an Dritte übertragen oder in geschlossene Plattformen eingeschlossen werden.

Beispiele für sinnvolle Bildungsfragen sind: Welche Lernmaterialien gibt es zu einem Thema? Welche offenen Lizenzen gelten? Welche Daten dürfen überhaupt verarbeitet werden? Können Lernende selbst verstehen, welche Datenflüsse entstehen? Wie bleibt eine Schule handlungsfähig, wenn ein Anbieter seine Bedingungen ändert?

Kultur

In der Kultur ermöglichen APIs den Zugriff auf digitale Sammlungen, Museumsdaten, Bibliothekskataloge, Archivinformationen, Metadaten, Normdaten und Linked Open Data. Dadurch können Ausstellungen, Forschungsprojekte, Bildungsangebote, Apps und digitale Erzählformen entstehen. Besonders wichtig ist hier die Verbindung von Technik und Kontext: Ein digitalisiertes Objekt braucht Herkunftsinformationen, Rechteangaben, Beschreibung, Provenienz und eine verständliche Einordnung.

Ein Kulturprojekt sollte deshalb nicht nur fragen, ob Daten technisch abrufbar sind. Es muss auch fragen, ob die Beschreibung respektvoll, vollständig, historisch korrekt, rechtlich nutzbar und für unterschiedliche Zielgruppen zugänglich ist.

Wirtschaft

In der Wirtschaft verbinden APIs interne und externe Systeme: CRM, ERP, E-Commerce, Zahlungsdienste, Logistik, Produktionsdaten, Kundensupport, Marketing, Analysewerkzeuge oder KI-Anwendungen. APIs können Prozesse automatisieren, neue Geschäftsmodelle ermöglichen und Zusammenarbeit zwischen Unternehmen vereinfachen.

Zugleich steigt die Bedeutung von API Governance. Unternehmen müssen klären, wer Schnittstellen entwickeln, freigeben, überwachen und verändern darf. Eine unkontrollierte API-Landschaft kann Sicherheitslücken, Datenchaos, hohe Kosten und Abhängigkeiten erzeugen. Eine gute API-Strategie achtet auf klare Verträge, stabile Versionen, Sicherheitsregeln, Monitoring, Dokumentation und Exit-Möglichkeiten.

Verwaltung und Open Data

In der Verwaltung ermöglichen APIs maschinenlesbaren Zugang zu offenen Daten, Verwaltungsleistungen und Informationsportalen. Open Data ist besonders wertvoll, wenn Daten nicht nur als Datei heruntergeladen werden können, sondern über Schnittstellen regelmäßig, automatisiert und nachvollziehbar abrufbar sind. In Deutschland spielen Portale wie GovData und dokumentierte Schnittstellen der öffentlichen Hand eine wichtige Rolle für Transparenz, Forschung, Zivilgesellschaft und Innovation.

Ein API-Literacy-Blick fragt hier: Sind Daten wirklich offen? Gibt es eine eindeutige Lizenz? Sind Metadaten verständlich? Wird ein Standard wie DCAT genutzt? Sind Daten aktuell? Werden historische Änderungen dokumentiert? Können Menschen ohne großen technischen Aufwand nachvollziehen, was eine API liefert?

Digitale Souveränität, Datenräume und KI-Agenten

APIs sind ein Baustein digitaler Souveränität. Digitale Souveränität bedeutet nicht, alles selbst zu bauen oder sich von allen anderen Systemen abzuschotten. Gemeint ist die Fähigkeit, digitale Technik selbstbestimmt, sicher, nachvollziehbar und werteorientiert zu nutzen. APIs können Souveränität stärken, wenn sie auf offenen Standards beruhen, gut dokumentiert sind, Datenportabilität ermöglichen und Abhängigkeiten reduzieren. Sie können Souveränität schwächen, wenn sie intransparente Anbieterbindungen, unklare Datenflüsse oder schwer wechselbare Plattformen erzeugen.

Datenräume

Ein Datenraum ist kein einzelner Datenspeicher, sondern ein geregeltes Ökosystem für Datenaustausch. Beteiligte Organisationen behalten Kontrolle über ihre Daten und vereinbaren, unter welchen Bedingungen Daten geteilt, kombiniert und genutzt werden dürfen. Dafür braucht es technische, rechtliche und organisatorische Regeln. APIs sind dabei wichtig, weil sie Datenräume praktisch nutzbar machen.

In einem Datenraum sind folgende Fragen zentral:

Identität: Wer darf teilnehmen und wie wird die Identität geprüft?
Berechtigung: Wer darf welche Daten unter welchen Bedingungen nutzen?
Semantik: Verstehen alle Beteiligten die Datenfelder gleich?
Interoperabilität: Können verschiedene Systeme miteinander arbeiten?
Protokollierung: Wird nachvollziehbar dokumentiert, welche Daten genutzt wurden?
Governance: Wer entscheidet über Regeln, Änderungen und Konflikte?
Vertrauen: Wie werden Sicherheit, Qualität und Verantwortung gesichert?

KI-Agenten und APIs

KI-Agenten können Aufgaben planen, Werkzeuge auswählen und über APIs mit digitalen Systemen interagieren. Dadurch können sie zum Beispiel Daten abrufen, Texte zusammenfassen, Termine vorschlagen, Tabellen analysieren oder Informationen aus mehreren Quellen verbinden. APIs machen solche Agenten handlungsfähig. Genau deshalb müssen sie begrenzt und kontrolliert werden.

Ein KI-Agent sollte nicht beliebig Zugriff auf alle Systeme erhalten. Sinnvoll sind minimale Rechte, klare Rollen, geprüfte Endpunkte, Protokollierung, Testumgebungen, menschliche Freigaben für riskante Aktionen und Schutz vor Prompt Injection. Wenn ein Agent Daten aus einer API erhält, muss außerdem geprüft werden, ob die Daten vertrauenswürdig, aktuell, lizenziert und für den geplanten Zweck geeignet sind.

API Literacy als Zukunftskompetenz

API Literacy ist eine Zukunftskompetenz, weil moderne digitale Infrastrukturen immer stärker aus vernetzten Diensten bestehen. Wer diese Netze nicht versteht, bleibt abhängig von Oberflächen, Plattformen und unsichtbaren Datenflüssen. Wer APIs lesen und bewerten kann, kann Fragen stellen, Alternativen prüfen, eigene Lösungen entwickeln und digitale Systeme demokratischer, offener und nachhaltiger gestalten.

Praxisbeispiel: Offene Daten über eine API nutzen

Ein typischer Einstieg in API Literacy ist die Arbeit mit Open Data. Nehmen wir an, Du möchtest untersuchen, welche offenen Datensätze es zum Thema Bildung gibt. Eine API kann Dir helfen, Datensätze automatisiert zu suchen und ihre Metadaten weiterzuverarbeiten.

GET https://www.govdata.de/ckan/api/3/action/package_search?q=bildung
Accept: application/json

Die technische Anfrage ist nur der erste Schritt. Für eine sinnvolle Nutzung brauchst Du weitere Prüfschritte.

Fragestellung: Was willst Du wissen und warum ist eine API dafür geeignet?
Quelle: Wer stellt die Daten bereit und wie verlässlich ist die Quelle?
Lizenz: Darfst Du die Daten weiterverwenden, verändern und veröffentlichen?
Metadaten: Gibt es Angaben zu Aktualität, Herkunft, Format und Kontakt?
Datenqualität: Sind Felder vollständig, verständlich und plausibel?
Datenschutz: Können Personen direkt oder indirekt identifiziert werden?
Technik: Gibt es Dokumentation, Beispielanfragen und Fehlercodes?
Ergebnis: Wie machst Du Deine Auswertung transparent und überprüfbar?

Mini-Projekt: Eine API-Lupe bauen

Eine API-Lupe ist eine kleine Prüfhilfe, mit der Du eine Schnittstelle untersuchst. Du kannst sie als Tabelle, Plakat, Präsentation, Wiki-Seite oder kleines digitales Tool gestalten.

Prüffeld	Leitfrage	Ergebnis
Zweck	Wofür ist die API gedacht?	Kurzbeschreibung
Zugang	Ist die API offen, registrierungspflichtig oder kostenpflichtig?	Zugangsart
Daten	Welche Daten oder Funktionen werden bereitgestellt?	Datenliste
Format	Werden JSON, XML, CSV oder andere Formate genutzt?	Formatangabe
Recht	Welche Lizenz und Nutzungsbedingungen gelten?	Lizenzprüfung
Sicherheit	Welche Authentifizierung und Rechte werden benötigt?	Risikoeinschätzung
Qualität	Sind Daten aktuell, vollständig und nachvollziehbar?	Qualitätsnotiz
Souveränität	Fördert die API Offenheit und Wechselbarkeit?	Bewertung

API-Sicherheit und Datenschutz

Eine API ist ein Zugangspunkt. Jeder Zugangspunkt kann nützlich sein, aber auch missbraucht werden. Deshalb gehören IT-Sicherheit und Datenschutz von Anfang an zum API-Einsatz.

Grundregeln für sichere API-Nutzung

API-Keys und Token niemals öffentlich teilen.
Zugangsdaten nicht in Screenshots, öffentlichen Repositories oder Lernmaterialien veröffentlichen.
Rechte nach dem Prinzip der minimalen Berechtigung vergeben.
Schreibrechte nur dann erlauben, wenn sie wirklich nötig sind.
Testumgebungen von produktiven Systemen trennen.
Eingaben prüfen, bevor sie an eine API gesendet werden.
Fehlercodes auswerten und nicht blind weitermachen.
Protokolle nutzen, um Missbrauch oder Fehlfunktionen zu erkennen.
Personenbezogene Daten nur mit klarer Rechtsgrundlage und Zweckbindung verarbeiten.
Bei KI-Agenten riskante Aktionen durch menschliche Freigabe absichern.

Datenschutzfragen

Bei personenbezogenen Daten reicht technische Funktionalität nicht aus. Die DSGVO verlangt unter anderem Zweckbindung, Datenminimierung, Transparenz, Sicherheit und Rechte der betroffenen Personen. Auch scheinbar harmlose Daten können sensibel werden, wenn sie kombiniert werden. Standortdaten, Lernfortschritte, Nutzungszeiten oder Kommunikationsdaten können Rückschlüsse auf Personen ermöglichen.

Eine datenschutzbewusste API-Nutzung fragt deshalb: Müssen diese Daten wirklich übertragen werden? Können sie anonymisiert oder aggregiert werden? Wer erhält Zugriff? Wie lange werden sie gespeichert? Können Betroffene Auskunft erhalten? Gibt es eine Datenschutzfolgeabschätzung für besonders riskante Verarbeitung?

API-Design: Gute Schnittstellen planen

API Literacy umfasst nicht nur Nutzung, sondern auch Gestaltung. Wer Schnittstellen plant, sollte sie aus Sicht der Menschen und Systeme denken, die sie später verwenden. Eine gute API ist verständlich, konsistent, sicher, dokumentiert, versioniert und wartbar.

Prinzipien guter API-Gestaltung

Klarheit: Endpunkte und Feldnamen sind verständlich.
Konsistenz: Ähnliche Dinge werden ähnlich benannt und strukturiert.
Dokumentation: Beispiele, Parameter, Fehler und Grenzen sind beschrieben.
Versionierung: Änderungen zerstören bestehende Anwendungen nicht unerwartet.
Fehlerkultur: Fehlermeldungen helfen bei der Lösung, ohne sensible Details preiszugeben.
Sicherheit: Rechte, Authentifizierung und Protokollierung sind eingeplant.
Barrierefreiheit: Ergebnisse werden so bereitgestellt, dass sie weiterverarbeitet und verständlich dargestellt werden können.
Nachhaltigkeit: Die API hat Verantwortliche, Wartungsprozesse und ein Änderungsprotokoll.
Interoperabilität: Offene Standards und gemeinsame Vokabulare werden bevorzugt.
Fairness: Daten und Automatisierungen werden auf Verzerrungen, Ausschlüsse und Folgen geprüft.

Versionierung und Stabilität

APIs ändern sich. Felder werden ergänzt, Formate angepasst, Sicherheitsregeln verschärft oder alte Endpunkte abgeschaltet. Ohne Versionierung können Anwendungen plötzlich fehlerhaft werden. Eine stabile API kommuniziert Änderungen frühzeitig, bietet Übergangszeiten und dokumentiert alte und neue Versionen.

Beispiel für Versionslogik:

https://api.beispiel.de/v1/datensaetze
https://api.beispiel.de/v2/datensaetze

Versionierung ist nicht nur Technik. Sie ist auch ein Versprechen an Nutzende, dass digitale Infrastruktur verlässlich bleibt.

Kompetenzmodell: Von der Nutzung zur Gestaltung

API Literacy lässt sich in fünf Kompetenzstufen beschreiben. Die Stufen bauen aufeinander auf, können aber je nach Lernstand unterschiedlich vertieft werden.

Stufe	Kompetenz	Beispielhandlung
1	Erkennen	Du erkennst, dass eine App Daten über Schnittstellen erhält.
2	Lesen	Du verstehst eine einfache API-Dokumentation.
3	Testen	Du führst eine Beispielanfrage aus und deutest die Antwort.
4	Bewerten	Du prüfst Datenqualität, Lizenz, Datenschutz und Sicherheit.
5	Gestalten	Du planst oder dokumentierst eine eigene sinnvolle Schnittstelle.

Interaktive Aufgaben

Quiz: Teste Dein Wissen

Was bedeutet API Literacy? (Die Fähigkeit, APIs zu verstehen, zu bewerten und verantwortungsvoll einzusetzen) (!Die Fähigkeit, Passwörter in Quelltext einzubauen) (!Die Fähigkeit, Webseiten ohne Datenquellen zu kopieren) (!Die Fähigkeit, jedes Datenformat automatisch zu vertrauen)

Was ist ein Endpoint? (Die Adresse oder Funktion, an die eine API-Anfrage gesendet wird) (!Ein Gerät, das nur Bilder speichert) (!Eine Lizenz für gedruckte Bücher) (!Ein Passwort für alle Nutzenden)

Wofür wird die HTTP-Methode GET typischerweise verwendet? (Daten abfragen) (!Daten dauerhaft löschen) (!Zugriffstoken verschlüsseln) (!Eine Lizenz automatisch vergeben)

Welche Aufgabe hat JSON in vielen Web-APIs? (Strukturierte Daten zwischen Systemen austauschen) (!Menschen eindeutig identifizieren) (!Server physisch kühlen) (!Rechte an Bildern automatisch klären)

Wozu dient OAuth vor allem? (Zugriffe autorisieren, ohne Passwörter direkt weiterzugeben) (!Daten in Papierform archivieren) (!Bilder automatisch vergrößern) (!Alle API-Anfragen anonym machen)

Was beschreibt ein Rate Limit? (Es begrenzt die Zahl der Anfragen in einem Zeitraum) (!Es ersetzt eine Datenschutzprüfung) (!Es löscht falsche Datensätze automatisch) (!Es macht jede API frei nutzbar)

Was leistet OpenAPI? (Es beschreibt eine HTTP API menschenlesbar und maschinenlesbar) (!Es ist ein Ersatz für alle Datenlizenzen) (!Es verhindert jede Sicherheitslücke automatisch) (!Es ist nur für Bildbearbeitung gedacht)

Was meint digitale Souveränität im API-Kontext? (Kontrolle über Daten, Infrastruktur und Abhängigkeiten reflektiert zu gestalten) (!Alle Schnittstellen grundsätzlich zu verbieten) (!Nur geschlossene Plattformen zu verwenden) (!Daten ohne Prüfung weiterzugeben)

Warum sind APIs für KI-Agenten wichtig? (Über APIs Werkzeuge und Datenquellen gezielt ansprechen) (!Weil KI-Agenten dadurch keine Regeln brauchen) (!Weil APIs jede Halluzination verhindern) (!Weil Zugriffsdaten öffentlich gespeichert werden sollen)

Was ist ein Datenraum? (Daten nach gemeinsamen Regeln und mit kontrollierter Nutzung teilen) (!Ein einzelner Ordner auf einem privaten Laptop) (!Eine Grafik ohne Metadaten) (!Ein Passwortspeicher für Klassenarbeiten)

Memory

API	Programmierschnittstelle
Endpoint	Adresse einer Funktion
Request	Anfrage an ein System
Response	Antwort eines Systems
Token	Zugriffsnachweis
Rate Limit	Nutzungsgrenze
OpenAPI	Maschinenlesbare Beschreibung
Webhook	Ereignisbenachrichtigung

Drag and Drop

Ordne die richtigen Begriffe zu.	Thema
API-Dokumentation lesen	Verstehen, welche Endpunkte existieren
Datenlizenz prüfen	Rechtssichere Nachnutzung einschätzen
Token begrenzen	Zugriff absichern
Statuscode auswerten	Fehler gezielt behandeln
Versionierung planen	Änderungen beherrschbar machen

Kreuzworträtsel

Endpoint	Wie nennt man die konkrete Adresse oder Funktion einer API?
Token	Wie heißt ein Zugriffsnachweis für eine API?
JSON	Welches Datenformat ist in Web-APIs besonders verbreitet?
OAuth	Welcher Standard dient häufig der Autorisierung?
Header	Wo stehen bei HTTP oft Metadaten einer Anfrage?
Webhook	Welche Schnittstelle informiert ein System bei einem Ereignis?

LearningApps

Lückentext

Eine

verbindet Softwaresysteme über festgelegte Regeln. Ein

ist die konkrete Adresse oder Funktion einer API. Ein

ist die Anfrage, die an eine Schnittstelle gesendet wird. Eine

ist die Antwort, die ein System zurückliefert. Das Format

wird in vielen Web-APIs für strukturierte Daten genutzt. Eine gute

erklärt Parameter, Fehlercodes und Nutzungsbedingungen. Ein

kann als Zugriffsnachweis für eine autorisierte Anfrage dienen. Ein

schützt Dienste vor zu vielen Anfragen in kurzer Zeit. Digitale

bedeutet, Abhängigkeiten und Kontrolle bewusst zu gestalten. Ein

ermöglicht Datenaustausch nach gemeinsamen Regeln.

Offene Aufgaben

Leicht

API im Alltag: Sammle fünf Alltagssituationen, in denen vermutlich APIs genutzt werden, und erkläre jeweils, welche Daten zwischen welchen Systemen fließen könnten.
Begriffskarte: Erstelle eine Lernkarte zu den Begriffen API, Endpoint, Request, Response, Token und JSON mit je einem eigenen Beispiel.
Datenfluss zeichnen: Zeichne den Datenfluss einer Wetter-App, einer Lernplattform oder eines Ticketshops und markiere mögliche Schnittstellen.
Dokumentation finden: Suche eine frei zugängliche API-Dokumentation und notiere, welche Endpunkte, Datenformate und Regeln Du verstehst.

Standard

API-Lupe: Untersuche eine offene API mit der API-Lupe aus diesem Kurs und bewerte Zweck, Zugang, Datenformat, Lizenz, Sicherheit und Souveränität.
Open-Data-Recherche: Wähle ein gesellschaftliches Thema und recherchiere, ob es dazu offene Datensätze mit API-Zugang gibt.
Fehleranalyse: Erkläre an drei HTTP-Statuscodes, wie eine Anwendung sinnvoll auf Erfolg, fehlende Daten oder Zugriffsprobleme reagieren sollte.
Datenschutzprüfung: Entwickle für eine Bildungs-App eine Checkliste, welche personenbezogenen Daten über APIs übertragen werden dürften und welche nicht.

Schwer

API-Prototyp: Entwirf eine eigene API für ein schulisches, kulturelles oder gemeinnütziges Projekt mit Endpunkten, Beispielantworten, Rechten und Fehlercodes.
KI-Agenten-Konzept: Plane einen KI-Agenten, der über APIs nur klar begrenzte Aufgaben ausführen darf, und beschreibe Sicherheitsgrenzen sowie menschliche Freigaben.
Datenraum-Szenario: Entwickle ein Szenario für einen Datenraum im Bereich Kultur, Bildung oder Nachhaltigkeit und beschreibe Rollen, Regeln, APIs und Risiken.
Souveränitätsanalyse: Vergleiche zwei digitale Plattformen oder Dienste danach, wie offen ihre Schnittstellen sind und welche Abhängigkeiten für Nutzende entstehen.

type=create break=no preload=CHAT GPT TEXT HIER EINFÜGEN default= width=30 placeholder= Dein MOOC Titel buttonlabel=MOOC erstellen </inputbox>

Lernkontrolle

Transferanalyse: Erkläre, warum eine funktionierende API noch kein sinnvoller API-Einsatz ist, und beziehe Datenqualität, Recht, Sicherheit und Zweck ein.
Fallbewertung: Eine Schule möchte Lernfortschritte automatisch an einen externen Dienst senden. Prüfe Chancen, Risiken und Bedingungen für eine verantwortliche Entscheidung.
Schnittstellenstrategie: Ein Museum möchte seine Sammlung über eine API öffnen. Entwickle eine Strategie, die offene Kultur, Rechteklärung, Metadatenqualität und digitale Souveränität verbindet.
KI-Agenten-Risiko: Ein KI-Agent darf über APIs Bestellungen auslösen. Beschreibe, welche Schutzmaßnahmen notwendig sind und welche Aktionen menschliche Freigabe brauchen.
Datenraum-Entwurf: Vergleiche eine einfache Datensammlung mit einem Datenraum und erkläre, warum Regeln, Identität, Semantik und Governance entscheidend sind.
API-Governance: Ein Unternehmen nutzt viele nicht dokumentierte Schnittstellen. Entwickle einen Maßnahmenplan, um Sicherheit, Wartbarkeit und Transparenz zu verbessern.

Lernnachweis

Erstelle als Lernnachweis ein kleines Portfolio mit vier Bestandteilen. Erstens beschreibst Du eine API oder ein API-Szenario in eigenen Worten. Zweitens dokumentierst Du eine Beispielanfrage oder ein Datenflussdiagramm. Drittens bewertest Du Datenqualität, Lizenz, Datenschutz, Sicherheit und digitale Souveränität. Viertens formulierst Du eine Empfehlung, ob und unter welchen Bedingungen die Schnittstelle sinnvoll eingesetzt werden sollte.

Kriterium	Erwartung
Fachlichkeit	Die zentralen Begriffe werden korrekt verwendet.
Analyse	Chancen und Risiken werden nachvollziehbar abgewogen.
Verantwortung	Datenschutz, Sicherheit, Lizenz und Souveränität werden berücksichtigt.
Transfer	Die Bewertung wird auf ein eigenes Beispiel angewendet.
Darstellung	Ergebnisse sind verständlich, strukturiert und überprüfbar.

OERs zum Thema

Links

API Literacy

aiMOOC-Projekte

Schulfach+

Prüfungsliteratur 2026
Bundesland	Bücher	Kurzbeschreibung
Baden-Württemberg	Abitur Der zerbrochne Krug - Heinrich von Kleist Heimsuchung - Jenny Erpenbeck Mittlere Reife Der Markisenmann - Jan Weiler oder Als die Welt uns gehörte - Liz Kessler Ein Schatten wie ein Leopard - Myron Levoy oder Pampa Blues - Rolf Lappert	Abitur Dorfrichter-Komödie über Wahrheit/Schuld; Roman über einen Ort und deutsche Geschichte. Mittlere Reife Wahllektüren (Roadtrip-Vater-Sohn / Jugendroman im NS-Kontext / Coming-of-age / Provinzroman).
Bayern	Abitur Der zerbrochne Krug - Heinrich von Kleist Heimsuchung - Jenny Erpenbeck	Abitur Lustspiel über Machtmissbrauch und Recht; Roman als Zeitschnitt deutscher Geschichte an einem Haus/Grundstück.
Berlin/Brandenburg	Abitur Der zerbrochne Krug - Heinrich von Kleist Woyzeck - Georg Büchner Der Biberpelz - Gerhart Hauptmann Heimsuchung - Jenny Erpenbeck	Abitur Gerichtskomödie; soziales Drama um Ausbeutung/Armut; Komödie/Satire um Diebstahl und Obrigkeit; Roman über Erinnerungsräume und Umbrüche.
Bremen	Abitur Nach Mitternacht - Irmgard Keun Mario und der Zauberer - Thomas Mann Emilia Galotti - Gotthold Ephraim Lessing oder Miss Sara Sampson - Gotthold Ephraim Lessing	Abitur Roman in der NS-Zeit (Alltag, Anpassung, Angst); Novelle über Verführung/Massenpsychologie; bürgerliche Trauerspiele (Moral, Macht, Stand).
Hamburg	Abitur Der zerbrochne Krug - Heinrich von Kleist Das kunstseidene Mädchen - Irmgard Keun	Abitur Justiz-/Machtkritik als Komödie; Großstadtroman der Weimarer Zeit (Rollenbilder, Aufstiegsträume, soziale Realität).
Hessen	Abitur Der zerbrochne Krug - Heinrich von Kleist Woyzeck - Georg Büchner Heimsuchung - Jenny Erpenbeck Der Prozess - Franz Kafka	Abitur Gerichtskomödie; Fragmentdrama über Gewalt/Entmenschlichung; Erinnerungsroman über deutsche Brüche; moderner Roman über Schuld, Macht und Bürokratie.
Niedersachsen	Abitur Der zerbrochene Krug - Heinrich von Kleist Das kunstseidene Mädchen - Irmgard Keun Die Marquise von O. - Heinrich von Kleist Über das Marionettentheater - Heinrich von Kleist	Abitur Schwerpunkt auf Drama/Roman sowie Kleist-Prosatext und Essay (Ehre, Gewalt, Unschuld; Ästhetik/„Anmut“).
Nordrhein-Westfalen	Abitur Der zerbrochne Krug - Heinrich von Kleist Heimsuchung - Jenny Erpenbeck	Abitur Komödie über Wahrheit und Autorität; Roman als literarische „Geschichtsschichtung“ an einem Ort.
Saarland	Abitur Heimsuchung - Jenny Erpenbeck Furor - Lutz Hübner und Sarah Nemitz Bahnwärter Thiel - Gerhart Hauptmann	Abitur Erinnerungsroman an einem Ort; zeitgenössisches Drama über Eskalation/Populismus; naturalistische Novelle (Pflicht/Überforderung/Abgrund).
Sachsen (berufliches Gymnasium)	Abitur Der zerbrochne Krug - Heinrich von Kleist Woyzeck - Georg Büchner Irrungen, Wirrungen - Theodor Fontane Der gute Mensch von Sezuan - Bertolt Brecht Heimsuchung - Jenny Erpenbeck Der Trafikant - Robert Seethaler	Abitur Mischung aus Klassiker-Drama, sozialem Drama, realistischem Roman, epischem Theater und Gegenwarts-/Erinnerungsroman; zusätzlich Coming-of-age im historischen Kontext.
Sachsen-Anhalt	Abitur (keine fest benannte landesweite Pflichtlektüre veröffentlicht; Themenfelder)	Abitur Schwerpunktsetzung über Themenfelder (u. a. Literatur um 1900; Sprache in politisch-gesellschaftlichen Kontexten), ohne feste Einzeltitel.
Schleswig-Holstein	Abitur Der zerbrochne Krug - Heinrich von Kleist Heimsuchung - Jenny Erpenbeck	Abitur Recht/Gerechtigkeit und historische Tiefenschichten eines Ortes – umgesetzt über Drama und Gegenwartsroman.
Thüringen	Abitur (keine fest benannte landesweite Pflichtlektüre veröffentlicht; Orientierung am gemeinsamen Aufgabenpool)	Abitur In der Praxis häufig Orientierung am gemeinsamen Aufgabenpool; landesweite Einzeltitel je nach Vorgabe/Handreichung nicht einheitlich ausgewiesen.
Mecklenburg-Vorpommern	Abitur (Quelle aktuell technisch nicht abrufbar; Beteiligung am gemeinsamen Aufgabenpool bekannt)	Abitur Land beteiligt sich am länderübergreifenden Aufgabenpool; konkrete, veröffentlichte Einzeltitel konnten hier nicht ausgelesen werden.
Rheinland-Pfalz	Abitur (keine landesweit einheitliche Pflichtlektüre; schulische Auswahl)	Abitur Keine landesweite Einheitsliste; Auswahl kann schul-/kursbezogen erfolgen.