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

En bref

Si le changement de plan gratuit de Postman a coupé votre accès aux collections partagées, vos données ne sont pas nécessairement perdues, mais vous devez agir rapidement avant que le cache local ne soit vidé. Ce guide détaille tous les chemins de récupération possibles, du cache de l'application locale aux fichiers d'exportation en passant par la récupération par l'administrateur d'équipe, et vous montre comment migrer ce que vous récupérez vers Apidog afin de ne plus jamais vous retrouver dans cette situation.

Introduction

Les plaintes sont rapidement apparues. Après la mise à jour du niveau gratuit de Postman au T1 2026, les développeurs qui partageaient des espaces de travail avec des collègues se sont retrouvés bloqués. L'espace de travail partagé est devenu inaccessible. Les collections qui se trouvaient dans des espaces de travail d'équipe, et non personnels, sont soudainement passées derrière un mur payant.

Un développeur l'a décrit 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. »

Ce qui est frustrant, c'est que les données ne sont pas réellement supprimées. L'architecture de Postman conserve les données de l'espace de travail côté serveur, et le blocage est une restriction d'accès, pas une suppression. Mais cette distinction n'importe que si vous savez comment la contourner avant l'expiration du cache ou le nettoyage de l'espace de travail.

Vérifiez d'abord le cache de votre application de bureau Postman

Avant toute autre chose, ouvrez l'application de bureau Postman si vous l'avez installée. N'ouvrez pas la version web.

L'application de bureau stocke un cache local de vos collections et environnements les plus récemment consultés. Même si l'accès côté serveur est révoqué, le cache peut encore contenir vos données de collection pendant une courte période, généralement de quelques jours à une semaine, selon votre système et la façon dont Postman gère l'invalidation du cache.

Étapes à vérifier :

1. Ouvrez l'application de bureau Postman (pas l'application web sur app.getpostman.com).
2. Recherchez dans votre onglet Historique les requêtes récentes. Celles-ci ne contiennent pas la structure complète de la collection, mais elles confirment les points de terminaison avec lesquels vous travailliez.
3. Vérifiez si vos collections apparaissent toujours dans la barre latérale gauche. Si c'est le cas, exportez-les immédiatement.

Pour exporter depuis la barre latérale : faites un clic droit ou cliquez sur le menu à trois points sur une collection, sélectionnez « Exporter », et enregistrez au format Collection v2.1. Faites cela pour chaque collection que vous pouvez encore voir.

Si les collections apparaissent mais que vous obtenez une erreur lors de l'exportation, essayez de travailler hors ligne. Dans Postman, allez en haut à droite et cliquez sur votre avatar, puis sur « Travailler hors ligne ». L'application cessera d'essayer de se synchroniser avec le serveur et pourra vous donner un accès en lecture aux données mises en cache suffisamment longtemps pour exporter.

Recherchez les fichiers d'exportation existants

De nombreux développeurs exportent périodiquement les collections Postman pour les sauvegarder ou les partager avec des collègues. Vérifiez ces emplacements avant de supposer que tout est perdu.

Votre dossier de téléchargements. Recherchez les fichiers .json. Les exportations de collections Postman utilisent le format JSON avec une structure reconnaissable contenant une clé "collection" au niveau supérieur.

Le dépôt Git de votre projet. Certaines équipes committent les fichiers JSON des collections Postman aux côtés de leur base de code. Vérifiez l'historique de votre dépôt, y compris les commits plus anciens, pour tout fichier .json qui ressemble à une collection.

Votre e-mail. Si un collègue vous a déjà partagé une collection en exportant et en envoyant le fichier par e-mail, vérifiez votre e-mail pour les pièces jointes .json.

Lecteurs partagés. Vérifiez Dropbox, Google Drive ou tout dossier partagé utilisé par votre équipe. Quelqu'un a peut-être exporté une sauvegarde de collection sans en informer tout le monde.

Fichiers de pipeline CI/CD. Si votre équipe utilisait le runner CLI Newman de Postman dans un pipeline CI (Jenkins, GitHub Actions, CircleCI), le JSON de la collection était probablement intégré au dépôt ou stocké comme artefact de pipeline. Vérifiez vos fichiers de configuration de pipeline .yml ou .json pour les références aux fichiers de collection.

Contactez le propriétaire ou l'administrateur de l'espace de travail

Si vous étiez membre de l'espace de travail d'une autre équipe, le propriétaire de l'espace de travail peut toujours avoir un accès complet s'il est le seul utilisateur du compte ou s'il est passé à un plan payant.

Contactez directement le propriétaire de l'espace de travail et demandez-lui de :

