API-Testing für Dynamics 365: REST, SOAP und die Dataverse Web API in der Praxis
Kurz gesagt: Ein API-Test prüft Geschäftslogik und Schnittstellen unterhalb der Oberfläche, indem er den Dienst direkt aufruft. Er ist schneller und stabiler als ein UI-Test und lässt sich ausführen, bevor die Oberfläche fertig ist. Dataverse, die Datenschicht von Dynamics 365, bietet eine OData-v4-REST-API mit Authentifizierung über Microsoft Entra ID; darauf bauen wir Tests mit Tricentis Tosca API Scan, Playwright oder Postman und führen sie vor jedem Deployment in der CI aus.
Was ist API-Testing, und was unterscheidet es vom UI-Test?
Eine API (Programmierschnittstelle) ist der Vertrag, über den zwei Systeme miteinander sprechen: welche Anfragen gesendet werden können und welche Antworten zurückkommen müssen. Ein API-Test prüft diesen Vertrag: Er sendet eine Anfrage und prüft Statuscode, Struktur und Inhalt der Antwort, Header, Antwortzeit und — wenn der Aufruf Daten geschrieben hat — ob das System sie tatsächlich gespeichert hat.
UI-Tests werden dadurch nicht überflüssig: Nur sie sehen den Anwenderprozess von Ende zu Ende. Nach der Testpyramide ist die richtige Mischung viele API-Tests und weniger, sorgfältig ausgewählte UI-Tests — mehr dazu im Artikel manuell oder automatisiert testen.
REST oder SOAP: Was ist für den Test der Unterschied?
Die beiden häufigsten API-Stile beschreiben den Vertrag unterschiedlich und melden Fehler unterschiedlich; das Testwerkzeug muss beide beherrschen, wenn ein Prozess über beide läuft.
| Kriterium | REST | SOAP |
|---|---|---|
| Nachricht | meist JSON; die URL bezeichnet die Ressource, das HTTP-Verb (GET, POST, PATCH, DELETE) die Operation | XML-Envelope an einen Endpunkt; der Nachrichtenname bestimmt die Operation |
| Vertrag | OpenAPI/Swagger; bei OData-Diensten das $metadata-Dokument | WSDL und XSD |
| Fehler | HTTP-Statuscode (4xx, 5xx) und Fehlermeldung im Response-Body | SOAP-Fault-Element, über HTTP mit Status 500 |
| Was wir prüfen | Statuscode, JSON-Schema, Feldwerte, Header, Antwortzeit | schemakonformes XML, Feldwerte per XPath, Fault-Codes |
| Wo man ihm begegnet | moderne Web- und Cloud-Dienste, die Dataverse Web API | ältere Unternehmenssysteme: ERP-, Bank- und Logistik-Schnittstellen |
Die Testlogik ist bei beiden gleich: gültige Anfrage, korrekte Antwort (Positivfall), ungültige Anfrage, verständliche Fehlermeldung (Negativfall) und Seiteneffekt: Der Datensatz wurde wirklich angelegt, der Status wirklich geändert, das angebundene System hat die Daten wirklich erhalten.
Wie funktioniert die Dynamics 365 (Dataverse) Web API?
Die Daten der Dynamics-365-CRM-Apps (Sales, Customer Service und weitere) liegen in Dataverse. Laut Microsoft Learn implementiert die Dataverse Web API das Protokoll OData 4.0 und ist damit eine Standard-REST-API: Tabellen und Spalten beschreibt das $metadata-Dokument, Datensätze werden mit GET, POST, PATCH und DELETE gelesen, angelegt, geändert und gelöscht.
Was sollte man in Dynamics 365 auf API-Ebene testen?
- Plug-in- und Regellogik: Datensatz über die API anlegen oder ändern, dann berechnete Felder, Statuswechsel und angelegte verknüpfte Datensätze zurücklesen.
- Berechtigungen: dieselbe Anfrage mit Testbenutzern in verschiedenen Sicherheitsrollen; was eine Rolle nicht sehen oder ändern darf, muss das System ablehnen.
- Schnittstellen: Daten an ERP, Fakturierung oder Webshop Feld für Feld, abgeglichen mit der API der Gegenseite.
- Benutzerdefinierte APIs und Aktionen: Eingabe, Ausgabe und Fehlerpfade eigener Endpunkte.
- Fehlerbehandlung: fehlendes Pflichtfeld, ungültiger Nachschlageverweis, zu langer Text — die Antwort muss eindeutig sein, und das System darf nicht halb aktualisiert zurückbleiben.
Ein API-Test arbeitet mit eigenen Testdaten: Er legt die benötigten Datensätze zu Beginn an, löscht sie am Ende und läuft nie gegen die Produktion. Woher DSGVO-konforme Testdaten dafür kommen, beschreibt der Artikel Testdatenmanagement für Dynamics 365.
Welches Werkzeug: Tricentis Tosca API Scan, Playwright oder Postman?
Die Wahl hängt vom Team ab, nicht von der API: Tosca, wenn fachliche Tester die Tests pflegen; Playwright, wenn Entwickler es tun; Postman für explorative und Schnittstellenprüfungen. Ein allgemeiner Vergleich: Tricentis Tosca, Katalon oder Playwright?
Wie laufen API-Tests in CI/CD?
API-Tests gehören in dieselbe Deployment-Pipeline wie UI-Tests: Sie laufen vor jedem Deployment und jede Nacht gegen die Testumgebung, die Ergebnisse hängen als JUnit-Bericht an der Pipeline, und ein Fehlschlag stoppt das Deployment. Zugangsdaten (Client-ID, Geheimnis oder Zertifikat) kommen aus dem Secret Store der CI, nie aus dem Repository.
Bei Dynamics 365 sind API-Tests vor dem halbjährlichen Update besonders wertvoll: Ein Schnittstellenfehler ist auf der Oberfläche unsichtbar, auf API-Ebene aber sofort sichtbar. Siehe Regressionstest und Testautomatisierung für Dynamics-365-Release-Waves.
Wie unterstützen wir beim API-Testing?
Wir analysieren Schnittstellen und eigene Logik, wählen die auf API-Ebene zu testenden Fälle risikobasiert aus, bauen die Suite mit dem Werkzeug, das zu Ihrem Team passt, binden sie in die CI ein und pflegen sie zusammen mit dem System — auf Deutsch, als Nearshore-Partner in der EU.
Mehr zur Leistung: Testautomatisierung und Tests.
Häufige Fragen
Was ist der Unterschied zwischen API-Test und Integrationstest?
Ein API-Test prüft den Vertrag eines Dienstes: Liefert eine bestimmte Anfrage die korrekte Antwort? Ein Integrationstest prüft, ob zwei oder mehr Systeme zusammen korrekt funktionieren. In der Praxis bestehen die meisten Integrationstests aus API-Aufrufen.
Muss man für API-Testing programmieren?
Nicht unbedingt. Tricentis Tosca API Scan baut Tests ohne Code aus der Dienstbeschreibung; in Postman reichen wenige Skriptzeilen für Prüfungen. Playwright ist codebasiert und für Entwickler gedacht.
Kann man einen SOAP-Dienst mit Playwright testen?
Ja, denn Playwright kann beliebige HTTP-Anfragen senden, also auch einen SOAP-Envelope als XML-Body. WSDL-Unterstützung gibt es aber nicht, die XML-Antwort muss der Test selbst auswerten. Für viele SOAP-Dienste sind Tosca oder Postman bequemer.
Wie authentifiziert sich ein Test an der Dynamics 365 Web API?
Mit einem OAuth-2.0-Token aus Microsoft Entra ID. Automatisierte Tests brauchen eine App-Registrierung und einen Anwendungsbenutzer in der Dynamics-Umgebung mit passender Sicherheitsrolle; Geheimnis oder Zertifikat kommen aus dem Secret Store der CI.
Dürfen API-Tests gegen die Produktion laufen?
Schreibende Tests führen wir nicht in der Produktion aus: Sie würden Datensätze anlegen und Plug-ins und Flows auslösen. Die Tests laufen in einer Sandbox; in der Produktion kommen höchstens lesende Prüfungen ohne Datenänderung in Frage, nach Absprache.
Sprechen wir über Ihr Projekt.
Schreiben Sie uns, was Sie planen — wir melden uns innerhalb weniger Tage.
Kontakt aufnehmen