Was ist eine API?

Eine kompakte API-Einführung für QA: Begriff, Kommunikation zwischen Systemen und Nutzen für tiefere Produkttests.

Aktualisiert:

Inhalt

Eine API, kurz für Application Programming Interface, ermöglicht Programmen die Zusammenarbeit nach vereinbarten Regeln. Sie legt fest, was ein System anfordern kann, welche Daten erforderlich sind, was zurückkommt und wie Fehler dargestellt werden.

Für QA ist dies eine grundlegende Produktschicht. Benutzer sehen Ansichten, Schaltflächen und Formulare; die eigentliche Logik liegt meist tiefer: Anfragen, Berechtigungsprüfungen, Berechnungen, Integrationen und Datenänderungen. Ohne API-Verständnis sieht ein Tester fast immer nur die Oberfläche.

So funktioniert es

Typischerweise sendet ein Client eine Anfrage an einen Dienst, der eine Antwort liefert. Der Client kann Browser, mobile App, anderer Dienst oder externer Partner sein. Der Dienst empfängt die Anfrage, validiert Daten, prüft Berechtigungen, führt Geschäftslogik aus und liefert das Ergebnis.

  • →Wohin die Anfrage geht: Endpunkt oder Ressourcenpfad.
  • →Was geschieht: eine Methode wie GET, POST, PATCH oder DELETE.
  • →Was die Anfrage begleitet: Header, Parameter, Body und Autorisierung.
  • →Was zurückkommt: Status, Header, Daten oder Fehlerbeschreibung.

Eine API ist mehr als „URL und JSON“. Sie ist ein Interaktionsvertrag zwischen Systemen. Die interne Implementierung eines Dienstes kann sich ändern, während der Vertrag erhalten bleibt.

Was für QA wichtig ist

APIs ermöglichen Systemtests ohne zusätzliche visuelle Schicht. Das macht Tests schneller, präziser und nützlicher für Untersuchungen.

  • →Eine API zeigt, welche Daten tatsächlich gesendet und zurückgegeben wurden.
  • →Geschäftslogik lässt sich über eine API leichter testen als über das UI.
  • →APIs erleichtern die Konstruktion negativer Szenarien und Randfälle.
  • →APIs helfen, Probleme in Oberfläche, Backend, Autorisierung, Daten oder Integration zu verorten.

Eine gute API-Prüfung geht über den Aufruf eines Endpunkts hinaus. QA muss Pflichtfelder, zulässige Rollen, Verhalten bei ungültigen Eingaben, Nebenwirkungen und den Zusammenhang zwischen Antwort und später sichtbarem Ergebnis verstehen.

Wo APIs im Produkt vorkommen

Fast überall, wo Systemkomponenten Daten austauschen.

  • →Web- und Mobilanwendungen verwenden APIs zum Lesen und Ändern von Daten.
  • →Interne Dienste arbeiten über APIs zusammen.
  • →Externe Integrationen verwenden APIs für Zahlungen, Lieferung, Betrugserkennung, E-Mail, SMS und Analytik.
  • →Automatische Tests und Hilfsskripte interagieren häufig über APIs statt über Ansichten mit dem Produkt.
📌

APIs sind für QA ein grundlegendes Arbeitsmittel, kein aufzuschiebendes Fortgeschrittenenthema. Je früher Sie in APIs denken, desto schneller verlassen Sie oberflächliche Produkttests.

Weiterführende Informationen

  • →In dieser Wissensdatenbank: HTTP und HTTPS — zum Verständnis der Transportschicht der API-Kommunikation.
  • →In dieser Wissensdatenbank: Methoden, Statuscodes und Header — zur Interpretation von Anfragen und Antworten durch QA.
  • →Externe Ressource: MDN-Glossar: API — eine knappe, präzise API-Definition.

Für QA sind APIs die Kommunikationssprache der Produktkomponenten. Diese Schicht zu sehen verbessert die Testqualität deutlich: Tester verstehen sowohl den Fehler als auch seinen Ort.