DEV Community

Cover image for Wie Postman Collections nach Sperrung wiederherstellen
Emre Demir
Emre Demir

Posted on • Originally published at apidog.com

Wie Postman Collections nach Sperrung wiederherstellen

TL;DR

Wenn die Änderung des kostenlosen Postman-Tarifs Ihren Zugang zu geteilten Sammlungen unterbrochen hat, sind Ihre Daten nicht unbedingt verloren. Handeln Sie schnell, bevor lokale Caches geleert werden. Gehen Sie der Reihe nach vor: Desktop-Cache prüfen, vorhandene Exporte suchen, Workspace-Admin kontaktieren, Postman API nutzen und die wiederhergestellten Daten anschließend in Apidog importieren.

Teste Apidog noch heute

Einleitung

Nach dem Update des kostenlosen Postman-Tarifs im 1. Quartal 2026 berichteten viele Entwickler, dass sie keinen Zugriff mehr auf gemeinsam genutzte Workspaces hatten. Sammlungen, Umgebungen und organisierte API-Requests lagen plötzlich in Team-Workspaces, die nicht mehr erreichbar waren.

Ein Entwickler beschrieb es auf Reddit sinngemäß so: Der gesamte Team-Workspace war nach dem Wochenende verschwunden, inklusive mehrerer Monate Arbeit, außer das Team zahlt.

Wichtig ist: In vielen Fällen sind die Daten nicht sofort gelöscht. Postman hält Workspace-Daten serverseitig vor. Die Sperre ist meist eine Zugriffsbeschränkung, keine unmittelbare Löschung. Deshalb zählt Geschwindigkeit: Je früher Sie exportieren oder aus dem Cache sichern, desto höher ist die Chance auf Wiederherstellung.

1. Prüfen Sie zuerst den Cache der Postman Desktop-App

Öffnen Sie zuerst die Postman Desktop-App, nicht die Web-App.

Die Desktop-App speichert lokal zwischengespeicherte Daten zu zuletzt verwendeten Sammlungen, Umgebungen und Requests. Auch wenn der serverseitige Zugriff eingeschränkt wurde, können Teile Ihrer Daten noch lokal vorhanden sein.

Vorgehen

  1. Öffnen Sie Postman Desktop.
  2. Verwenden Sie nicht direkt app.getpostman.com.
  3. Prüfen Sie den Tab History auf aktuelle Requests.
  4. Prüfen Sie die linke Seitenleiste auf vorhandene Collections.
  5. Exportieren Sie jede sichtbare Collection sofort.

Export:

  1. Rechtsklick auf die Collection oder Drei-Punkte-Menü öffnen.
  2. Export auswählen.
  3. Format Collection v2.1 wählen.
  4. JSON-Datei lokal speichern.
  5. Für jede Collection wiederholen.

Wenn Collections sichtbar sind, der Export aber fehlschlägt, versuchen Sie den Offline-Modus:

  1. Klicken Sie oben rechts auf Ihren Avatar.
  2. Wählen Sie Go offline / Offline gehen.
  3. Versuchen Sie erneut, die Collection zu exportieren.

Ziel ist, die Synchronisierung mit dem Server zu unterbrechen und lange genug Lesezugriff auf zwischengespeicherte Daten zu behalten.

2. Suchen Sie nach vorhandenen Exportdateien

Bevor Sie Collections manuell rekonstruieren, prüfen Sie alle typischen Speicherorte für frühere Exporte.

Downloads-Ordner

Suchen Sie nach JSON-Dateien:

find ~/Downloads -iname "*.json"
Enter fullscreen mode Exit fullscreen mode

Postman-Collection-Exporte enthalten typischerweise Felder wie:

