Comandi Posting

Comandi e flussi di lavoro completi di Posting, client TUI HTTP per i test API nel terminale.

Installazione

Comando	Descrizione
uv tool install posting	Installa Posting tramite uv (consigliato)
pipx install posting	Installa Posting tramite pipx
brew install posting	Installa Posting tramite Homebrew (macOS)
posting --version	Mostra la versione di Posting
posting	Avvia l’interfaccia TUI di Posting
posting --collection ./my-api	Avvia con una directory di raccolta specifica
posting --env .env.dev	Avvia con un file d’ambiente

Navigazione

Scorciatoia	Descrizione
Tab	Cicla il focus tra i pannelli
Shift + Tab	Cicla il focus all’indietro
Ctrl + J	Modalità salta (salta a qualsiasi pannello per etichetta)
Ctrl + P	Apri la tavolozza dei comandi
Ctrl + Q	Esci da Posting
j / k	Sposta giù/su negli elenchi (modalità Vim)
g / G	Salta all’inizio/fine dell’elenco
Escape	Chiudi la finestra di dialogo o deseleziona

Gestione delle Richieste

Scorciatoia	Descrizione
Ctrl + N	Crea una nuova richiesta
Ctrl + S	Salva la richiesta corrente
Ctrl + Shift + S	Salva la richiesta come nuovo file
Ctrl + D	Duplica la richiesta corrente
Ctrl + Delete	Elimina la richiesta corrente
Ctrl + R	Rinomina la richiesta corrente
Enter	Invia la richiesta corrente
Ctrl + L	Metti a fuoco la barra dell’URL

Metodi HTTP

Metodo	Descrizione
GET	Recupera la risorsa
POST	Crea la risorsa
PUT	Aggiorna/sostituisce la risorsa
PATCH	Aggiornamento parziale della risorsa
DELETE	Elimina la risorsa
HEAD	Ottieni solo le intestazioni
OPTIONS	Ottieni i metodi supportati

Configurazione della Richiesta

Scheda	Descrizione
Scheda Headers	Aggiungi/modifica le intestazioni della richiesta
Scheda Body	Imposta il contenuto del corpo della richiesta
Scheda Query	Aggiungi i parametri di query URL
Scheda Auth	Configura l’autenticazione
Scheda Options	Imposta le opzioni specifiche della richiesta
Scheda Scripts	Script Python pre/post richiesta

Variabili d’Ambiente

Azione	Descrizione
$VARIABLE_NAME nell’URL	Fai riferimento a una variabile d’ambiente
${VARIABLE_NAME} nel corpo	Interpola la variabile nel corpo
posting --env .env.dev	Carica il file d’ambiente all’avvio
.env file nella root della raccolta	Ambiente caricato automaticamente
.env.local file di override	Override locale (gitignored)

File di Richiesta YAML

Campo	Descrizione
name: My Request	Nome visualizzato della richiesta
method: POST	Metodo HTTP
url: https://api.example.com/users	URL di destinazione
headers:	Mappatura delle intestazioni della richiesta
body:	Contenuto del corpo della richiesta
params:	Parametri di query
auth:	Configurazione dell’autenticazione
scripts:	Script pre/post richiesta

File di Richiesta di Esempio

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"
    }

Tipi di Autenticazione

Tipo	Descrizione
Bearer Token	Authorization: Bearer <token>
Basic Auth	Username:password codificato in Base64
API Key	Intestazione personalizzata con chiave API
No Auth	Nessuna autenticazione

Script Pre/Post Richiesta

Hook	Descrizione
pre_request.py	Script Python eseguito prima della richiesta
post_request.py	Script Python eseguito dopo la risposta
Accesso all’oggetto request	Modifica la richiesta nello script pre
Accesso all’oggetto response	Elabora la risposta nello script post
Imposta le variabili	Memorizza i valori per le richieste successive

Visualizzatore di Risposta

Caratteristica	Descrizione
Scheda Body	Visualizza il corpo della risposta con evidenziazione della sintassi
Scheda Headers	Visualizza le intestazioni della risposta
Visualizzazione del codice di stato	Codice di stato HTTP e testo
Tempo di risposta	Durata della richiesta in millisecondi
Dimensione della risposta	Dimensione del corpo della risposta
Ctrl + F	Ricerca all’interno del corpo della risposta

Gestione delle Raccolte

Azione	Descrizione
Struttura delle directory = Raccolta	La gerarchia delle cartelle organizza le richieste
Crea una sottodirectory	Raggruppa le richieste correlate
.yaml file = Richieste	Ogni file YAML è una richiesta
posting --collection <dir>	Apri una raccolta specifica
Controllo versione con Git	I file YAML sono git-friendly

Importa/Esporta

Azione	Descrizione
Incolla il comando curl nella barra dell’URL	Importa da curl
Ctrl + E	Esporta la richiesta corrente come curl
Importa da Postman	Importa le raccolte Postman
Importa da OpenAPI	Importa le specifiche OpenAPI/Swagger
I file YAML sono portabili	Condividi le richieste tramite file

Configurazione

Impostazione	Descrizione
~/.config/posting/config.yaml	File di configurazione globale
theme: monokai	Imposta il tema dei colori
vim_mode: true	Abilita i keybinding Vim
editor: nvim	Imposta l’editor esterno
pager: less	Imposta il pager esterno
timeout: 30	Timeout della richiesta predefinito (secondi)

Temi

Comando	Descrizione
posting --theme monokai	Avvia con il tema Monokai
posting --theme dracula	Avvia con il tema Dracula
posting --theme solarized	Avvia con il tema Solarized
Tema personalizzato nella configurazione	Definisci il tuo schema di colori
posting --list-themes	Mostra i temi disponibili

Suggerimenti e Best Practice

Suggerimento	Descrizione
Usa la modalità salta (Ctrl+J)	Naviga più velocemente del tabbing
Memorizza le richieste in Git	Controllo versione dei test API
Usa i file d’ambiente	Passa tra dev/staging/prod
Scrivi script pre/post	Automatizza l’aggiornamento del token auth
Usa la tavolozza dei comandi Ctrl+P	Scopri le funzioni rapidamente
Organizza in cartelle	Raggruppa i punti finali correlati
Usa le variabili negli URL	Mantieni le richieste DRY e flessibili
Apri in $EDITOR per i corpi complessi	Modifica i payload di grandi dimensioni esternamente