Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
qq_16800119
unidocs-zh
提交
f410bfce
unidocs-zh
项目概览
qq_16800119
/
unidocs-zh
与 Fork 源项目一致
Fork自
DCloud / unidocs-zh
通知
1
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
f410bfce
编写于
9月 16, 2021
作者:
D
DCloud_LXH
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
docs: uni.configMTLS
上级
a831fa1f
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
50 addition
and
0 deletion
+50
-0
docs/api/request/request.md
docs/api/request/request.md
+50
-0
未找到文件。
docs/api/request/request.md
浏览文件 @
f410bfce
...
...
@@ -132,3 +132,53 @@ requestTask.abort();
-
部分安卓设备,真机运行或debug模式下的网速,低于release模式很多。
-
使用一些比较小众的证书机构(如:CFCA OV OCA)签发的 ssl 证书在安卓设备请求会失败,因为这些机构的根证书不在系统内置根证书库,可以更换其他常见机构签发的证书(如:Let's Encrypt),或者配置 sslVerify 为 false 关闭 ssl 证书验证(不推荐)。
-
单次网络请求数据量建议控制在50K以下(仅指json数据,不含图片),过多数据应分页获取,以提升应用体验。
### uni.configMTLS(OBJECT)
配置自签名证书
App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|
|:-:|:-:|:-:|:-:|:-:|:-:|
|√
`(3.2.7+)`
|x|x|x|x|x|x|x|
**OBJECT 参数说明**
|参数|类型|必填|说明|
|:--|:--|:--|:--|
|certificates|Array
<
`certificate`
>
|是|
`certificates`
为数组,支持为多个域名配置自签名证书|
|success|Function(
`callbackObject`
)|否|收到开发者服务器成功返回的回调函数|
|fail|Function(
`callbackObject`
)|否|接口调用失败的回调函数|
|complete|Function|否|接口调用结束的回调函数(调用成功、失败都会执行)|
**certificate 参数说明**
证书配置项
|参数|类型|必填|说明|
|:--|:--|:--|:--|
| host | String |是| 对应请求的域名(注意:不要协议部分) |
| client | String |否| 客户端证书(服务器端需要验证客户端证书时需要配置此项,格式要求请参考下面的证书格式说明,注意
`iOS`
平台客户端证书只支持
`.p12`
类型的证书)|
| clientPassword | String |否| 客户端证书对应的密码(客户端证书存在时必须配置此项)|
| server |Array
<
String
>
|否| 服务器端证书(客户端需要对服务器端证书做校验时需要配置此项,格式要求请参考下面的证书格式说明,注意
`iOS`
平台服务器端证书只支持
`.cer`
类型的证书)|
**证书格式说明**
1.
文件路径形式:可将证书文件放到工程的 ‘static’ 目录中,然后填写文件路径,示例:
`'/static/client.p12'`
2.
`Base64String`
:将证书文件的二进制转换为
`Base64String`
字符串,然后在字符串前面添加
`'data:cert/pem;base64,'`
前缀,示例:
`'data:cert/pem;base64,xxx'`
xxx 代表真实的证书 base64String
**callbackObject 参数说明**
属性|类型 |说明
:--|:--|:--|
code|Number| 成功返回 0,失败返回相应 code 码
**示例**
```
js
uni
.
configMTLS
({
certificates
:
[{
'
host
'
:
'
www.test.com
'
,
'
client
'
:
'
/static/client.p12
'
,
'
clientPassword
'
:
'
123456789
'
,
'
server
'
:
[
'
/static/server.cer
'
],
}],
success
({
code
})
{}
});
```
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录