• 使用注意事項
  • 服務器域名配置
  • 配置流程
  • 網(wǎng)絡請求
    • 超時時間
    • 使用限制
• 云端緩存服務
  • 云端緩存服務域名
  • 開發(fā)者 Server 域名
  • 云端緩存服務數(shù)據(jù)返回
  • 開啟使用云端緩存服務

使用注意事項

服務器域名配置

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

專注于為中小企業(yè)提供成都網(wǎng)站設計、成都做網(wǎng)站、外貿(mào)網(wǎng)站建設服務,電腦端+手機端+微信端的三站合一,更高效的管理,為中小企業(yè)孝感免費做網(wǎng)站提供優(yōu)質(zhì)的服務。我們立足成都，凝聚了一批互聯(lián)網(wǎng)行業(yè)人才，有力地推動了上千余家企業(yè)的穩(wěn)健成長，幫助中小企業(yè)通過網(wǎng)站建設實現(xiàn)規(guī)模擴充和轉(zhuǎn)變。

配置流程

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

• 域名只支持 https（request、uploadFile、downloadFile）和 wss（socket）協(xié)議；

• 域名不能使用 IP 地址、localhost 或端口號；

• 域名必須經(jīng)過 ICP 備案；

• 出于安全考慮，openapi.baidu.com 不能被配置為服務器域名，相關(guān) API 也不能在小程序內(nèi)調(diào)用。開發(fā)者應將 App Secret 保存到自有后臺服務器中，通過服務器使用 App Secret 獲取 access_token ，并調(diào)用相關(guān) API ；

• 對于每個接口，分別可以配置最多 20 個域名。

在開發(fā)階段，通過對開發(fā)者工具中“校驗域名”的設置，可以實現(xiàn)線上相同體驗。具體使用請參考校驗域名。

網(wǎng)絡請求

超時時間

• request 默認超時時間是 10s，最大超時時間是 60s ；

• uploadFile、downloadFile、socket 默認超時時間和最大超時時間都是 60s ；

• 超時時間可以在 app.json 中配置。

使用限制

• request 最大并發(fā)數(shù)在 iOS 端為 6 ；Android 端同一域名下最大并發(fā)數(shù)為 5，且在 Android 端上同一個小程序最大并發(fā)數(shù)上限為 64 。

• websocket 最大并發(fā)數(shù) 5 。

• 網(wǎng)絡請求的 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ā)者工具中設置。

云端緩存服務

云端緩存服務是在小程序端和開發(fā)者服務端之間，搭建的緩存轉(zhuǎn)發(fā)通道。swan.request 能力在未開啟緩存通道時，請求由小程序端訪問開發(fā)者服務端；在開啟緩存服務后，請求由小程序端，經(jīng)過緩存服務轉(zhuǎn)發(fā)，若 swan.request 對應 url 未命中緩存服務，則請求會經(jīng)緩存服務轉(zhuǎn)發(fā)到開發(fā)者服務端，緩存服務緩存開發(fā)者服務端返回的 HTTP Response ，若命中緩存，則直接返回給小程序端。通過該通道，小程序端可以快速、穩(wěn)定獲取開發(fā)者服務端的數(shù)據(jù)。

云端緩存服務域名

緩存服務通過域名訪問，域名地址為：https://storage.smartapps.cn 。

開發(fā)者 Server 域名

若開啟緩存服務，開發(fā)者服務端的域名通過 swan.request 的 HTTP Header 中新定義的 key 來指定，其中 key 為：Developer-Server-Domain 。

云端緩存服務數(shù)據(jù)返回

swan.request 以 HTTP 方式訪問開發(fā)者服務，若開啟云端緩存服務，則緩存服務會將開發(fā)者服務返回的數(shù)據(jù)進行一次封裝。封裝之后的 HTTP Response Body 包括以下幾個字段：errno、errmsg、data、header ，其中 errno、errmsg 為緩存服務返回的錯誤碼和錯誤信息；header 為開發(fā)者服務返回的 HTTP Response Header ；data 字段為開發(fā)者服務返回的 HTTP Response Body 進行 base64 加密的字符串數(shù)據(jù)。

開啟使用云端緩存服務

目前云端緩存服務尚未對所有小程序開發(fā)者開放，若開發(fā)者需要接入緩存服務，請聯(lián)系：[email protected] 。

網(wǎng)站題目：創(chuàng)新互聯(lián)百度小程序教程：使用注意事項
文章鏈接：http://uogjgqi.cn/article/djsjdhp.html