Commandes Posting

Commandes complètes du client HTTP TUI Posting et workflows pour les tests d’API dans le terminal.

Installation

Commande	Description
uv tool install posting	Installer Posting via uv (recommandé)
pipx install posting	Installer Posting via pipx
brew install posting	Installer Posting via Homebrew (macOS)
posting --version	Afficher la version de Posting
posting	Lancer l’interface Posting TUI
posting --collection ./my-api	Lancer avec un répertoire de collection spécifique
posting --env .env.dev	Lancer avec un fichier d’environnement

Navigation

Raccourci	Description
Tab	Cycler le focus entre les panneaux
Shift + Tab	Cycler le focus en arrière
Ctrl + J	Mode de saut (sauter à n’importe quel panneau par étiquette)
Ctrl + P	Ouvrir la palette de commandes
Ctrl + Q	Quitter Posting
j / k	Descendre/monter dans les listes (mode Vim)
g / G	Sauter au début/à la fin de la liste
Escape	Fermer le dialogue ou désélectionner

Gestion des Demandes

Raccourci	Description
Ctrl + N	Créer une nouvelle demande
Ctrl + S	Enregistrer la demande actuelle
Ctrl + Shift + S	Enregistrer la demande comme nouveau fichier
Ctrl + D	Dupliquer la demande actuelle
Ctrl + Delete	Supprimer la demande actuelle
Ctrl + R	Renommer la demande actuelle
Enter	Envoyer la demande actuelle
Ctrl + L	Mettre le focus sur la barre URL

Méthodes HTTP

Méthode	Description
GET	Récupérer une ressource
POST	Créer une ressource
PUT	Mettre à jour/remplacer une ressource
PATCH	Mise à jour partielle d’une ressource
DELETE	Supprimer une ressource
HEAD	Obtenir uniquement les en-têtes
OPTIONS	Obtenir les méthodes supportées

Configuration des Demandes

Onglet	Description
Headers tab	Ajouter/modifier les en-têtes de la demande
Body tab	Définir le contenu du corps de la demande
Query tab	Ajouter des paramètres de requête URL
Auth tab	Configurer l’authentification
Options tab	Définir les options spécifiques à la demande
Scripts tab	Scripts Python pré/post-demande

Variables d’Environnement

Action	Description
$VARIABLE_NAME in URL	Référencer une variable d’environnement
${VARIABLE_NAME} in body	Interpoler la variable dans le corps
posting --env .env.dev	Charger le fichier d’environnement au démarrage
.env file in collection root	Environnement auto-chargé
.env.local override file	Fichier de remplacement local (gitignored)

Fichiers de Demande YAML

Champ	Description
name: My Request	Nom d’affichage de la demande
method: POST	Méthode HTTP
url: https://api.example.com/users	URL cible
headers:	Mappage des en-têtes de demande
body:	Contenu du corps de la demande
params:	Paramètres de requête
auth:	Configuration de l’authentification
scripts:	Scripts pré/post-demande

Exemple de Fichier de Demande

name: Create User
description: Create a new user account
method: POST
url: https://api.example.com/users
headers:
  Content-Type: application/json
  Authorization: Bearer ${API_TOKEN}
body:
  content: |
    {
      "name": "John Doe",
      "email": "john@example.com"
    }

Types d’Authentification

Type	Description
Bearer Token	Authorization: Bearer <token>
Basic Auth	Nom d’utilisateur:mot de passe codé en base64
API Key	En-tête personnalisé avec clé API
No Auth	Pas d’authentification

Scripts Pré/Post-Demande

Hook	Description
pre_request.py	Script Python exécuté avant la demande
post_request.py	Script Python exécuté après la réponse
Access request object	Modifier la demande dans le pre-script
Access response object	Traiter la réponse dans le post-script
Set variables	Stocker les valeurs pour les demandes suivantes

Visualiseur de Réponse

Fonctionnalité	Description
Body tab	Afficher le corps de la réponse avec surbrillance syntaxique
Headers tab	Afficher les en-têtes de réponse
Status code display	Code de statut HTTP et texte
Response time	Durée de la demande en millisecondes
Response size	Taille du corps de la réponse
Ctrl + F	Rechercher dans le corps de la réponse

Gestion des Collections

Action	Description
Directory structure = Collection	La hiérarchie des dossiers organise les demandes
Create subdirectory	Grouper les demandes connexes
.yaml files = Requests	Chaque fichier YAML est une demande
posting --collection <dir>	Ouvrir une collection spécifique
Version control with Git	Les fichiers YAML sont compatibles avec git

Import/Export

Action	Description
Paste curl command in URL bar	Importer à partir de curl
Ctrl + E	Exporter la demande actuelle en tant que curl
Import from Postman	Importer les collections Postman
Import from OpenAPI	Importer les spécifications OpenAPI/Swagger
YAML files are portable	Partager les demandes via les fichiers

Configuration

Paramètre	Description
~/.config/posting/config.yaml	Fichier de configuration globale
theme: monokai	Définir le thème de couleur
vim_mode: true	Activer les liaisons de touches Vim
editor: nvim	Définir l’éditeur externe
pager: less	Définir le pager externe
timeout: 30	Délai d’expiration par défaut de la demande (secondes)

Thèmes

Commande	Description
posting --theme monokai	Lancer avec le thème Monokai
posting --theme dracula	Lancer avec le thème Dracula
posting --theme solarized	Lancer avec le thème Solarized
Custom theme in config	Définir votre propre schéma de couleurs
posting --list-themes	Afficher les thèmes disponibles

Conseils et Bonnes Pratiques

Conseil	Description
Use jump mode (Ctrl+J)	Naviguer plus rapidement qu’en appuyant sur Tab
Store requests in Git	Contrôle de version pour vos tests d’API
Use environment files	Basculer entre dev/staging/prod
Write pre/post scripts	Automatiser le renouvellement du jeton d’authentification
Use Ctrl+P command palette	Découvrir rapidement les fonctionnalités
Organize in folders	Grouper les points de terminaison connexes
Use variables in URLs	Garder les demandes DRY et flexibles
Open in $EDITOR for complex bodies	Modifier les charges utiles volumineuses en externe