# Módulo HTTP

Este módulo fornece funções para realizar requisições HTTP a partir de scripts Lua. As funções retornam uma tabela com os resultados da requisição.

## Funções Disponíveis

### `http.request(method, url, body, headers, options)`

Função genérica para realizar requisições HTTP com qualquer método.

**Parâmetros:**

- `method` (string): Método HTTP (GET, POST, PUT, DELETE, PATCH, HEAD)
- `url` (string): URL do endpoint
- `body` (string, opcional): Corpo da requisição
- `headers` (tabela, opcional): Cabeçalhos HTTP como pares chave-valor
- `options` (tabela, opcional): Opções adicionais da requisição

**Opções disponíveis:**

- `verify` (boolean): Verificar certificados SSL (padrão: true)
- `charset` (string): Charset para decodificação da resposta (padrão: "utf-8")

**Aviso de Segurança:**
Desabilitar a verificação SSL (`verify = false`) expõe a conexão a ataques "man-in-the-middle" e deve ser usado **apenas** em ambientes de desenvolvimento ou teste controlados. Nunca utilize esta opção em produção com servidores reais ou com dados sensíveis.

**Valor de retorno:**
Retorna uma tabela com:

- `status` (number): Código de status HTTP
- `body` (string): Corpo da resposta

**Exemplo:**

```lua
local resultado = http.request("POST", "https://api.exemplo.com/dados",
    '{"nome": "teste", "valor": 123}',
    {["Content-Type"] = "application/json"},
    {verify = true, charset = "utf-8"}
)

print("Status:", resultado.status)
print("Resposta:", resultado.body)
```

### `http.get(url, body, headers, options)`

Realiza uma requisição HTTP GET.

**Parâmetros:**

- `url` (string): URL do endpoint
- `body` (string, opcional): Corpo da requisição (raro para GET, mas suportado)
- `headers` (tabela, opcional): Cabeçalhos HTTP
- `options` (tabela, opcional): Opções adicionais

**Exemplo:**

```lua
local resultado = http.get("https://api.exemplo.com/usuarios/1",
    nil,
    {["Authorization"] = "Bearer token123"},
    {verify = true}
)

if resultado.status == 200 then
    print("Dados recebidos:", resultado.body)
else
    print("Erro:", resultado.status)
end
```

### `http.post(url, body, headers, options)`

Realiza uma requisição HTTP POST.

**Parâmetros:**

- `url` (string): URL do endpoint
- `body` (string): Corpo da requisição (geralmente JSON ou dados de formulário)
- `headers` (tabela, opcional): Cabeçalhos HTTP
- `options` (tabela, opcional): Opções adicionais

**Exemplo:**

```lua
local dados_json = '{"nome": "Novo Usuário", "email": "usuario@exemplo.com"}'

local resultado = http.post("https://api.exemplo.com/usuarios",
    dados_json,
    {
        ["Content-Type"] = "application/json",
        ["Authorization"] = "Bearer token123"
    }
)

if resultado.status == 201 then
    print("Usuário criado com sucesso!")
    print("Resposta:", resultado.body)
else
    print("Falha ao criar usuário. Status:", resultado.status)
end
```

### `http.put(url, body, headers, options)`

Realiza uma requisição HTTP PUT para atualizar recursos.

**Parâmetros:**

- `url` (string): URL do endpoint
- `body` (string): Corpo da requisição com dados atualizados
- `headers` (tabela, opcional): Cabeçalhos HTTP
- `options` (tabela, opcional): Opções adicionais

**Exemplo:**

```lua
local dados_atualizados = '{"nome": "Usuário Atualizado", "ativo": true}'

local resultado = http.put("https://api.exemplo.com/usuarios/1",
    dados_atualizados,
    {
        ["Content-Type"] = "application/json",
        ["Authorization"] = "Bearer token123"
    }
)

if resultado.status == 200 then
    print("Usuário atualizado com sucesso!")
else
    print("Falha na atualização. Status:", resultado.status)
end
```

### `http.delete(url, body, headers, options)`

Realiza uma requisição HTTP DELETE para remover recursos.

**Parâmetros:**

- `url` (string): URL do endpoint
- `body` (string, opcional): Corpo da requisição (opcional para DELETE)
- `headers` (tabela, opcional): Cabeçalhos HTTP
- `options` (tabela, opcional): Opções adicionais

**Exemplo:**

```lua
local resultado = http.delete("https://api.exemplo.com/usuarios/1",
    nil,
    {["Authorization"] = "Bearer token123"}
)

if resultado.status == 204 then
    print("Usuário removido com sucesso!")
else
    print("Falha ao remover usuário. Status:", resultado.status)
end
```

### `http.head(url, body, headers, options)`

Realiza uma requisição HTTP HEAD para obter apenas cabeçalhos.

**Parâmetros:**

- `url` (string): URL do endpoint
- `body` (string, opcional): Corpo da requisição
- `headers` (tabela, opcional): Cabeçalhos HTTP
- `options` (tabela, opcional): Opções adicionais

**Exemplo:**

```lua
local resultado = http.head("https://api.exemplo.com/usuarios/1",
    nil,
    {["Authorization"] = "Bearer token123"}
)

print("Status da verificação:", resultado.status)
-- A resposta HEAD geralmente não tem corpo
```

## Informações Adicionais

### URL Automática

Se a URL não contiver um esquema (como `http://` ou `https://`), o sistema automaticamente adiciona `http://` como prefixo.

```lua
-- Estas duas chamadas são equivalentes:
local r1 = http.get("api.exemplo.com/dados")
local r2 = http.get("http://api.exemplo.com/dados")
```

### Verificação SSL

Por padrão, a verificação de certificados SSL está habilitada. Para desabilitar (útil em ambientes de desenvolvimento/teste):

**Atenção:** Desabilitar a verificação SSL (`verify = false`) expõe a conexão a ataques "man-in-the-middle" e deve ser usado **apenas** em ambientes de desenvolvimento ou teste controlados. Nunca utilize esta opção em produção com servidores reais ou com dados sensíveis.

```lua
local resultado = get("https://servidor-local.com",
    nil,
    nil,
    {verify = false}
)
```

### Charsets

É possível especificar um charset diferente para decodificar a resposta:

```lua
local resultado = get("https://api.exemplo.com/dados",
    nil,
    nil,
    {charset = "iso-8859-1"}
)
```

## Exemplo de Uso

```lua
-- Exemplo de monitoramento de API
function verificar_saude_api()
    local resultado = http.get("https://api.exemplo.com/health",
        nil,
        {["User-Agent"] = "MonstaAgent/1.0"}
    )

    if resultado.status == 200 then
        local dados = resultado.body
        -- Processar resposta JSON se necessário
        print("API está saudável")
        return true
    else
        print("API com problemas. Status:", resultado.status)
        return false
    end
end
```

## Notas Importantes

1. **Timeout**: O timeout padrão é o timeout global configurado para scripts Lua no sistema.
2. **Performance**: Use conexões persistentes quando fizer múltiplas requisições para o mesmo servidor.
3. **Segurança**: Nunca desabilite a verificação SSL em produção sem necessidade.