Request():setHeader()

Mengatur header baru untuk permintaan HTTP. Metode ini memungkinkan Anda menambahkan header HTTP kustom ke permintaan Anda sebelum mengirimkannya.

Tanda Tangan

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

Parameter

Parameter	Type	Description
key	string	Nama header
value	string	Nilai header

Mengembalikan

Request - Mengembalikan objek Request untuk rantai metode

Deskripsi

Metode setHeader() menambahkan header HTTP kustom ke permintaan. Header adalah metadata yang memberikan informasi tambahan tentang permintaan, seperti tipe konten, otorisasi, atau user agent. Anda dapat memanggil metode ini beberapa kali untuk menambahkan beberapa header.

Contoh

Mengatur Header Otorisasi

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

Mengatur Content Type

-- 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()

Beberapa Header

-- 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()

Header Kustom

-- 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()

Header Data Formulir

-- 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()

Header HTTP Umum

Header Name	Typical Usage	Example
Authorization	Token autentikasi	"Bearer token123"
Content-Type	Format body permintaan	"application/json"
Accept	Preferensi format respons	"application/json"
User-Agent	Identifikasi klien	"MyApp/1.0"
X-API-Key	Autentikasi API	"your-api-key"
Content-Length	Ukuran body permintaan (biasanya diatur secara otomatis)	"256"

Catatan

• Header tidak peka huruf besar/kecil, tetapi merupakan konvensi untuk menggunakan Header-Case (misalnya, Content-Type)
• Metode mengembalikan objek Request, memungkinkan rantai metode
• Beberapa header mungkin secara otomatis diatur oleh klien HTTP
• Header tertentu seperti Content-Length biasanya dihitung secara otomatis
• Berhati-hatilah dengan header autentikasi dan jangan mengekspos informasi sensitif
• Anda dapat menimpa header dengan mengatur nama header yang sama beberapa kali