Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
f410bfce
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3191
Star
106
Fork
810
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
93
列表
看板
标记
里程碑
合并请求
69
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
93
Issue
93
列表
看板
标记
里程碑
合并请求
69
合并请求
69
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
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.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录