使用注意事项

# 服务器域名配置

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

# 配置流程

服务器域名请在 “智能小程序后台->设置->开发设置->服务器域名” 中进行配置,配置时需要注意:

  • 域名只支持 https (request、uploadFile、downloadFile) 和 wss (socket) 协议;

  • 域名不能使用 IP 地址、localhost 或端口号;

  • 域名必须经过 ICP 备案;

  • 出于安全考虑,openapi.baidu.com 不能被配置为服务器域名,相关 API 也不能在小程序内调用。开发者应将 App Secret 保存到自有后台服务器中,通过服务器使用 App Secret 获取 access_token,并调用相关 API;

  • 对于每个接口,分别可以配置最多 20 个域名。

# 网络请求

# 超时时间

  • 默认超时时间和最大超时时间都是 60s;

  • 超时时间可以在 app.json 中配置。

# 使用限制

  • request 最大并发数在 iOS 端为 6;Android 端同一域名下最大并发数为 5,且在 Android 端上同一个小程序最大并发数上限为 64。

  • websocket 最大并发数 5。

  • 网络请求的 header 中 referer 不可设置。

    • 其格式固定为{域名}/{appKey}/{version}/page-frame.html 。

    • 自基础库版本 V3.170.0 起,其中域名由原来的 https://smartapp.baidu.com 更改为 https://smartapps.cn 。

    • 其中 {appkey} 为小程序的 appkey。

    • {version} 为小程序的版本号,版本号为 0 表示为开发版、体验版以及审核版本,版本号为 devtools 表示为开发者工具,其余为正式版本,正式版本号发布前在开发者工具中设置。

    图片