百度智能小程序 使用注意事項

使用注意事項

服務器域名配置

每個智能小程序需要事先設置一個通訊域名，小程序可以跟指定的域名與進行網絡通信。包括普通 HTTPS 請求（request）、上傳文件（uploadFile）、下載文件（downloadFile) 和 WebSocket 通信（connectSocket）。

配置流程

服務器域名請在 “智能小程序后臺->設置->開發(fā)設置->服務器域名” 中進行配置，配置時需要注意：

• 域名只支持 https (request、uploadFile、downloadFile) 和 wss (socket) 協(xié)議；
• 域名不能使用 IP 地址、localhost 或端口號；
• 域名必須經過 ICP 備案；
• 出于安全考慮，openapi.baidu.com 不能被配置為服務器域名，相關 API 也不能在小程序內調用。開發(fā)者應將 App Secret 保存到自有后臺服務器中，通過服務器使用 App Secret 獲取 access_token，并調用相關 API；
• 對于每個接口，分別可以配置最多 20 個域名。

網絡請求

超時時間

• 默認超時時間和最大超時時間都是 60s；
• 超時時間可以在 app.json 中配置。

使用限制

• request 最大并發(fā)數在 iOS 端為 6；Android 端同一域名下最大并發(fā)數為 5，且在 Android 端上同一個小程序最大并發(fā)數上限為 64。
• websocket 最大并發(fā)數 5。
• 網絡請求的 header 中 referer 不可設置。
  • 其格式固定為{域名}/{appKey}/{version}/page-frame.html 。
  • 自基礎庫版本 V3.170.0 起，其中域名由原來的 https://smartapp.baidu.com 更改為 https://smartapps.cn 。
  • 其中 {appkey} 為小程序的 appkey。
  • {version} 為小程序的版本號，版本號為 0 表示為開發(fā)版、體驗版以及審核版本，版本號為 devtools 表示為開發(fā)者工具，其余為正式版本，正式版本號發(fā)布前在開發(fā)者工具中設置。