REST-API online testen: Schritt-für-Schritt-Anleitung

Was du brauchst

Einen öffentlich erreichbaren Endpunkt. Die Beispiele nutzen https://jsonplaceholder.typicode.com, eine kostenlose Test-API, und https://httpbin.org, das zurückschickt, was du sendest.
Ein kostenloses Konto bei Swastik Codes. Die Web-App braucht ein Konto; die Anmeldung geht mit GitHub oder per E-Mail.
Die Dokumentation der API, oder zumindest URL, Methode und Art der Authentifizierung.

Warum öffentlich? Eine Webseite darf wegen der CORS-Regeln des Browsers keine beliebigen Anfragen an fremde Server schicken. Die Web-App sendet deine Anfrage deshalb über den Server von swastik.codes, und dieser lehnt private Adressen wie localhost oder 192.168.x.x ab. Für eine API auf deinem eigenen Rechner nutzt du swc bridge oder die Desktop-App für Windows, macOS und Linux.

Schritt 1: die erste GET-Anfrage

Öffne swastik.codes/app, lege einen neuen Request an und gib diese URL ein:

HTTP

GET https://jsonplaceholder.typicode.com/posts/1

Klicke auf Send. Unten erscheinen Statuscode (200 OK), Antwortzeit, Größe und der formatierte JSON-Body.

Schritt 2: die passende HTTP-Methode wählen

GET liest Daten und hat keinen Body.
POST legt etwas Neues an.
PUT ersetzt eine Ressource vollständig, PATCH ändert einzelne Felder.
DELETE löscht eine Ressource.

Teste nach Möglichkeit auch die Fälle, die schiefgehen sollen: eine unbekannte ID (erwartet 404) oder fehlende Zugangsdaten (erwartet 401).

Schritt 3: Parameter und Header setzen

Query-Parameter trägst du im Tab Params ein; die URL wird automatisch angepasst. Pfadvariablen schreibst du als :id, etwa /posts/:id. Header wie Accept: application/json gehören in den Tab Headers. Einzelne Zeilen lassen sich abschalten, ohne sie zu löschen.

Schritt 4: einen JSON-Body senden

Wähle POST, im Tab Body den Modus raw und das Format JSON:

HTTP

POST https://jsonplaceholder.typicode.com/posts
Content-Type: application/json

{
  "title": "Hallo API",
  "body": "Mein erster Test",
  "userId": 1
}

Die Test-API antwortet mit 201 Created und dem angelegten Objekt samt neuer id.

Schritt 5: Authentifizierung hinzufügen

Im Tab Auth wählst du die Art der Anmeldung: API-Key, Bearer-Token, Basic, Digest, OAuth 1.0, OAuth 2.0 (mit PKCE und automatischer Erneuerung), AWS Signature v4, NTLM und weitere. Stellst du die Authentifizierung an der Collection ein, erben alle Anfragen darin sie automatisch.

Schritt 6: Variablen und Umgebungen nutzen

Statt die Basis-URL in jede Anfrage zu schreiben, legst du eine Umgebung an, zum Beispiel „Staging“ mit baseUrl = https://jsonplaceholder.typicode.com, und schreibst {{baseUrl}}/posts/1. Mit einem Klick wechselst du zwischen Staging und Produktion. Geheime Werte gehören in den Current-Wert: Er bleibt auf deinem Gerät und wird nicht synchronisiert.

Schritt 7: die Antwort richtig lesen

Achte auf vier Dinge:

Statuscode. 2xx heißt Erfolg, 4xx ein Fehler in der Anfrage, 5xx ein Fehler auf dem Server.
Zeit. Die Aufschlüsselung zeigt DNS, Verbindungsaufbau, TLS, Zeit bis zum ersten Byte und Download.
Header. Stimmen Content-Type, Caching- und Sicherheits-Header?
Body. Sind alle Felder da, mit den richtigen Typen?

Schritt 8: einen Test schreiben

Speichere die Anfrage in einer Collection, öffne den Tab Scripts und wähle Post-response. Ein einfacher Test sieht so aus:

JavaScript

swc.test('Status ist 200', () => {
  swc.response.to.have.status(200);
});

swc.test('Post hat eine id und einen Titel', () => {
  const post = swc.response.json();
  swc.expect(post.id).to.equal(1);
  swc.expect(post.title).to.be.a('string');
});

Statt swc kannst du auch pm schreiben: Skripte aus Postman laufen unverändert. Nach dem Senden zeigt der Tab Test Results, welche Prüfungen bestanden haben.

Schritt 9: die ganze Collection ausführen

Mit dem Collection Runner startest du alle gespeicherten Anfragen nacheinander, auf Wunsch mit mehreren Iterationen und Testdaten aus einer CSV- oder JSON-Datei. Damit wird aus einzelnen Anfragen eine kleine Testsuite, die du nach jeder Änderung an der API erneut ausführst. Für CI-Pipelines gibt es das Kommandozeilen-Tool swc.

Häufige Fragen

Kann ich eine REST-API kostenlos online testen?

Ja. Swastik Codes ist kostenlos und hat keine kostenpflichtigen Tarife. Du brauchst nur ein kostenloses Konto mit GitHub oder E-Mail.

Kann ein Online-API-Tester localhost erreichen?

Nicht direkt, denn die Anfrage geht über einen Server im Internet. Mit swc bridge auf deinem Rechner oder mit der Desktop-App für Windows, macOS und Linux gehen Anfragen von deinem eigenen Rechner aus und erreichen localhost und interne Netze.

Was sollte ich beim Testen einer REST-API prüfen?

Statuscodes für Erfolg und Fehlerfälle, Antwortzeiten, wichtige Header wie Content-Type, die Struktur und Typen im Body sowie das Verhalten ohne oder mit falschen Zugangsdaten.

Brauche ich JavaScript-Kenntnisse für API-Tests?

Für einfache Prüfungen reichen wenige Zeilen wie im Beispiel oben. Wenn du schon Postman-Tests geschrieben hast, kannst du sie unverändert weiterverwenden.

REST-API online testen, Schritt für Schritt