小程序中网络相关的API
网络API列表:
API | 说明 |
---|---|
wx.request | 发起网络请求 |
wx.uploadFile | 上传文件 |
wx.downloadFile | 下载文件 |
wx.connectSocket | 创建 WebSocket 连接 |
wx.onSocketOpen | 监听 WebSocket 打开 |
wx.onSocketError | 监听 WebSocket 错误 |
wx.sendSocketMessage | 发送 WebSocket 消息 |
wx.onSocketMessage | 接受 WebSocket 消息 |
wx.closeSocket | 关闭 WebSocket 连接 |
wx.onSocketClose | 监听 WebSocket 关闭 |
在小程序中使用网络相关的 API 时,需要注意下列问题,请开发者提前了解
服务器域名配置
每个微信小程序需要事先设置一个通讯域名,小程序可以跟指定的域名进行网络通信。包括普通 HTTPS 请求(request)、上传文件(uploadFile)、下载文件(downloadFile) 和 WebSocket 通信(connectSocket)
配置流程
服务器域名请在"小程序后台-设置-开发设置-服务器域名" 中进行配置,配置时需要注意:
1.域名只支持 https (request、uploadFile、downloadFile) 和 wss (connectSocket) 协议;
2.域名不能使用 IP 地址或 localhost
3.域名必须经过 ICP 备案;
4.出于安全考虑,api.weixin.qq.com 不能被配置为服务器域名,相关API也不能在小程序内调用。开发者应将 appsecret 保存到后台服务器中,通过服务器使用 appsecret 获取 accesstoken,并调用相关 API。
5.对于每个接口,分别可以配置最多 20 个域名
HTTPS 证书
小程序必须使用HTTPS请求。小程序内会对服务器域名使用的HTTPS证书进行校验,如果校验失败,则请求不能成功发起。由于系统限制,不同平台对于证书要求的严格程度不同。为了保证小程序的兼容性,建议开发者按照最高标准进行证书配置,并使用相关工具检查现有证书是否符合要求
对证书要求如下: