DEV Community

Cover image for Récupérer ses collections Postman après un accès bloqué
Antoine Laurent
Antoine Laurent

Posted on • Originally published at apidog.com

Récupérer ses collections Postman après un accès bloqué

En bref

Si le changement du plan gratuit de Postman a coupé votre accès aux collections partagées, vos données ne sont pas forcément perdues. Commencez par récupérer ce qui est encore disponible localement, puis exportez tout ce que vous pouvez avant que le cache ou les accès API ne disparaissent. Ce guide liste les actions à exécuter, dans l’ordre, puis explique comment importer les collections récupérées dans Apidog.

Essayez Apidog aujourd’hui

Introduction

Après la mise à jour du niveau gratuit de Postman au T1 2026, plusieurs développeurs utilisant des espaces de travail partagés ont perdu l’accès à leurs collections d’équipe. Les collections stockées dans des workspaces partagés, plutôt que dans des espaces personnels, se sont retrouvées bloquées derrière une restriction liée au plan.

Un développeur l’a résumé sur Reddit : « Je suis arrivé lundi et tout mon espace de travail d’équipe avait disparu. Trois mois de collections organisées, d’environnements, tout. Tout simplement disparu à moins de payer. »

Le point important : les données ne sont pas nécessairement supprimées. Dans beaucoup de cas, il s’agit d’une restriction d’accès côté serveur. Vous avez donc une fenêtre courte pour récupérer vos collections via le cache local, les exports existants, l’API Postman ou un administrateur d’espace de travail.

1. Vérifiez d’abord le cache de l’application de bureau Postman

Commencez par l’application de bureau Postman. N’ouvrez pas la version web.

L’application desktop peut conserver un cache local des collections, environnements et requêtes récemment consultés. Même si l’accès serveur est révoqué, ce cache peut encore contenir des données exploitables pendant quelques jours.

Étapes

  1. Ouvrez l’application de bureau Postman.
  2. N’utilisez pas l’application web sur app.getpostman.com.
  3. Consultez l’onglet Historique pour retrouver les requêtes récentes.
  4. Vérifiez la barre latérale gauche pour voir si vos collections apparaissent encore.
  5. Si une collection est visible, exportez-la immédiatement.

Exporter une collection visible

Dans la barre latérale :

  1. Faites un clic droit sur la collection, ou cliquez sur le menu ....
  2. Sélectionnez Exporter.
  3. Choisissez le format Collection v2.1.
  4. Enregistrez le fichier .json.
  5. Répétez pour chaque collection visible.

Si la collection est visible mais que l’export échoue, essayez de passer hors ligne :

  1. Cliquez sur votre avatar en haut à droite.
  2. Sélectionnez Travailler hors ligne.
  3. Réessayez l’export.

L’objectif est d’empêcher l’application de resynchroniser immédiatement son état avec le serveur et de vous laisser accéder aux données mises en cache.

2. Recherchez des exports Postman existants

Avant de reconstruire vos collections manuellement, cherchez des fichiers déjà exportés. Beaucoup d’équipes exportent ponctuellement leurs collections pour les partager ou les sauvegarder.

Dossier de téléchargements

Recherchez des fichiers .json.

Les exports Postman sont des fichiers JSON qui contiennent généralement une structure reconnaissable, par exemple :

{
  "collection": {
    "info": {},
    "item": []
  }
}
Enter fullscreen mode Exit fullscreen mode

Dépôt Git du projet

Vérifiez :

  • le répertoire principal du projet ;
  • les dossiers docs/, postman/, collections/, api/ ;
  • l’historique Git ;
  • les anciennes branches.

Exemples de commandes utiles :

find . -iname "*postman*.json"
find . -iname "*collection*.json"
Enter fullscreen mode Exit fullscreen mode

Pour rechercher dans l’historique Git :

git log --all --name-only | grep -i "postman\|collection"
Enter fullscreen mode Exit fullscreen mode

E-mails

Cherchez des pièces jointes .json envoyées par des collègues.

Requêtes utiles dans votre client mail :

filename:json postman
filename:json collection
Enter fullscreen mode Exit fullscreen mode

Lecteurs partagés

Vérifiez les espaces utilisés par l’équipe :

  • Google Drive ;
  • Dropbox ;
  • OneDrive ;
  • dossiers partagés internes ;
  • archives de documentation.

Pipelines CI/CD

Si votre équipe utilisait Newman ou un autre runner Postman dans CI/CD, la collection était probablement stockée dans le dépôt ou référencée dans une configuration.

