Testen von API-Endpunkten

Ich hatte in einem anderen Artikel schon zu diesem Thema Stellung genommen. Wie testet man überhaupt API Endpunkte? Was ist das eigentlich?

Genau darum ging es in einer längeren Diskussion u.a. bei Stackoverflow.

Konkret

Welche Unterlagen gibt es?
Welche Funktionalität bietet es?
Unterstützt es die Parallelität?
Was sind die API-Endpunkte?
Ist die API intern oder extern?
Welche Endpunkte sind idempotent?
Sind Endpunkte zustandslos oder zustandsbehaftet?
Sind die Workflows*1 je nach Kunde unterschiedlich?
Gibt es Leistungsanforderungen?
Bilden API-Endpunkte einen Workflow?
Welche Validierungen werden für Daten erwartet?
Gibt es Thrift-Definitionen (falls zutreffend)?
Welches System oder welche Bibliothek steckt hinter der API?
Müssen wir uns über abhängige Dienste lustig machen?
Schränkt es den Traffic ein, auch bekannt als Ratę Begrenzung?
Welcher (falls vorhanden) Versionierungsansatz wird verwendet?
Unterstützt die API mehrere Sprachen?
Wenn Sie SOAPui bereits einsetzen, wie wird es integriert?
Ist die API auf ein Land oder eine Region beschränkt?
Stellt es Client-Stubs in bestimmten Sprachen zur Verfügung?
Gibt es bestehende API-Definitionen wie z.B. WADL, WSDL?
Welche Statuscodes werden für bestimmte Endpunkte erwartet?
Welches Domänenformat und welche Struktur gibt es für die Daten?
Verwendet die API HATEOS*2 zur Selbstdokumentation?
Welche Art von Datenvalidierung / Test kann durchgeführt werden?
Welche API wird von dem von mir verwendeten Testframework unterstützt?
Welche Aktionen werden ausgeführt, z.B. GET, PUT, POST usw.?
Müssen wir abhängige Testdaten oder Dienstleistungen vorbereiten?
Welche Nicht-API-Ansätze werden benötigt, um Daten zu verifizieren?
Welche Nicht-API-Ansätze werden für die Datenaufbereitung benötigt?
Welcher (falls vorhanden) Autorisierungsmechanismus („was“) wird verwendet?
Welcher (falls vorhanden) Authentifizierungsmechanismus („wer“) wird verwendet?
Welches Format(e): SoapUI, Rest, GraphQL, Thrift ProtoBuffer, Andere?
Wer wird es verwenden, externe Programmierer oder ein anderes internes Modul?

Das Thema API Test ist sehr umfangreich, daher kann ich auch immer nur einen kleinen Bereich dessen darstellen was dieses sehr spezielle Thema an Themenbereichen anbietet. Gute Tutorials findet man aber zu diesem Thema natürlich auch bei Youtube.