ARTIKEL · TESTAUTOMATISIERUNG · API

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.

SchnellerKein Browser, kein Seitenaufbau: Ein API-Test läuft typischerweise in einem Bruchteil der Zeit seines UI-Gegenstücks, daher können bei jedem Deployment viele Fälle laufen.
StabilerEin umgestaltetes Formular, eine neue Schaltfläche oder eine umbenannte Registerkarte bricht ihn nicht. Schlägt ein API-Test fehl, ist es meist ein echter Fehler.
FrüherDie API ist meist vor der Oberfläche fertig, also kann auch früher getestet werden.
Wo die Schnittstellen sindDer Datenaustausch zwischen Systemen (ERP, Fakturierung, Webshop) ist auf der Oberfläche unsichtbar; er lässt sich nur auf API-Ebene Feld für Feld prüfen.

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.

KriteriumRESTSOAP
Nachrichtmeist JSON; die URL bezeichnet die Ressource, das HTTP-Verb (GET, POST, PATCH, DELETE) die OperationXML-Envelope an einen Endpunkt; der Nachrichtenname bestimmt die Operation
VertragOpenAPI/Swagger; bei OData-Diensten das $metadata-DokumentWSDL und XSD
FehlerHTTP-Statuscode (4xx, 5xx) und Fehlermeldung im Response-BodySOAP-Fault-Element, über HTTP mit Status 500
Was wir prüfenStatuscode, JSON-Schema, Feldwerte, Header, Antwortzeitschemakonformes XML, Feldwerte per XPath, Fault-Codes
Wo man ihm begegnetmoderne 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.

AuthentifizierungEin OAuth-2.0-Zugriffstoken aus Microsoft Entra ID. Automatisierte Tests brauchen eine App-Registrierung und einen Anwendungsbenutzer in der Umgebung mit passender Sicherheitsrolle; der Test speichert kein Passwort.
AbfragenOData-Abfrageoptionen: $select (Spalten), $filter, $expand (verknüpfte Datensätze), $orderby, $top. Der Test fragt genau das ab, was er prüft.
GeschäftslogikHinter der Web API läuft dieselbe Plattform wie hinter der Oberfläche: Plug-ins, Geschäftsregeln und Echtzeit-Workflows werden auch bei API-Aufrufen ausgeführt, daher ist die Logik auf API-Ebene testbar.
OperationenNachrichten, die keine CRUD-Operationen sind, stehen als Funktionen oder Aktionen bereit; auch eigene benutzerdefinierte APIs werden so aufgerufen.
LimitsDataverse wendet Dienstschutz-Limits an: Bei zu vielen Anfragen antwortet es mit 429 Too Many Requests und einem Retry-After-Header. Das Testframework muss das behandeln, sonst wird aus der Drosselung ein falscher Fehlschlag.
Den alten SOAP-Endpunkt von Dataverse aus dem Jahr 2011 (Organisationsdienst) hat Microsoft als veraltet markiert; für neue Entwicklung und Tests empfiehlt Microsoft die Web API oder das .NET-SDK. SOAP begegnet uns in Dynamics-Projekten daher meist auf der Seite älterer angebundener Systeme.

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?

Tricentis Tosca API ScanLaut der Dokumentation zu Tosca 2026.1 verarbeitet es REST- und SOAP-Dienste, liest den Vertrag aus OData-4.0-, OpenAPI-3.0-, Swagger-, WSDL-, RAML- und WADL-Beschreibungen und unterstützt unter anderem OAuth 2.0. Aus den gescannten Nachrichten entstehen Tosca-Module und No-Code-Testfälle, sodass ein Testfall API- und UI-Schritte mischen kann. Menüs und Schritte in älteren Schulungsunterlagen (12.x) können abweichen; wir arbeiten nach der aktuellen Dokumentation.
PlaywrightDer APIRequestContext (in Tests die request-Fixture) sendet HTTP-Anfragen ohne Browser. Er eignet sich für reine API-Tests, seine eigentliche Stärke liegt aber in der Kombination mit UI-Tests: Der Test bereitet Daten per API vor, führt den Prozess in der Oberfläche aus und prüft das Ergebnis wieder per API. Open Source, keine Lizenzgebühr.
PostmanCollections, Umgebungsvariablen und geskriptete Prüfungen; bequem für exploratives API-Testing und die Zusammenarbeit mit Entwicklern. In der CI läuft es über die Kommandozeile: Neben Newman empfiehlt Postman heute die eigene Postman CLI.

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.

Zertifiziertes API-TestingTricentis Tosca Automation Specialist for API und for Database sowie Automation Specialist und Test Design Specialist Level 1–2.
Dynamics 365 und Tests aus einer HandDasselbe Team kennt Dataverse, die Plug-ins und das Testwerkzeug; die Ursache eines fehlgeschlagenen Tests geht nicht zwischen Tickets verloren.

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

Cookie-Einstellungen

Wählen Sie, wozu Sie einwilligen. Wir merken uns Ihre Wahl 6 Monate lang; ändern können Sie sie jederzeit über „Cookie-Einstellungen“ in der Fußzeile.

Datenschutzhinweise