Utiliser les collections Postman

Le package public contient une référence REST principale, un démarrage rapide en lecture seule, un environnement avec identifiants vides et des fichiers de découverte et de connexion MCP.

Importer

1. Téléchargez le collection principale, collection de démarrage rapide, et Environnement de production.
2. Importez-les dans votre espace de travail privé Postman.
3. Sélectionnez l’environnement. Gardez base_url comme https://api.adios.dev.
4. Suivez authentification et définissez les valeurs privées de access_token et team_id. Laissez les valeurs partagées vides.
5. Exécutez la collection de démarrage rapide dans l'ordre et vérifiez que l'identité et les ressources retournées appartiennent à votre équipe.

Le démarrage rapide envoie cinq requêtes en lecture seule : santé de l’API, utilisateur actuel, équipes, contexte de déploiement et workloads. La requête de l’utilisateur actuel enregistre user_id dans l'environnement sélectionné lorsque la réponse en contient un.

Explorer la référence

Définissez les variables de ressources telles que workload_id, workspace_id, et object_bucket_id à partir de vos propres résultats API. Définissez region dans le contexte du déploiement, hostname sur un domaine que vous possédez, et bucket_name sur le nom de bucket que vous souhaitez, unique mondialement. Activez les paramètres de requête facultatifs uniquement si nécessaire.

Envoyez individuellement les requêtes de la référence principale. La collection inclut des modifications de données, des invitations, des changements de fichiers et des actions d’exécution. Vérifiez le corps et la cible avant l’envoi. Pour envoyer des objets, choisissez Body → binary et sélectionnez un fichier.

Les réponses de réussite enregistrées sont illustratives. Un test 2xx vérifie le statut de réponse ; il ne prouve pas qu’une compilation ou un déploiement asynchrone est devenu sain. Inspectez ensuite l’état de compilation ou d’exécution correspondant.

MCP et développement local

Utilisez la requête MCP native de Postman pour Connexions MCP. Ses fichiers JSON de connexion sont distincts des exports de collections REST et utilisent une procédure OAuth séparée.

Pour le développement local de la plateforme, utilisez l’Environnement local avec la stack locale, des certificats TLS mkcert de confiance et l’application de bureau ou Desktop Agent. Gardez la vérification TLS activée. L’API publique hébergée est le choix habituel pour les utilisateurs de la plateforme.