Comment partager des collections Postman sans passer au plan d'équipe

TL;DR

La version gratuite de Postman limite le partage de collections de manière à surprendre de nombreux développeurs. Si vous devez collaborer avec des coéquipiers sans payer 19 $/utilisateur/mois, vous disposez de quelques solutions de contournement, mais chacune comporte de réels compromis. Le plan gratuit d'Apidog vous permet de partager votre espace de travail avec jusqu'à 3 utilisateurs, sans mise à niveau requise.

Introduction

Postman a débuté comme une simple extension Chrome pour l'envoi de requêtes HTTP. Au fil des ans, il est devenu une plateforme API complète, et ses tarifs ont évolué en conséquence. Aujourd'hui, les équipes qui souhaitent partager des collections et collaborer en temps réel ont besoin d'un plan payant. La version gratuite laisse de nombreux développeurs à la recherche de solutions de contournement.

Si vous dirigez une petite équipe, un projet parallèle ou une startup où chaque dollar compte, payer 19 $ par utilisateur et par mois juste pour partager une collection semble excessif. C'est 228 $ par personne et par an avant même d'avoir livré la moindre fonctionnalité.

La bonne nouvelle est qu'il existe des moyens légitimes de partager des collections Postman avec le plan gratuit. Aucun d'entre eux n'est aussi fluide que de payer pour le plan Équipe, mais ils fonctionnent. Ce guide présente chaque méthode, explique ce qui ne fonctionne pas et vous montre à quoi ressemble une véritable alternative gratuite.

Ce que le plan gratuit de Postman permet réellement

Avant d'examiner les solutions de contournement, il est utile de comprendre ce que le plan gratuit inclut à partir de 2024-2025.

Le plan gratuit de Postman vous offre :

• 1 utilisateur par espace de travail (pas de modification partagée)
• Jusqu'à 3 espaces de travail publics actifs
• Espaces de travail personnels illimités
• 1 000 appels de serveur fictif par mois
• 1 000 appels de surveillance par mois
• Exécutions de collections limitées à 25 par mois sur le cloud runner

La limitation critique : vous ne pouvez pas inviter de coéquipiers à un espace de travail privé avec le plan gratuit. Les espaces de travail privés nécessitent au moins le plan Basique à 19 $/utilisateur/mois. C'est le mur que la plupart des petites équipes rencontrent en premier.

Méthode 1 : Exporter la collection au format JSON et partager le fichier

La solution de contournement la plus directe consiste à exporter votre collection sous forme de fichier JSON et à l'envoyer à votre coéquipier.

Comment faire :

