# reqwest.header

## 功能

设置一个或一组请求头。

## 语法

```bt
reqwest(url).header(key, value)
reqwest(url).header(headers)
```

## 参数

| 参数 | 类型 | 必填 | 默认值 | 说明 |
| ------ | ------ | ------ | ------ | ------ |
| key | String | 否 | 无 | 请求头名称。 |
| value | Any | 否 | 无 | 请求头值。 |
| headers | Object | 否 | 无 | 请求头映射对象；键和值的规则见下方。 |

## headers 对象结构

| 键 | 值类型 | 说明 |
| ------ | ------ | ------ |
| 请求头名称 | Any | 请求头值；调用时会转为字符串。 |

## 返回值

| 类型 | 说明 |
| ------ | ------ |
| Reqwest | 返回新的请求构建器。 |

## 示例

```bt
// 设置单个请求头。
request = reqwest('https://example.com').header('Accept', 'text/plain')
result = type(request)

// 输出：Reqwest
print result
```

## 注意事项

- 必须传对象或 key/value 参数，否则报错。