使用注意事項(xiàng)

服務(wù)器域名配置

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

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

配置流程

服務(wù)器域名請(qǐng)?jiān)?“智能小程序后臺(tái) -> 設(shè)置 -> 開發(fā)設(shè)置 -> 服務(wù)器域名” 中進(jìn)行配置，配置時(shí)需要注意：

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

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

網(wǎng)絡(luò)請(qǐng)求

超時(shí)時(shí)間

request 默認(rèn)超時(shí)時(shí)間是 10s，最大超時(shí)時(shí)間是 60s ；
uploadFile、downloadFile、socket 默認(rèn)超時(shí)時(shí)間和最大超時(shí)時(shí)間都是 60s ；
超時(shí)時(shí)間可以在 app.json 中配置。

使用限制

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

云端緩存服務(wù)

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

云端緩存服務(wù)域名

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

開發(fā)者 Server 域名

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

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

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

開啟使用云端緩存服務(wù)

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

名稱欄目：創(chuàng)新互聯(lián)百度小程序教程：使用注意事項(xiàng)
文章起源：http://fisionsoft.com.cn/article/djsjdhp.html

新聞中心