Request():setHeader()

Establece una nueva cabecera para solicitudes HTTP. Este método te permite añadir cabeceras HTTP personalizadas a tu solicitud antes de enviarla.

Firma

setHeader(key: string, value: string): Request

Parámetros

Parámetros	Tipo	Descripción
key	string	El nombre de la cabecera
value	string	El valor de la cabecera

Devuelve

Request - Devuelve el objeto Request para encadenar métodos

Descripción

El método setHeader() añade una cabecera HTTP personalizada a la solicitud. Las cabeceras son metadatos que proporcionan información adicional sobre la solicitud, como el tipo de contenido, la autorización o el agente de usuario. Puedes llamar a este método varias veces para añadir múltiples cabeceras.

Ejemplos

Establecer la cabecera de autorización

-- Add Bearer token for API authentication
local response = Request("https://api.example.com/data")
    :setHeader("Authorization", "Bearer your-token-here")
    :get()

Establecer el tipo de contenido

-- Set JSON content type for POST requests
local response = Request("https://api.example.com/users")
    :setHeader("Content-Type", "application/json")
    :setParameter("name", "John Doe")
    :setParameter("email", "john@example.com")
    :post()

Múltiples cabeceras

-- Set multiple headers for a request
local response = Request("https://api.example.com/protected")
    :setHeader("Authorization", "Bearer token123")
    :setHeader("Content-Type", "application/json")
    :setHeader("Accept", "application/json")
    :setHeader("User-Agent", "MyApp/1.0")
    :get()

Cabeceras personalizadas

-- Add custom application-specific headers
local response = Request("https://api.example.com/process")
    :setHeader("X-API-Key", "your-api-key")
    :setHeader("X-Request-ID", "unique-request-identifier")
    :setHeader("X-Client-Version", "2.1.0")
    :post()

Cabeceras de datos de formulario

-- Set headers for form data submission
local response = Request("https://example.com/login")
    :setHeader("Content-Type", "application/x-www-form-urlencoded")
    :setParameter("username", "user")
    :setParameter("password", "pass")
    :post()

Cabeceras HTTP comunes

Nombre de cabecera	Uso típico	Ejemplo
Authorization	Tokens de autenticación	"Bearer token123"
Content-Type	Formato del cuerpo de la solicitud	"application/json"
Accept	Preferencia de formato de la respuesta	"application/json"
User-Agent	Identificación del cliente	"MyApp/1.0"
X-API-Key	Autenticación de API	"your-api-key"
Content-Length	Tamaño del cuerpo de la solicitud (normalmente se establece automáticamente)	"256"

Notas

• Las cabeceras no distinguen entre mayúsculas y minúsculas, pero es convencional usar Header-Case (por ejemplo, Content-Type)
• El método devuelve el objeto Request, lo que permite encadenar métodos
• Algunas cabeceras pueden ser establecidas automáticamente por el cliente HTTP
• Ciertas cabeceras como Content-Length normalmente se calculan automáticamente
• Ten cuidado con las cabeceras de autenticación y no expongas información confidencial
• Puedes sobrescribir cabeceras estableciendo el mismo nombre de cabecera varias veces