1. Se connecter à leur compte Postman.
2. Naviguer vers l'espace de travail que vous avez partagé.
3. Exporter chaque collection via le menu à trois points.
4. Vous envoyer les fichiers JSON exportés.

Si le compte du propriétaire est également rétrogradé ou inaccessible, vérifiez si quelqu'un de votre équipe a les collections de l'espace de travail mises en cache localement (en utilisant les étapes de la section précédente).

Utilisez l'API Postman pour récupérer vos données

Si vous avez toujours accès à l'API (même en lecture seule), l'API Postman vous permet d'exporter programmatiquement vos collections et environnements avant que votre fenêtre d'accès ne se ferme.

Vous avez besoin d'une clé API Postman valide. Si vous en avez toujours une d'avant le changement de plan :

Obtenez la liste de vos collections :

GET https://api.getpostman.com/collections
x-api-key: YOUR_POSTMAN_API_KEY

Ensuite, récupérez chaque collection par ID :

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

Le corps de la réponse contient votre collection complète au format JSON. Enregistrez chacune d'elles dans un fichier .json.

Pour les environnements :

GET https://api.getpostman.com/environments
GET https://api.getpostman.com/environments/{environment_id}

Cette approche fonctionne tant que votre clé API est toujours active. L'accès par clé API peut persister brièvement après la révocation de l'accès à l'interface utilisateur, mais ne comptez pas sur sa durée. Exécutez ces requêtes dès que possible.

Si vous n'avez pas votre clé API stockée, vérifiez les fichiers .env de votre projet, les configurations de variables d'environnement CI/CD ou les gestionnaires de mots de passe.

Reconstruire à partir des journaux réseau du navigateur ou des journaux de serveur

Si aucune des options ci-dessus ne fonctionne et que vous n'avez véritablement ni exportation ni cache, vous pourrez peut-être reconstruire partiellement vos collections à partir d'autres sources.

Journaux réseau du navigateur. Si vous avez récemment utilisé l'application web Postman, votre navigateur peut avoir mis en cache des réponses. Dans Chrome, allez dans les Outils de développement (F12), puis Application > Cache Storage. Recherchez les réponses de l'API Postman mises en cache. Il est peu probable que cela contienne des collections structurées complètes, mais cela peut avoir des détails de requête.

Journaux d'accès au serveur. Si votre équipe a exécuté les API que Postman testait, les journaux d'accès de votre serveur montreront chaque point de terminaison qui a été appelé, avec les méthodes, les chemins et parfois les en-têtes. Cela ne vous donne pas les corps de requête ou les scripts de test, mais cela vous donne la structure des points de terminaison pour reconstruire l'organisation de la collection.

Spécifications OpenAPI/Swagger. Si votre API possède une spécification OpenAPI (un fichier swagger.json ou openapi.yaml), vous pouvez l'importer directement dans Apidog ou un autre outil pour recréer la structure de la collection avec des points de terminaison, des paramètres et des schémas de réponse documentés.

Importez vos collections récupérées dans Apidog

Une fois que vous avez vos fichiers JSON de collection, les importer dans Apidog prend environ deux minutes.

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 d'importation.
5. Téléchargez votre fichier JSON de collection.
6. Répétez l'opération pour chaque collection.

Pour les environnements : importez-les séparément en utilisant le même flux d'importation, en sélectionnant « Environnement Postman » comme type de source.

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

Empêchez que cela ne se reproduise

Le problème central est que Postman a stocké vos collections côté serveur et en a limité l'accès derrière la facturation. Vous pouvez éviter ce problème entièrement en choisissant des outils qui conservent vos données localement ou qui vous donnent une propriété d'exportation claire.

Apidog stocke les collections localement par défaut. La synchronisation cloud est facultative, pas obligatoire. Si un changement de prix survient un jour, vos données sont déjà sur votre machine.

Quel que soit l'outil que vous utilisez à l'avenir, prenez l'habitude d'exporter régulièrement :

• Exportez vos collections au format JSON à la fin de chaque sprint.
• Commitez les fichiers JSON de collection dans votre dépôt Git aux côtés de votre base de code.
• Stockez les fichiers d'environnement (avec les secrets supprimés) dans la documentation de développement de votre dépôt.

Ces habitudes prennent cinq minutes à mettre en place et éliminent entièrement le scénario de « blocage ».

Perdre l'accès aux outils dont vous dépendez sans avertissement est une expérience frustrante, et le changement de niveau gratuit de Postman a pris de nombreuses équipes au dépourvu. La bonne nouvelle est que la plupart des données sont récupérables si vous agissez rapidement et parcourez les options dans l'ordre. Une fois que vous êtes de nouveau opérationnel avec vos collections exportées, migrer vers un outil qui conserve vos données localement vous mettra dans une bien meilleure position à long terme.