{
  "info": {
    "name": "API Collection",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": []
}
Enter fullscreen mode Exit fullscreen mode

Git-Repository

Viele Teams committen Postman-Collections zusammen mit dem Code. Suchen Sie im Repository nach JSON-Dateien oder Postman-Schemas:

find . -iname "*.json" | xargs grep -l "schema.getpostman.com" 2>/dev/null
Enter fullscreen mode Exit fullscreen mode

Oder im Git-Verlauf:

git log --all --name-only --pretty=format: | grep -iE "postman|collection|environment|\.json" | sort -u
Enter fullscreen mode Exit fullscreen mode

Wenn Dateien früher existierten, aber gelöscht wurden:

git log --all -- <pfad-zur-datei>
Enter fullscreen mode Exit fullscreen mode

Dann einen alten Stand wiederherstellen:

git checkout <commit-hash> -- <pfad-zur-datei>
Enter fullscreen mode Exit fullscreen mode

E-Mails

Suchen Sie nach Anhängen oder Betreffzeilen wie:

  • postman
  • collection
  • .json
  • environment
  • api collection

Geteilte Laufwerke

Prüfen Sie:

  • Google Drive
  • Dropbox
  • OneDrive
  • interne Team-Shares
  • Slack- oder Teams-Dateien

Oft hat jemand eine Collection exportiert, ohne sie zentral zu dokumentieren.

CI/CD-Konfiguration

Wenn Ihr Team Newman verwendet hat, liegt die Collection sehr wahrscheinlich im Repository oder als Pipeline-Artefakt vor.

Suchen Sie nach Newman-Referenzen:

grep -R "newman" . 2>/dev/null
Enter fullscreen mode Exit fullscreen mode

Typische Dateien:

.github/workflows/*.yml
.gitlab-ci.yml
Jenkinsfile
circle.yml
package.json
Enter fullscreen mode Exit fullscreen mode

Beispiel:

- run: newman run collections/api.postman_collection.json
Enter fullscreen mode Exit fullscreen mode

Wenn Sie so einen Pfad finden, sichern Sie die referenzierte JSON-Datei.

3. Kontaktieren Sie den Workspace-Inhaber oder Administrator

Wenn Sie Mitglied eines Team-Workspaces waren, hat der Workspace-Inhaber möglicherweise weiterhin Zugriff. Das gilt insbesondere, wenn der Inhaber auf einen kostenpflichtigen Plan gewechselt ist oder das Konto anders eingestuft wurde.

Bitten Sie den Inhaber oder Admin konkret um diese Schritte:

  1. In Postman anmelden.
  2. Den betroffenen Workspace öffnen.
  3. Jede Collection über das Drei-Punkte-Menü exportieren.
  4. Format Collection v2.1 wählen.
  5. JSON-Dateien an Sie senden.
  6. Falls vorhanden: auch Environments exportieren.

Wenn der Inhaber ebenfalls keinen Zugriff mehr hat, fragen Sie alle Teammitglieder, ob sie die Postman Desktop-App genutzt haben. Jedes Teammitglied sollte den Cache-Check aus Abschnitt 1 durchführen.

4. Nutzen Sie die Postman API zum Export

Wenn Sie noch einen gültigen Postman API-Key haben, können Sie Collections und Environments direkt über die Postman API abrufen.

Prüfen Sie zuerst, ob ein API-Key noch vorhanden ist:

  • Passwortmanager
  • .env-Dateien
  • CI/CD-Secrets
  • lokale Shell-History
  • Projekt-Dokumentation

Beispielsuche in Projektdateien:

grep -R "POSTMAN_API_KEY\|x-api-key\|api.getpostman.com" . 2>/dev/null
Enter fullscreen mode Exit fullscreen mode

Collections auflisten 

curl --request GET "https://api.getpostman.com/collections" \
  --header "x-api-key: YOUR_POSTMAN_API_KEY"
Enter fullscreen mode Exit fullscreen mode

Die Antwort enthält Collection-IDs. Danach jede Collection einzeln exportieren:

curl --request GET "https://api.getpostman.com/collections/COLLECTION_ID" \
  --header "x-api-key: YOUR_POSTMAN_API_KEY" \
  --output collection-COLLECTION_ID.json
Enter fullscreen mode Exit fullscreen mode

Environments auflisten 

curl --request GET "https://api.getpostman.com/environments" \
  --header "x-api-key: YOUR_POSTMAN_API_KEY"
Enter fullscreen mode Exit fullscreen mode

Environment exportieren:

curl --request GET "https://api.getpostman.com/environments/ENVIRONMENT_ID" \
  --header "x-api-key: YOUR_POSTMAN_API_KEY" \
  --output environment-ENVIRONMENT_ID.json
Enter fullscreen mode Exit fullscreen mode

Dieser Weg funktioniert nur, solange der API-Key noch aktiv ist. Führen Sie die Exporte daher sofort aus.

5. Rekonstruieren Sie Daten aus Logs, Cache oder Spezifikationen

Wenn kein Export, kein Admin-Zugriff und kein API-Key verfügbar ist, bleibt nur eine teilweise Rekonstruktion.

Browser-Cache prüfen

Wenn Sie die Postman Web-App kürzlich genutzt haben:

  1. Chrome öffnen.
  2. DevTools mit F12 öffnen.
  3. Zu Application wechseln.
  4. Cache Storage prüfen.
  5. Nach Postman-API-Antworten suchen.

Das liefert wahrscheinlich keine vollständige Collection-Struktur, kann aber Request-URLs, Methoden oder Metadaten enthalten.

Server-Logs auswerten

Wenn Sie Zugriff auf die Server haben, gegen die Postman getestet hat, prüfen Sie Access Logs.

Beispiel für Nginx:

grep "POST\|PUT\|PATCH\|DELETE\|GET" /var/log/nginx/access.log
Enter fullscreen mode Exit fullscreen mode

Damit können Sie rekonstruieren:

  • HTTP-Methode
  • Pfad
  • Query-Parameter
  • Zeitpunkte
  • teilweise Header, abhängig vom Logging

Nicht enthalten sind normalerweise:

  • Postman-Testskripte
  • vollständige Request-Bodies
  • Collection-Ordnerstruktur
  • Environment-Variablen

OpenAPI oder Swagger verwenden

Falls Ihre API eine Spezifikation besitzt, nutzen Sie diese als Grundlage:

  • openapi.yaml
  • openapi.json
  • swagger.json

Diese Dateien können Sie in API-Tools importieren, um Endpunkte, Parameter und Response-Schemas neu aufzubauen.

6. Importieren Sie wiederhergestellte Collections in Apidog

Sobald Sie Postman-Collection-JSON-Dateien haben, importieren Sie diese in Apidog.

  1. Laden Sie die Apidog Desktop-App herunter oder öffnen Sie die Webversion.
  2. Erstellen Sie ein neues Projekt.
  3. Klicken Sie in der linken Seitenleiste auf Importieren.
  4. Wählen Sie Postman als Importquelle.
  5. Laden Sie die exportierte Collection-JSON-Datei hoch.
  6. Wiederholen Sie den Vorgang für jede Collection.

Für Environments:

  1. Öffnen Sie denselben Import-Workflow.
  2. Wählen Sie Postman Environment als Quelltyp.
  3. Laden Sie die Environment-JSON-Datei hoch.

Nach dem Import können Sie Teammitglieder einladen. Im kostenlosen Plan von Apidog können bis zu 3 Benutzer einen Workspace teilen. Ihre Collections werden teamweit synchronisiert, ohne zusätzliche Gebühren pro Benutzer.

7. Verhindern Sie, dass das erneut passiert

Das eigentliche Risiko entsteht, wenn API-Collections nur in einem serverseitigen Workspace liegen und der Zugriff durch Abrechnung oder Planänderungen eingeschränkt wird.

Apidog speichert Collections standardmäßig lokal. Cloud-Synchronisierung ist optional. Dadurch bleiben Ihre Daten auf Ihrem Rechner verfügbar, auch wenn sich externe Rahmenbedingungen ändern.

Unabhängig vom Tool sollten Sie zusätzlich eine einfache Backup-Routine einführen.

Empfohlene Routine

Am Ende jedes Sprints:

  1. Collections als JSON exportieren.
  2. Environment-Dateien ohne Secrets exportieren.
  3. Dateien im Repository versionieren.
  4. Secrets separat im Secret Manager oder CI/CD-System speichern.

Beispielstruktur:

docs/
  api/
    postman/
      collections/
        users-api.postman_collection.json
        billing-api.postman_collection.json
      environments/
        local.postman_environment.json
        staging.postman_environment.json
Enter fullscreen mode Exit fullscreen mode

Beispiel .gitignore, falls lokale Dateien Secrets enthalten:

*.local.postman_environment.json
*.secret.json
.env
Enter fullscreen mode Exit fullscreen mode

Optional können Sie einen CI-Check ergänzen, der sicherstellt, dass Collection-Dateien weiterhin vorhanden sind:

test -f docs/api/postman/collections/users-api.postman_collection.json
Enter fullscreen mode Exit fullscreen mode

So vermeiden Sie, dass kritische API-Artefakte nur in einem Tool-Workspace existieren.

Fazit

Wenn Sie durch eine Postman-Planänderung den Zugriff auf geteilte Collections verloren haben, gehen Sie strukturiert vor: Desktop-Cache prüfen, Exporte suchen, Admin kontaktieren, Postman API verwenden und notfalls aus Logs oder OpenAPI-Spezifikationen rekonstruieren.

Sobald Sie die JSON-Dateien gesichert haben, importieren Sie sie in ein Tool, bei dem Sie mehr Kontrolle über lokale Daten und Exporte behalten. Wichtig ist nicht nur die Migration, sondern auch die neue Gewohnheit: API-Collections regelmäßig exportieren, versionieren und unabhängig vom Tool sichern.

Top comments (0)