DEV Community

Cover image for Wie man HAR-Dateien in Apidog importiert: Erfassten Traffic in Endpunkte umwandeln
Emre Demir
Emre Demir

Posted on • Originally published at apidog.com

Wie man HAR-Dateien in Apidog importiert: Erfassten Traffic in Endpunkte umwandeln

Sie haben beobachtet, wie eine App im Browser eine Anfrage stellt. Sie funktioniert, und die Daten sind im Netzwerk-Tab sichtbar. Jetzt möchten Sie denselben Aufruf als dokumentierten Endpunkt speichern, simulieren und testen können – ohne URL, Header und JSON-Body manuell nachzubauen.

Testen Sie Apidog noch heute

Diese Lücke zwischen sichtbarem Datenverkehr und einem wiederverwendbaren Endpunkt schließt eine HAR-Datei. Ihr Browser zeichnet bereits Anfragen und Antworten auf. Exportieren Sie diese Aufzeichnung, importieren Sie sie in Apidog, und die erfassten Aufrufe werden zu Endpunkten in Ihrem Projekt.

Dieser Leitfaden zeigt den vollständigen Workflow:

  1. HAR in Chrome DevTools erfassen
  2. HAR mit sinnvollen Optionen importieren
  3. Generierte Endpunkte bereinigen und parametrisieren
  4. Optional: Import und Tests mit der CLI automatisieren

Für einen umfassenderen Überblick über Erfassungsworkflows siehe den Leitfaden zu Paket-Capture-Tools mit Apidog.

Sie können Apidog kostenlos herunterladen und die folgenden Schritte direkt nachvollziehen.

Was ist eine HAR-Datei?

HAR steht für HTTP Archive. Eine .har-Datei ist JSON und protokolliert die Interaktion eines Webbrowsers mit einer Website: Anfragen, Antworten, Header, Bodies und Timing-Daten.

Vereinfacht gesagt ist eine HAR-Datei eine vollständige Aufzeichnung einer Browsing-Sitzung:

  • GET-, POST-, PUT- und weitere HTTP-Anfragen
  • vollständige URLs und Query-Parameter
  • Request- und Response-Header
  • Request- und Response-Bodies
  • Statuscodes und Timing-Informationen

Da das Format JSON verwendet, können Sie die Datei weitergeben, an Fehlerberichte anhängen oder in Tools importieren.

Der entscheidende Vorteil: Eine HAR zeigt, wie eine API tatsächlich verwendet wird – nicht nur, wie sie laut Spezifikation funktionieren sollte.

Beim Import in Endpunkte erhalten Sie direkt:

  • Die echte Anfragesignatur: URL, Parameter, Header und Body aus einer realen Sitzung.
  • Eine echte Antwort: Statuscode und Payload als Grundlage für Mocks oder Testassertions.
  • Einen Dokumentationsstartpunkt: Undokumentierte oder interne APIs werden zu benannten Endpunkten.

Das ist besonders nützlich, wenn Sie:

  • einen Dienst ohne OpenAPI-Spezifikation übernehmen,
  • nachvollziehen möchten, wie ein Drittanbieter-Widget mit seinem Backend kommuniziert,
  • oder einen Fehler mit exakt dem Aufruf reproduzieren wollen, der ihn ausgelöst hat.

Schritt 1: HAR in den Browser-DevTools erfassen

Die Erfassung erfolgt im Browser, nicht in Apidog. Chrome und Edge verwenden vergleichbare DevTools.

Angenommen, Sie möchten den Datenverkehr einer Bestellhistorie-Seite erfassen.

  1. Öffnen Sie die Seite, deren Datenverkehr Sie aufzeichnen möchten.

    Melden Sie sich vorher an, falls die API eine Sitzung benötigt. Die HAR kann auch diese Authentifizierungsdaten enthalten.

  2. Öffnen Sie die Entwicklertools:

    • Windows/Linux: F12 oder Strg+Umschalt+I
    • macOS: Cmd+Opt+I

  3. Wechseln Sie zum Tab Netzwerk.

  4. Aktualisieren Sie die Seite oder führen Sie die gewünschte Aktion aus.

    Beim Laden einer Bestellhistorie könnten beispielsweise Aufrufe wie diese erscheinen:

   /api/orders
   /api/orders/123
   /api/orders/123/items
