# web.rest.jsonLiteClient 库模块帮助文档

<details>  <summary>流式输出</summary>  <p>
web.rest.jsonLiteClient 客户端在调用 HTTP 接口时如果指定回调函数则自动支持 SSE,NDJSON,JSONL 流式输出，
并自动支持标准 JSON 对象数组格式的流式输出。

SSE,NDJSON,JSONL 流式输出请参考范例：
https://www.aardio.com/zh-cn/docs/examples/Web/REST/sse.html

标准 JSON 对象数组格式的流式输出规则为：

- Content-Type 响应头必须指定了 JSON 格式，例如 `application/json`。
- 服务器响应的完整输出必须是一个对象数组，第一个字符必须是 `[`，最后一个字符必须是 `]`。
- 每个块必须是一个使用 `{}` 包围的 JSON 对象，对象之间必须以 `,` 分隔。
</p></details>

[必读：web.rest 使用指南](https://www.aardio.com/zh-cn/docs/library-guide/std/web/rest/client.html

## 全局对象 成员列表 <a id="global" href="#global">&#x23;</a>

### web.rest..jsonLiteClient <a id="web.rest..jsonLiteClient" href="#web.rest..jsonLiteClient">&#x23;</a>
创建 REST 客户端。  
请求参数使用普通表单编码（application/x-www-form-urlencoded ）。  
请求参数中的参数值如果是表，则首先转换为 JSON 。  
如果请求参数值为函数，则每次请求调用该函数取值。  
所有参数值转换为字符串后并用 URLEncode 编码。  

返回数据如果为 JSON 格式或者表单编码则自动解析为对象  

UrlEncoded 解码 时会自动解析 JSON 字段值（必须是对象或数组）  

如果请求编码也是 JSON ，请改用 web.rest.jsonClient

## web.rest 成员列表 <a id="web.rest" href="#web.rest">&#x23;</a>

### web.rest.jsonLiteClient <a id="web.rest.jsonLiteClient" href="#web.rest.jsonLiteClient">&#x23;</a>
REST 客户端。  
请求参数使用普通表单编码（application/x-www-form-urlencoded ）。  
请求参数中的参数值如果是表，则首先转换为 JSON 。  
如果请求参数值为函数，则每次请求调用该函数取值。  
所有参数值转换为字符串后并用 URLEncode 编码。  

返回数据如果为 JSON 格式或者表单编码则自动解析为对象  

UrlEncoded 解码 时会自动解析 JSON 字段值（必须是对象或数组）  

如果请求编码也是 JSON ，请改用 web.rest.jsonClient 。

### web.rest.jsonLiteClient("UserAgent","代理服务器","绕过代理的主机",连接选项) <a id="web.rest.jsonLiteClient" href="#web.rest.jsonLiteClient">&#x23;</a>
创建 REST 客户端，所有参数可选。  
UserAgent 用于自定义 User-Agent 请求标头，用于服务器识别请求程序特征。  
HTTP 代理服务器请指定为 "代理服务器地址:端口" 格式，  

SOCKS 代理服务器请指定为 "socks=代理服务器地址:端口" 格式   
└──  [代理格式说明](https://www.aardio.com/zh-cn/docs/library-guide/std/inet/proxy.html)  

"绕过代理的主机" 用法参考 inet.setProxy 源码的示例，一般不需要指定。  
连接选项可用一个数值参数指定打开会话的选项，一般不需要指定。

### web.rest.jsonLiteClient() <a id="web.rest.jsonLiteClient" href="#web.rest.jsonLiteClient">&#x23;</a>
[返回对象:webRestClientObject](https://www.aardio.com/zh-cn/docs/library-reference/web/rest/client.html#webRestClientObject)