1. Ouvrez Postman et accédez à votre collection dans la barre latérale gauche.
2. Cliquez sur le menu à trois points à côté du nom de la collection.
3. Sélectionnez « Exporter ».
4. Choisissez le format Collection v2.1 (c'est la norme actuelle et elle offre la plus large compatibilité).
5. Enregistrez le fichier JSON et partagez-le par e-mail, Slack ou un lecteur partagé.

Votre coéquipier l'importe en allant dans Fichier > Importer et en faisant glisser le fichier JSON.

Ce qui ne fonctionne pas :

Dès que vous exportez, la collection devient un instantané. Si vous ajoutez un nouveau point de terminaison ou corrigez une requête, votre coéquipier n'a aucun moyen de le savoir. Ils travaillent à partir d'une copie obsolète.

Les variables d'environnement ne sont pas exportées avec la collection par défaut. Vous devez exporter les environnements séparément, et votre coéquipier doit également les importer. Si vous oubliez une variable, leurs requêtes échoueront et ils passeront du temps à déboguer quelque chose qui n'est pas réellement cassé.

Il n'y a pas de processus de fusion. Si deux personnes modifient simultanément leurs copies locales et tentent ensuite de les concilier, vous le faites manuellement.

Cette méthode fonctionne pour des transferts ponctuels occasionnels. Elle échoue rapidement lorsque la collection est en constante évolution.

Méthode 2 : Utiliser un espace de travail public

Postman vous permet de créer des espaces de travail publics avec le plan gratuit. Toute personne disposant du lien peut consulter et forker la collection.

Comment le configurer :

1. Créez un nouvel espace de travail dans Postman.
2. Lorsque vous êtes invité à choisir la visibilité, sélectionnez « Public ».
3. Ajoutez votre collection à l'espace de travail public.
4. Partagez l'URL de l'espace de travail avec vos coéquipiers.

Vos coéquipiers peuvent forker la collection vers leur propre espace de travail et travailler à partir de là.

Ce qui ne fonctionne pas :

Public signifie public. N'importe qui sur Internet peut trouver et consulter votre collection s'il dispose de l'URL ou s'il effectue une recherche sur le réseau API public de Postman. Pour les outils internes, les environnements de staging ou tout ce qui contient des jetons d'authentification intégrés aux réponses d'exemple, cela représente un risque important.

Les collections forkées ne restent pas synchronisées automatiquement. Si vous mettez à jour l'original, les coéquipiers doivent tirer manuellement les modifications dans leur fork. Il n'y a aucune notification qu'un changement a eu lieu.

Les commentaires et la collaboration directe nécessitent toujours le plan Équipe. Les espaces de travail publics sont en lecture seule pour les spectateurs ; ils ne peuvent pas modifier l'original.

Cette méthode convient bien aux projets open-source ou à la documentation API publique. Elle ne convient pas aux flux de travail d'équipe internes.

Méthode 3 : Utiliser un dépôt Git comme couche de synchronisation

Certaines équipes résolvent le problème de synchronisation en traitant le JSON exporté comme un artefact de code et en le committant dans un dépôt Git.

Le flux de travail se présente comme suit :

1. Une personne est propriétaire de la collection Postman et l'exporte après chaque modification significative.
2. Ils committent le JSON mis à jour dans un dépôt Git partagé (GitHub, GitLab, Bitbucket).
3. Les coéquipiers récupèrent la dernière version et l'importent dans leur Postman local.

Ce qui ne fonctionne pas :

Chaque importation écrase la collection locale existante. Si un coéquipier a effectué des modifications locales, celles-ci disparaissent à moins qu'il n'ait d'abord exporté et fusionné.

Le flux de travail exige de la discipline. Quelqu'un doit se souvenir d'exporter et de committer chaque fois que quelque chose change. En pratique, la version Git est presque toujours en retard par rapport à l'état réel de Postman.

Vous ne pouvez pas exécuter de requêtes directement depuis un dépôt Git. Quelqu'un doit toujours effectuer l'étape d'importation, ce qui prend du temps et crée des frictions.

Cette méthode est meilleure que le partage de fichiers brut car elle offre un historique et une source de vérité unique, mais les étapes manuelles ajoutent une surcharge qui ralentit les équipes.

Méthode 4 : Utiliser l'espace de travail personnel gratuit de Postman avec un compte « principal » unique

Certaines petites équipes contournent la limite de collaboration en faisant en sorte que tout le monde partage un seul compte Postman. Une personne se connecte sur plusieurs machines en utilisant les mêmes identifiants.

Ceci est contraire aux Conditions d'utilisation de Postman et crée de réels problèmes :

• Postman peut détecter les identifiants partagés et verrouiller le compte.
• Les modifications apportées par une personne peuvent écraser celles apportées par une autre si des conflits de synchronisation surviennent.
• Il n'y a aucun moyen d'attribuer les modifications à des personnes spécifiques.

Cette méthode est mentionnée ici parce que les équipes l'utilisent, et non parce que c'est une bonne idée.

Comment Apidog gère le partage au niveau gratuit

Apidog adopte une approche différente du problème de collaboration. Le plan gratuit inclut jusqu'à 3 membres d'équipe dans un espace de travail partagé, avec une synchronisation en temps réel pour tous. Pas de solutions de contournement, pas de jonglage avec les fichiers JSON.

Lorsque vous apportez une modification à une définition d'API dans Apidog, vos coéquipiers la voient immédiatement. Vous travaillez tous à partir de la même source de vérité sans que personne n'ait à exporter ou importer quoi que ce soit.

Si vous utilisez déjà Postman, vous pouvez importer directement vos collections existantes. Apidog lit le format Postman Collection v2.1, donc le passage se fait en un clic, pas en un projet d'un week-end.

Le plan gratuit inclut également :

• Éditeur de conception d'API complet (OpenAPI 3.0 et Swagger)
• Smart Mock pour générer des réponses réalistes sans dépendance au cloud
• Un exécuteur de tests sans limites d'exécution mensuelles
• Documentation API générée automatiquement à partir de vos définitions
• Stockage local en priorité, de sorte que vos données restent sur votre machine, sauf si vous choisissez de les synchroniser

Pour une équipe de 2-3 personnes, le plan gratuit d'Apidog couvre les mêmes fonctionnalités que le plan Équipe de Postman, sans frais.

Choisir la bonne méthode pour votre situation

Voici un guide de décision rapide :

Si votre équipe développe activement des API et que vous atteignez les limites de partage de Postman, les solutions de contournement JSON et Git vous ralentiront. Elles résolvent le problème immédiat mais ajoutent des frictions continues.

FAQ

Puis-je partager une collection Postman sans compte ?Oui. Exportez la collection sous forme de fichier JSON et envoyez le fichier directement. Le destinataire peut l'importer sans compte Postman s'il utilise un client API prenant en charge le format Postman Collection v2.1, y compris Apidog.

Le plan Basique de Postman permet-il le partage d'équipe ?Oui. Le plan Basique à 19 $/utilisateur/mois permet la collaboration sur 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 ?Un espace de travail public est visible par n'importe qui sur Internet. Les visiteurs peuvent consulter et forker des collections mais ne peuvent pas modifier les originaux. Il est gratuit de créer jusqu'à 3 espaces de travail publics avec le plan gratuit.

Mes variables d'environnement seront-elles exportées avec ma collection ?Non. Les variables d'environnement sont exportées séparément. Accédez aux Environnements dans la barre latérale, cliquez sur le menu à trois points de l'environnement dont vous avez besoin et exportez-le sous forme de fichier JSON séparé. Partagez les deux fichiers avec votre coéquipier.

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, aucune carte de crédit requise.

Puis-je importer mes collections Postman existantes dans Apidog ?Oui. Apidog prend en charge l'importation directe des fichiers JSON Postman Collection v2.1. Allez dans Importer dans Apidog, sélectionnez votre fichier, et votre collection sera importée avec les requêtes, les en-têtes et les variables d'environnement intacts.

Les limitations de partage de la version gratuite de Postman sont réelles, et les solutions de contournement ont un coût réel en temps et en fiabilité. Pour les équipes de 3 personnes maximum qui ont besoin d'une collaboration réelle, passer à un outil conçu pour le partage au niveau gratuit est souvent plus simple que de bricoler un flux de travail qui exige un effort manuel constant.