Enter fullscreen mode Exit fullscreen mode

  1. Klicken Sie mit der rechten Maustaste auf eine Anfragezeile und wählen Sie Alles als HAR mit Inhalt speichern.

  2. Speichern Sie die Datei, beispielsweise als:

   order-history.har
Enter fullscreen mode Exit fullscreen mode

Die Formulierung kann je nach Browser leicht variieren. Die Chrome-DevTools-Netzwerk-Referenz dokumentiert den Exportvorgang ebenfalls.

Warum „mit Inhalt“ wichtig ist

Wählen Sie unbedingt Alles als HAR mit Inhalt speichern.

Dadurch werden auch Response-Bodies exportiert. Ohne diese Inhalte enthält der Import zwar URLs, Header und Request-Metadaten, aber keine Beispielantworten für Mocks oder Tests.

Sie können die Datei kurz prüfen:

{
  "log": {
    "entries": [
      {
        "request": {},
        "response": {}
      }
    ]
  }
}
Enter fullscreen mode Exit fullscreen mode

Eine HAR enthält ein entries-Array. Jeder Eintrag besitzt typischerweise ein request- und ein response-Objekt.

Beachten Sie: Eine Seite lädt nicht nur API-Aufrufe, sondern auch Bilder, CSS, JavaScript und Tracking-Anfragen. Filtern Sie diese nicht zwingend im Browser – beim Import kann Apidog statische Ressourcen ausschließen.

Schritt 2: HAR in Apidog importieren

Nachdem Sie die .har-Datei gespeichert haben:

  1. Öffnen Sie Ihr Projekt in Apidog.
  2. Gehen Sie zu Einstellungen > Daten importieren > Manuell.
  3. Wählen Sie HAR als Format.
  4. Laden Sie Ihre Datei hoch, zum Beispiel order-history.har.

Vor dem Import zeigt Apidog Optionen an. Diese Einstellungen bestimmen, wie brauchbar die generierte Endpunktliste wird.

Option 1: BaseURL behandeln

Eine erfasste Anfrage enthält die vollständige URL:

https://api.shop.example.com/v1/orders/123
Enter fullscreen mode Exit fullscreen mode

Beim Import können Sie entscheiden, wie Apidog den Host behandelt.

  • Hardcodieren: Die vollständige BaseURL bleibt am Endpunkt.
  • Entfernen (Empfohlen): Der Host wird entfernt, und nur der Pfad bleibt erhalten.

Mit Entfernen wird aus:

https://api.shop.example.com/v1/orders/123
Enter fullscreen mode Exit fullscreen mode

dieser wiederverwendbare Pfad:

/v1/orders/123
Enter fullscreen mode Exit fullscreen mode

Verwalten Sie den Host stattdessen global über Umgebungsvariablen. Das erleichtert den Wechsel zwischen lokaler Entwicklung, Staging und Produktion.

Weitere Hinweise zur Verwaltung von BaseURLs finden Sie im Artikel über das Migrieren von Swagger-API-Dokumentation zu Apidog.

Empfehlung: Wählen Sie fast immer Entfernen. Hardcodieren ist nur sinnvoll, wenn jeder Endpunkt bewusst dauerhaft an exakt einen Host gebunden bleiben soll.

Option 2: Statische Ressourcen ausschließen

Aktivieren Sie bei Statische Ressource die Option Ausschließen.

So verhindert Apidog, dass nicht relevante Ressourcen als API-Endpunkte importiert werden, etwa:

/logo.png
/app.css
/main.js
/fonts/inter.woff2
Enter fullscreen mode Exit fullscreen mode

Nach dem Filter bleiben die eigentlichen API-Aufrufe übrig:

/api/orders
/api/orders/123
/api/users/me
Enter fullscreen mode Exit fullscreen mode

Empfehlung: Verwenden Sie Ausschließen bei fast jedem HAR-Import.

