网络

在小程序/小游戏中使用网络相关的 API 时，需要注意下列问题，请开发者提前了解。

1. 服务器域名配置

每个小程序需要事先设置一个通讯域名，小程序只可以跟指定的域名与进行网络通信。包括普通 HTTPS 请求（request）、下载文件（downloadFile)、上传文件（uploadFile）。

配置流程

服务器域名请在 「小程序后台-设置-开发设置-服务器域名」 中进行配置，配置时需要注意：

• 域名只支持 https (request、downloadFile、uploadFile)；
• 域名不能使用 IP 地址或 localhost；
• 域名必须经过 ICP 备案；
• 出于安全考虑，*.bilibili.com 不能被配置为服务器域名，相关API也不能在小程序内调用。 开发者应将 appsecret 保存到后台服务器中，通过服务器使用 appsecret 获取 accesstoken，并调用相关 API；
• 对于每个接口，分别可以配置最多 20 个域名。

2. 网络请求

超时时间

• 默认超时时间和最大超时时间都是 60s
• 超时时间可以在 app.json 中配置

使用限制

• 网络请求的 referer header 不可设置。其格式固定为 https://miniapp.bilibili.com/{appid_vappid}/，其中 {appid} 为小程序的 appid，{vappid}为虚拟小程序ID
• request、downloadFile 的最大并发限制是 10 个；

返回值编码

• 建议服务器返回值使用 UTF-8 编码。

回调函数

• 只要成功接收到服务器返回，无论 statusCode 是多少，都会进入 success 回调。请开发者根据业务逻辑对返回值进行判断。