Comandos de Posting

Comandos completos del cliente TUI HTTP Posting y flujos de trabajo para pruebas de API en la terminal.

Instalación

Comando	Descripción
uv tool install posting	Instalar Posting via uv (recomendado)
pipx install posting	Instalar Posting via pipx
brew install posting	Instalar Posting via Homebrew (macOS)
posting --version	Mostrar versión de Posting
posting	Lanzar TUI de Posting
posting --collection ./my-api	Lanzar con directorio de colección específico
posting --env .env.dev	Lanzar con archivo de entorno

Navegación

Atajo	Descripción
Tab	Ciclar el foco entre paneles
Shift + Tab	Ciclar el foco hacia atrás
Ctrl + J	Modo salto (saltar a cualquier panel por etiqueta)
Ctrl + P	Abrir paleta de comandos
Ctrl + Q	Salir de Posting
j / k	Mover abajo/arriba en listas (modo Vim)
g / G	Saltar al inicio/final de la lista
Escape	Cerrar diálogo o deseleccionar

Gestión de Solicitudes

Atajo	Descripción
Ctrl + N	Crear nueva solicitud
Ctrl + S	Guardar solicitud actual
Ctrl + Shift + S	Guardar solicitud como archivo nuevo
Ctrl + D	Duplicar solicitud actual
Ctrl + Delete	Eliminar solicitud actual
Ctrl + R	Renombrar solicitud actual
Enter	Enviar solicitud actual
Ctrl + L	Enfoque en barra de URL

Métodos HTTP

Método	Descripción
GET	Recuperar recurso
POST	Crear recurso
PUT	Actualizar/reemplazar recurso
PATCH	Actualización parcial de recurso
DELETE	Eliminar recurso
HEAD	Obtener solo encabezados
OPTIONS	Obtener métodos compatibles

Configuración de Solicitudes

Pestaña	Descripción
Headers tab	Añadir/editar encabezados de solicitud
Body tab	Establecer contenido del cuerpo de la solicitud
Query tab	Añadir parámetros de consulta de URL
Auth tab	Configurar autenticación
Options tab	Establecer opciones específicas de solicitud
Scripts tab	Scripts de Python antes/después de la solicitud

Variables de Entorno

Acción	Descripción
$VARIABLE_NAME en URL	Referencia a variable de entorno
${VARIABLE_NAME} en cuerpo	Interpolar variable en cuerpo
posting --env .env.dev	Cargar archivo de entorno al iniciar
.env en raíz de colección	Entorno auto-cargado
.env.local archivo de anulación	Anulaciones locales (gitignored)

Archivos de Solicitud YAML

Campo	Descripción
name: My Request	Nombre de visualización de la solicitud
method: POST	Método HTTP
url: https://api.example.com/users	URL de destino
headers:	Asignación de encabezados de solicitud
body:	Contenido del cuerpo de la solicitud
params:	Parámetros de consulta
auth:	Configuración de autenticación
scripts:	Scripts antes/después de la solicitud

Archivo de Solicitud de Ejemplo

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

Tipos de Autenticación

Tipo	Descripción
Bearer Token	Authorization: Bearer <token>
Basic Auth	Nombre de usuario:contraseña codificado en Base64
API Key	Encabezado personalizado con clave API
No Auth	Sin autenticación

Scripts Antes/Después de la Solicitud

Hook	Descripción
pre_request.py	Script de Python ejecutado antes de la solicitud
post_request.py	Script de Python ejecutado después de la respuesta
Access request object	Modificar solicitud en pre-script
Access response object	Procesar respuesta en post-script
Set variables	Almacenar valores para solicitudes posteriores

Visor de Respuestas

Característica	Descripción
Body tab	Ver cuerpo de respuesta con resaltado de sintaxis
Headers tab	Ver encabezados de respuesta
Status code display	Código de estado HTTP y texto
Response time	Duración de la solicitud en milisegundos
Response size	Tamaño del cuerpo de respuesta
Ctrl + F	Buscar dentro del cuerpo de respuesta

Gestión de Colecciones

Acción	Descripción
Directory structure = Collection	La jerarquía de carpetas organiza solicitudes
Create subdirectory	Agrupar solicitudes relacionadas
.yaml files = Requests	Cada archivo YAML es una solicitud
posting --collection <dir>	Abrir colección específica
Version control with Git	Los archivos YAML son compatibles con git

Importar/Exportar

Acción	Descripción
Paste curl command in URL bar	Importar desde curl
Ctrl + E	Exportar solicitud actual como curl
Import from Postman	Importar colecciones de Postman
Import from OpenAPI	Importar especificaciones de OpenAPI/Swagger
YAML files are portable	Compartir solicitudes vía archivos

Configuración

Configuración	Descripción
~/.config/posting/config.yaml	Archivo de configuración global
theme: monokai	Establecer tema de color
vim_mode: true	Habilitar enlace de teclado Vim
editor: nvim	Establecer editor externo
pager: less	Establecer pager externo
timeout: 30	Tiempo de espera de solicitud predeterminado (segundos)

Temas

Comando	Descripción
posting --theme monokai	Lanzar con tema Monokai
posting --theme dracula	Lanzar con tema Dracula
posting --theme solarized	Lanzar con tema Solarized
Custom theme in config	Definir su propio esquema de colores
posting --list-themes	Mostrar temas disponibles

Consejos y Mejores Prácticas

Consejo	Descripción
Use jump mode (Ctrl+J)	Navegar más rápido que con tabulación
Store requests in Git	Control de versión de sus pruebas de API
Use environment files	Cambiar entre dev/staging/prod
Write pre/post scripts	Automatizar la actualización de token de autenticación
Use Ctrl+P command palette	Descubrir características rápidamente
Organize in folders	Agrupar puntos finales relacionados
Use variables in URLs	Mantener solicitudes DRY y flexibles
Open in $EDITOR for complex bodies	Editar cargas útiles grandes externamente