Option 3: Testfall pro Endpunkt generieren

Aktivieren Sie Endpunkt-Fallgenerierung, wenn Sie die importierten Aufrufe direkt testen möchten.

Apidog erstellt dann für jeden Endpunkt einen gespeicherten Testfall mit den Werten aus der Erfassung. Das spart Zeit, weil Sie Request-Header, Query-Parameter und Bodies nicht erneut eintragen müssen.

  • Aktivieren, wenn Sie direkt testen oder reproduzieren möchten.
  • Deaktivieren, wenn Sie zunächst nur dokumentieren möchten.

Bestätigen Sie anschließend den Import.

Apidog liest die HAR-Datei, wendet die gewählten Optionen an und erstellt Endpunkte in Ihrem Projekt.

Ein importierter Endpunkt könnte beispielsweise so aussehen:

GET /v1/orders/123
Host: api.shop.example.com
Authorization: Bearer <token-from-capture>
Accept: application/json
Enter fullscreen mode Exit fullscreen mode

Die zugehörige erfasste Antwort könnte so gespeichert werden:

{
  "id": 123,
  "status": "shipped",
  "total": 48.5,
  "currency": "USD",
  "items": [
    {
      "sku": "TSHIRT-BLK-M",
      "qty": 2,
      "price": 19.25
    }
  ],
  "createdAt": "2026-07-14T09:31:00Z"
}
Enter fullscreen mode Exit fullscreen mode

Da diese Antwort vom tatsächlichen Server stammt, eignet sie sich als Basis für Mock-Daten oder Testassertions.

Schritt 3: Generierte Endpunkte bereinigen

Ein HAR-Import ist ein schneller erster Durchlauf, keine fertige API-Definition. Planen Sie daher einige Minuten für die Bereinigung ein.

Nicht benötigte Anfragen löschen

Auch mit aktiviertem Filter für statische Ressourcen können unerwünschte Endpunkte erscheinen:

  • Analytics-Pings
  • Health Checks
  • Drittanbieter-APIs
  • Tracking-Endpunkte
  • Authentifizierungsaufrufe, die Sie nicht dokumentieren möchten

Löschen Sie alles, was nicht zu Ihrer eigentlichen API gehört.

Endpunkte umbenennen und gruppieren

Importierte Endpunkte werden oft nur nach ihrem Pfad benannt. Das ist technisch korrekt, aber unübersichtlich.

Statt:

GET /v1/orders/123
Enter fullscreen mode Exit fullscreen mode

verwenden Sie einen beschreibenden Namen wie:

Bestellung nach ID abrufen
Enter fullscreen mode Exit fullscreen mode

Organisieren Sie Endpunkte außerdem in Ordnern, beispielsweise:

Orders
├── Bestellungsliste abrufen
├── Bestellung nach ID abrufen
└── Bestellung aktualisieren

Users
├── Aktuellen Benutzer abrufen
└── Benutzerprofil aktualisieren
Enter fullscreen mode Exit fullscreen mode

Pfadparameter ersetzen

Eine HAR enthält konkrete Werte. Deshalb wird dieser Aufruf zunächst meist als fester Pfad importiert:

/v1/orders/123
Enter fullscreen mode Exit fullscreen mode

Wenn 123 eine Bestell-ID ist, ändern Sie den Pfad zu:

/v1/orders/{orderId}
Enter fullscreen mode Exit fullscreen mode

Damit wird aus einem einmalig erfassten Request ein wiederverwendbarer API-Endpunkt.

Geheimnisse entfernen

HAR-Dateien können sensible Daten enthalten:

  • Bearer-Tokens
  • Session-Cookies
  • API-Schlüssel
  • persönliche Daten aus Request- oder Response-Bodies

Ein importierter Header könnte beispielsweise so aussehen:

Authorization: Bearer eyJhbGciOi...
Enter fullscreen mode Exit fullscreen mode

Ersetzen Sie solche Werte durch Umgebungsvariablen:

Authorization: Bearer {{access_token}}
Enter fullscreen mode Exit fullscreen mode