Vérifiez notamment :

  • .github/workflows/*.yml
  • Jenkinsfile
  • .circleci/config.yml
  • .gitlab-ci.yml
  • fichiers .json utilisés comme artefacts.

Cherchez les références à Newman :

grep -R "newman" .
grep -R "postman" .
grep -R "collection" .
Enter fullscreen mode Exit fullscreen mode

3. Contactez le propriétaire ou l’administrateur du workspace

Si vous étiez membre d’un espace de travail appartenant à une autre équipe, le propriétaire peut encore avoir accès aux collections.

Demandez-lui de :

  1. Se connecter à son compte Postman.
  2. Ouvrir le workspace concerné.
  3. Exporter chaque collection via le menu ....
  4. Exporter aussi les environnements.
  5. Vous envoyer les fichiers JSON.

Si le propriétaire n’a plus accès au workspace, demandez à chaque membre de l’équipe de vérifier son application desktop Postman. Une autre machine peut encore contenir les collections dans son cache local.

4. Utilisez l’API Postman pour exporter les données restantes

Si vous avez encore une clé API Postman valide, vous pouvez tenter d’exporter les collections et environnements par API.

Cette méthode fonctionne uniquement tant que la clé API reste active. Exécutez ces requêtes rapidement.

Lister les collections 

GET https://api.getpostman.com/collections
x-api-key: YOUR_POSTMAN_API_KEY
Enter fullscreen mode Exit fullscreen mode

Avec curl :

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

La réponse contient les IDs de collections.

Récupérer une collection par ID 

GET https://api.getpostman.com/collections/{collection_id}
x-api-key: YOUR_POSTMAN_API_KEY
Enter fullscreen mode Exit fullscreen mode

Avec curl :

curl 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

Répétez l’opération pour chaque collection.

Exporter les environnements

Listez les environnements :

GET https://api.getpostman.com/environments
x-api-key: YOUR_POSTMAN_API_KEY
Enter fullscreen mode Exit fullscreen mode

Puis récupérez chaque environnement :

GET https://api.getpostman.com/environments/{environment_id}
x-api-key: YOUR_POSTMAN_API_KEY
Enter fullscreen mode Exit fullscreen mode

Avec curl :

curl 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

Si vous ne retrouvez pas votre clé API, vérifiez :

  • les fichiers .env du projet ;
  • les variables d’environnement CI/CD ;
  • les secrets GitHub Actions, GitLab CI ou Jenkins ;
  • votre gestionnaire de mots de passe ;
  • les scripts internes utilisant Newman ou l’API Postman.

5. Reconstruisez à partir des journaux réseau ou serveur

Si vous n’avez ni export, ni cache, ni accès API, vous pouvez encore reconstruire une partie de vos collections à partir de traces existantes.

Cache navigateur

Si vous avez utilisé récemment l’application web Postman :

  1. Ouvrez Chrome.
  2. Appuyez sur F12.
  3. Allez dans Application.
  4. Ouvrez Cache Storage.
  5. Recherchez des réponses liées à l’API Postman.

Vous ne récupérerez probablement pas une collection complète, mais vous pouvez retrouver des détails de requêtes : endpoints, méthodes, en-têtes ou fragments de payload.

Journaux d’accès serveur

Si vos requêtes Postman appelaient vos propres API, vos logs serveur peuvent aider à reconstruire la structure.

Recherchez :

  • méthodes HTTP : GET, POST, PUT, PATCH, DELETE ;
  • chemins d’API ;
  • codes de statut ;
  • en-têtes ;
  • paramètres de requête.

Exemple avec des logs Nginx :

grep "/api/" /var/log/nginx/access.log | awk '{print $6, $7}' | sort | uniq
Enter fullscreen mode Exit fullscreen mode

Cela ne restaure pas les scripts de test Postman ni les corps de requêtes, mais permet de reconstituer les endpoints principaux.

Spécifications OpenAPI ou Swagger

Si votre API dispose d’une spécification :

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

vous pouvez l’importer dans Apidog ou un autre outil pour recréer la structure des endpoints, paramètres et schémas documentés.

6. Importez les collections récupérées dans Apidog

Une fois vos fichiers JSON récupérés, vous pouvez les importer dans Apidog.

  1. Téléchargez et installez l’application de bureau Apidog, ou ouvrez la version web.
  2. Créez un nouveau projet.
  3. Dans le projet, cliquez sur Importer dans la barre latérale gauche.
  4. Sélectionnez Postman comme source.
  5. Importez votre fichier JSON de collection.
  6. Répétez pour chaque collection.

Pour les environnements :

  1. Ouvrez le même flux d’import.
  2. Sélectionnez Environnement Postman comme type de source.
  3. Importez le fichier JSON d’environnement.
  4. Vérifiez les variables après import, surtout si certaines contiennent des secrets.

Après l’import, invitez vos coéquipiers. Sur le plan gratuit d’Apidog, jusqu’à 3 utilisateurs peuvent partager un espace de travail. Vos collections se synchronisent entre les membres de l’équipe sans frais par siège.

7. Évitez que le problème se reproduise

Le problème principal vient du fait que vos collections étaient stockées côté serveur et que l’accès a ensuite été limité par le plan. Pour réduire ce risque, gardez toujours une copie exportée et versionnée de vos collections.

Apidog stocke les collections localement par défaut. La synchronisation cloud est facultative. Si un changement de tarification intervient, vos données restent déjà disponibles sur votre machine.

Quel que soit l’outil utilisé, mettez en place une routine simple.

À chaque sprint

Exportez les collections au format JSON :

project/
  api/
    collections/
      user-api.postman_collection.json
      billing-api.postman_collection.json
Enter fullscreen mode Exit fullscreen mode

Dans Git

Commitez les collections dans le dépôt :

git add api/collections/*.json
git commit -m "chore: backup API collections"
Enter fullscreen mode Exit fullscreen mode

Pour les environnements

Stockez une version sans secrets :

{
  "name": "dev",
  "values": [
    {
      "key": "base_url",
      "value": "https://api.example.com",
      "type": "default"
    },
    {
      "key": "api_key",
      "value": "REPLACE_ME",
      "type": "secret"
    }
  ]
}
Enter fullscreen mode Exit fullscreen mode

Ne commitez jamais de tokens, clés API ou mots de passe réels.

Conclusion

Si vous avez perdu l’accès à un workspace Postman partagé, commencez par le cache de l’application desktop, puis cherchez les exports existants, contactez l’administrateur du workspace et tentez l’API Postman si vous avez encore une clé active.

Une fois les fichiers récupérés, importez-les dans Apidog et mettez en place une sauvegarde régulière dans Git. Cela transforme une dépendance fragile à un workspace distant en un workflow plus contrôlable, versionné et récupérable.

Top comments (0)