TL;DR
La version gratuite de Postman limite le partage de collections d’une façon qui bloque vite les petites équipes. Vous pouvez contourner cette limite avec des exports JSON, des espaces publics ou Git, mais chaque méthode ajoute de la friction. Le plan gratuit d’Apidog permet de partager un espace de travail avec jusqu’à 3 utilisateurs, sans mise à niveau.
💡 Apidog est une plateforme de développement d’API gratuite et tout-en-un. Elle couvre la conception d’API, les tests, le mocking et la documentation dans un seul outil, avec une collaboration intégrée au niveau gratuit.
Introduction
Postman a commencé comme une extension Chrome pour envoyer des requêtes HTTP. Aujourd’hui, c’est une plateforme API complète, avec une tarification adaptée aux usages d’équipe.
Le problème apparaît rapidement pour les petites équipes : partager une collection dans un espace privé et collaborer en temps réel nécessite un plan payant. Si vous travaillez sur un side project, une startup ou une petite équipe produit, payer 19 $ par utilisateur et par mois uniquement pour partager des collections peut être difficile à justifier.
Ce guide montre concrètement comment partager une collection Postman avec le plan gratuit, quelles limites prévoir, et quand basculer vers une alternative gratuite comme Apidog devient plus simple.
Ce que le plan gratuit de Postman permet réellement
Avant de choisir une méthode, vérifiez les limites du plan gratuit Postman.
Le plan gratuit inclut notamment :
- 1 utilisateur par espace de travail
- Jusqu’à 3 espaces de travail publics actifs
- Des espaces de travail personnels illimités
- 1 000 appels de serveur fictif par mois
- 1 000 appels de surveillance par mois
- 25 exécutions de collections par mois via le cloud runner
La limite importante : vous ne pouvez pas inviter plusieurs coéquipiers dans un espace de travail privé avec le plan gratuit. Pour collaborer dans un espace privé, il faut au moins le plan Basique à 19 $/utilisateur/mois.
Méthode 1 : exporter la collection au format JSON
C’est la méthode la plus simple pour transmettre une collection à quelqu’un.
Étapes
- Ouvrez Postman.
- Dans la barre latérale gauche, trouvez la collection à partager.
- Cliquez sur le menu
...à côté du nom de la collection. - Sélectionnez Export.
- Choisissez le format Collection v2.1.
- Enregistrez le fichier JSON.
- Envoyez-le par e-mail, Slack, Notion, Google Drive ou tout autre canal.
Le destinataire peut ensuite importer le fichier :
File > Import > Upload Files
ou glisser-déposer le fichier JSON dans Postman.
Exemple de workflow minimal
developer-a
└── exporte collection.postman_collection.json
developer-b
└── importe collection.postman_collection.json
Limites
Cette méthode fonctionne pour un transfert ponctuel, mais elle n’est pas adaptée à une collaboration continue.
Problèmes courants :
- La collection exportée est un instantané.
- Les modifications ultérieures ne sont pas synchronisées.
- Les environnements ne sont pas exportés automatiquement avec la collection.
- Les conflits doivent être résolus manuellement.
- Deux développeurs peuvent modifier deux copies différentes sans source de vérité partagée.
Si votre API change souvent, cette méthode devient vite fragile.
Méthode 2 : exporter aussi les environnements
Les collections Postman ne contiennent pas toujours tout ce dont votre coéquipier a besoin pour exécuter les requêtes.
Si vos requêtes utilisent des variables comme :
{{base_url}}
{{access_token}}
{{user_id}}
vous devez aussi exporter l’environnement correspondant.
Étapes
- Allez dans Environments.
- Sélectionnez l’environnement à partager.
- Cliquez sur le menu
.... - Sélectionnez Export.
- Envoyez le fichier JSON avec la collection.
Votre coéquipier doit importer les deux fichiers :
collection.postman_collection.json
environment.postman_environment.json
Bonnes pratiques
Avant de partager un environnement, vérifiez qu’il ne contient pas de secrets sensibles.
À éviter dans un export partagé :
{
"access_token": "token-production-reel",
"api_key": "cle-privee",
"password": "mot-de-passe"
}
Préférez des valeurs vides ou factices :
{
"access_token": "",
"api_key": "replace-me",
"password": ""
}
Méthode 3 : utiliser un espace de travail public Postman
Postman permet de créer des espaces de travail publics avec le plan gratuit. Toute personne disposant du lien peut consulter et forker la collection.
Étapes
- Créez un nouvel espace de travail dans Postman.
- Choisissez la visibilité Public.
- Ajoutez votre collection à cet espace.
- Partagez l’URL avec vos coéquipiers.
- Demandez-leur de forker la collection vers leur propre espace de travail.
Quand utiliser cette méthode
Elle convient si :
- votre API est publique ;
- le projet est open source ;
- la collection ne contient aucune donnée sensible ;
- vous voulez publier de la documentation ou des exemples.
Limites
Un espace public est réellement public.
Cela signifie que vous ne devez pas y mettre :
- des endpoints internes ;
- des URLs de staging privées ;
- des tokens ;
- des réponses d’exemple contenant des données sensibles ;
- des identifiants de test réutilisables.
Autre limite : les forks ne restent pas automatiquement synchronisés. Si la collection originale change, chaque personne doit récupérer les mises à jour manuellement.
Méthode 4 : utiliser Git comme couche de synchronisation
Si votre équipe utilise déjà Git, vous pouvez versionner les exports Postman dans un dépôt.
Workflow
- Une personne maintient la collection dans Postman.
- Après chaque modification importante, elle exporte la collection.
- Elle commit le fichier JSON dans Git.
- Les autres membres récupèrent le fichier.
- Ils l’importent dans leur Postman local.
Exemple :
git pull origin main
Puis import dans Postman :
File > Import > collection.postman_collection.json
Structure de dépôt possible
api/
├── postman/
│ ├── collections/
│ │ └── backend.postman_collection.json
│ └── environments/
│ ├── local.postman_environment.json
│ └── staging.example.postman_environment.json
└── README.md
Exemple de commit
git add postman/collections/backend.postman_collection.json
git commit -m "Update user API requests"
git push origin main
Avantages
- Historique des versions
- Revue possible via pull request
- Source de vérité plus claire qu’un fichier envoyé sur Slack
- Compatible avec GitHub, GitLab ou Bitbucket
Limites
Cette méthode reste manuelle.
Les problèmes les plus fréquents :
- quelqu’un oublie d’exporter après modification ;
- un import écrase les changements locaux ;
- les conflits JSON sont difficiles à relire ;
- les requêtes ne s’exécutent pas directement depuis Git ;
- les environnements doivent être gérés séparément.
Cette approche est acceptable si votre collection change rarement ou si vous voulez surtout un historique versionné. Pour une collaboration quotidienne, elle ajoute beaucoup d’étapes.
Méthode 5 : partager un seul compte Postman
Certaines petites équipes utilisent un seul compte Postman partagé entre plusieurs personnes pour contourner la limite du plan gratuit.
Ce n’est pas recommandé.
Problèmes :
- cela va à l’encontre des Conditions d’utilisation de Postman ;
- le compte peut être verrouillé ;
- les modifications peuvent se chevaucher ;
- il n’y a pas d’attribution claire des changements ;
- la sécurité est mauvaise, car plusieurs personnes partagent les mêmes identifiants.
Cette méthode est à éviter.
Comment Apidog gère le partage au niveau gratuit
Apidog aborde le problème différemment : le plan gratuit inclut jusqu’à 3 membres dans un espace de travail partagé, avec synchronisation en temps réel.
Concrètement :
- Vous créez un espace de travail.
- Vous invitez vos coéquipiers.
- Toute l’équipe travaille sur la même définition d’API.
- Les changements sont visibles sans export/import manuel.
Si vous utilisez déjà Postman, vous pouvez importer vos collections existantes au format Postman Collection v2.1.
Importer une collection Postman dans Apidog
Workflow typique :
- Exportez votre collection Postman au format Collection v2.1.
- Ouvrez Apidog.
- Allez dans Import.
- Sélectionnez le fichier JSON exporté.
- Importez la collection.
Les requêtes, en-têtes et variables d’environnement peuvent être repris depuis l’export Postman.
Fonctionnalités incluses dans le plan gratuit
Le plan gratuit d’Apidog inclut notamment :
- un éditeur de conception d’API ;
- la prise en charge d’OpenAPI 3.0 et Swagger ;
- le mocking ;
- un exécuteur de tests ;
- la documentation API générée depuis les définitions ;
- la collaboration jusqu’à 3 utilisateurs dans un espace partagé.
Pour une équipe de 2 à 3 personnes, cela évite les exports JSON répétés et les synchronisations manuelles.
Choisir la bonne méthode
| Situation | Approche recommandée |
|---|---|
| Transfert ponctuel d’une collection stable | Exporter le JSON et partager le fichier |
| Besoin de partager aussi les variables | Exporter la collection + l’environnement |
| Projet open source ou API publique | Espace de travail public Postman |
| Équipe déjà organisée autour de Git | Export JSON versionné dans Git |
| Petite équipe en développement actif | Plan gratuit Apidog |
Si votre équipe modifie régulièrement ses endpoints, ses paramètres ou ses environnements, les solutions basées sur des exports deviennent vite coûteuses en temps. Elles fonctionnent, mais elles ne remplacent pas une vraie collaboration d’équipe.
Checklist avant de partager une collection Postman
Avant d’envoyer un export JSON ou de publier une collection, vérifiez :
- [ ] La collection utilise le format Postman Collection v2.1.
- [ ] Les environnements nécessaires sont exportés séparément.
- [ ] Les secrets ont été supprimés ou remplacés.
- [ ] Les URLs internes ne sont pas exposées publiquement.
- [ ] Les coéquipiers savent quel fichier importer.
- [ ] Une source de vérité est définie.
- [ ] Le processus de mise à jour est documenté.
Exemple de note à ajouter dans un README :
## Import Postman
1. Importer `backend.postman_collection.json`
2. Importer `local.postman_environment.json`
3. Sélectionner l’environnement `local`
4. Remplacer les variables vides par vos valeurs locales
FAQ
Puis-je partager une collection Postman sans compte ?
Oui. Vous pouvez exporter la collection en JSON et envoyer le fichier directement. Le destinataire peut l’importer dans Postman ou dans un client API compatible avec le format Postman Collection v2.1, comme Apidog.
Le plan Basique de Postman permet-il le partage d’équipe ?
Oui. Le plan Basique à 19 $/utilisateur/mois permet la collaboration dans un espace de travail privé avec plusieurs utilisateurs. Le plan gratuit ne le permet pas.
Qu’est-ce qu’un espace de travail public Postman ?
C’est un espace visible publiquement sur Internet. Les visiteurs peuvent consulter et forker les collections, mais ne peuvent pas modifier directement l’original.
Mes variables d’environnement sont-elles exportées avec ma collection ?
Non. Les environnements doivent être exportés séparément depuis la section Environments de Postman.
Combien d’utilisateurs peuvent partager un espace de travail avec le plan gratuit d’Apidog ?
Le plan gratuit d’Apidog prend en charge jusqu’à 3 utilisateurs dans un espace de travail partagé avec synchronisation en temps réel.
Puis-je importer mes collections Postman existantes dans Apidog ?
Oui. Apidog prend en charge l’importation des fichiers JSON Postman Collection v2.1. Exportez votre collection depuis Postman, puis importez-la dans Apidog.
Conclusion
Les limites de partage du plan gratuit de Postman sont réelles. Les exports JSON, les espaces publics et Git peuvent dépanner, mais ils ajoutent des étapes manuelles et des risques de désynchronisation.
Pour un partage ponctuel, l’export JSON suffit. Pour un projet open source, un espace public peut convenir. Pour une petite équipe qui développe activement une API, utiliser un outil avec collaboration intégrée au niveau gratuit est souvent plus simple que maintenir un workflow manuel.
Top comments (0)