Löschen Sie erfasste Geheimnisse aus gespeicherten Beispielen, bevor Sie das Projekt teilen, exportieren oder committen.

Die Stripe-Dokumentation zu API-Schlüsseln betont denselben Grundsatz: Live-Schlüssel gehören nicht in geteilte Artefakte. Eine HAR-Datei ist ein solches Artefakt.

Fehlende Bodies prüfen

Wenn Sie beim Import einen leeren Request- oder Response-Body sehen, wurde die HAR vermutlich ohne Inhalte exportiert.

Lösung:

  1. Öffnen Sie erneut die Browser-DevTools.
  2. Wiederholen Sie die gewünschte Aktion.
  3. Exportieren Sie mit Alles als HAR mit Inhalt speichern.
  4. Importieren Sie die Datei erneut.

Nach der Bereinigung können Sie die Endpunkte wie jeden anderen Endpunkt in Apidog dokumentieren, mocken und testen.

Weiterführende Anleitungen:

Variationen und Grenzen

Es gibt keinen automatischen Live-Recorder

Apidog zeichnet Browserdatenverkehr nicht automatisch im Hintergrund auf wie ein Proxy.

Der aktuell unterstützte Workflow lautet:

  1. Datenverkehr in den Browser-DevTools erfassen
  2. HAR-Datei exportieren
  3. HAR in Apidog importieren
  4. Endpunkte bereinigen
  5. Testszenario erstellen und Requests wiedergeben

Es handelt sich also um einen manuellen Erfassungsschritt mit anschließendem Import – nicht um einen Live-Recorder.

Die Apidog-Browser-Erweiterung ist ein anderes Tool

Es gibt eine Apidog-Browser-Erweiterung, aber sie dient nicht dazu, HAR-Datenverkehr aufzuzeichnen.

Die Erweiterung ermöglicht API-Tests und Debugging im Browser, ohne den Desktop-Client zu öffnen. Für die eigentliche Verkehrserfassung benötigen Sie weiterhin die DevTools und den HAR-Export.

Browser haben dabei Einschränkungen:

  • Bestimmte Header wie Cookie, Host, Origin und Content-Length können blockiert sein.
  • GET- und HEAD-Anfragen senden keine Bodies.
  • Lokale Dienste oder Datenbanken hinter Ihrem Rechner sind nicht immer erreichbar.

Wenn Sie volle Header-Kontrolle oder intensiveres Debugging benötigen, vermeiden Sie diese browserbedingten Einschränkungen mit dem Desktop-Client.

Andere Formate importieren

Der Bildschirm Einstellungen > Daten importieren > Manuell unterstützt neben HAR weitere Formate.

Wenn Sie bereits eine strukturierte Spezifikation besitzen, ist sie meist die bessere Importquelle:

  • OpenAPI
  • Swagger
  • Postman
  • WSDL
  • Insomnia

Weitere Migrationsanleitungen:

Nutzen Sie HAR vor allem dann, wenn keine API-Spezifikation existiert und der reale Browserdatenverkehr die beste verfügbare Dokumentation ist.

Workflow mit der Apidog CLI automatisieren

Der HAR-Import muss kein GUI-Schritt bleiben. Mit der Apidog CLI können Sie HAR-Dateien direkt per Kommandozeile importieren.

Installieren Sie die CLI und melden Sie sich an:

npm install -g apidog-cli
apidog login --with-token <YOUR_ACCESS_TOKEN>
Enter fullscreen mode Exit fullscreen mode

Importieren Sie anschließend eine HAR-Datei in ein Projekt:

# Eine erfasste HAR in Endpunkte importieren
apidog import --project <PROJECT_ID> --format har --file ./capture.har
Enter fullscreen mode Exit fullscreen mode

Das Flag --format unterstützt auch weitere Formate, darunter:

openapi
postman
wsdl
insomnia
Enter fullscreen mode Exit fullscreen mode

Sobald Sie aus den Endpunkten ein Testszenario erstellt haben, können Sie dieses in CI headless ausführen:

apidog run --access-token $APIDOG_ACCESS_TOKEN \
  -t <SCENARIO_ID> \
  -e <ENV_ID> \
  -r cli
Enter fullscreen mode Exit fullscreen mode

Dabei steht:

  • -t für die gespeicherte Test-Szenario-ID
  • -e für die Umgebungs-ID
  • -r cli für die Konsolenausgabe

Erstellen Sie zunächst ein Szenario mit dem Leitfaden zum Schreiben eines Testszenarios in Apidog. Anschließend können Sie den Import und die Ausführung mit dem Apidog CLI CI/CD-Leitfaden in Ihre Pipeline integrieren.

FAQ

Welche Browser können HAR-Dateien exportieren?

Chromium-basierte Browser wie Chrome und Edge unterstützen den Export über den Tab Netzwerk und den Menüpunkt Alles als HAR mit Inhalt speichern.

Andere Browser bieten ebenfalls HAR-Exporte an, die Menübezeichnung kann jedoch abweichen.

Meine importierte Endpunktliste ist riesig. Was ist passiert?

Wahrscheinlich wurden statische Ressourcen mit importiert.

Importieren Sie die HAR erneut und setzen Sie Statische Ressource auf Ausschließen. Dadurch werden Bilder, CSS und JavaScript-Dateien übersprungen.

Löschen Sie anschließend verbleibende Analytics-, Tracking- oder Drittanbieter-Aufrufe manuell.

Soll ich für die BaseURL „Hardcodieren“ oder „Entfernen“ wählen?

Wählen Sie in den meisten Fällen Entfernen (Empfohlen).

So bleibt der Endpunktportabel:

/v1/orders/{orderId}
Enter fullscreen mode Exit fullscreen mode

Die tatsächliche BaseURL verwalten Sie dann über die Umgebung, etwa für lokale Entwicklung, Staging und Produktion.

Wählen Sie Hardcodieren nur, wenn Sie vollständige URLs bewusst in jedem Endpunkt speichern möchten.

Enthält die HAR meine Authentifizierungstoken?

Ja. Eine HAR zeichnet die Header auf, die während der Sitzung gesendet wurden. Dazu können Bearer-Tokens, Cookies und API-Schlüssel gehören.

Behandeln Sie HAR-Dateien deshalb wie sensible Daten:

  • Nicht in öffentliche Issues hochladen
  • Nicht ungeprüft weitergeben
  • Tokens nach dem Import in Umgebungsvariablen verschieben
  • Geheimnisse aus gespeicherten Beispielen entfernen

Kann ich die GUI überspringen und HAR per CLI importieren?

Ja:

apidog import --project <id> --format har --file <path>
Enter fullscreen mode Exit fullscreen mode

Das eignet sich besonders für:

  • automatisierte Imports
  • Server-Workflows
  • CI-Jobs
  • agentengesteuerte Prozesse

Die GUI bleibt sinnvoll, wenn Sie die Importoptionen wie BaseURL-Behandlung und Filterung statischer Ressourcen interaktiv anpassen möchten.

Nach dem Import können Sie erstellte Testszenarien mit apidog run ausführen.

Zusammenfassung

Eine HAR-Datei verbindet sichtbaren Browserdatenverkehr mit wiederverwendbaren API-Endpunkten.

Der praktische Workflow:

  1. Sitzung in den Browser-DevTools erfassen.
  2. Alles als HAR mit Inhalt speichern auswählen.
  3. Datei über Einstellungen > Daten importieren > Manuell importieren.
  4. Für die BaseURL Entfernen wählen.
  5. Statische Ressource auf Ausschließen setzen.
  6. Endpunkte umbenennen, gruppieren und parametrisieren.
  7. Tokens und andere Geheimnisse in Umgebungsvariablen verschieben.
  8. Optional Testszenarien erstellen und per CLI in CI ausführen.

Das Ergebnis ist ein funktionierender Satz realitätsnaher Endpunkte, den Sie dokumentieren, mocken und testen können.

Bereit, Ihre nächste Erfassung in Endpunkte umzuwandeln? Laden Sie Apidog herunter und testen Sie es kostenlos.

Top comments (0)