小程序局域網(wǎng)通信API插件使用說明，小程序基礎(chǔ)庫2.4.0提供了wx.startLocalServiceDiscovery等一系列mDNS API，可以用來獲取局域網(wǎng)內(nèi)提供 mDNS 服務(wù)的設(shè)備的IP。wx.request/wx.connectSocket/wx.uploadFile/wx.downloadFile的url參數(shù)允許為 ${IP}:${PORT}/${PATH} 的格式，當(dāng)且僅當(dāng)IP與手機IP處在同一網(wǎng)段且不與本機IP相同（一般來說，就是同一局域網(wǎng)，如連接在同一個wifi下）時，請求/連接才會成功。 在這種情況下，不會進行安全域的校驗，不要求必須使用 https/wss，也可以使用 http/ws。

服務(wù)器域名配置 每個微信小程序需要事先設(shè)置一個通訊域名，小程序只可以跟指定的域名與進行網(wǎng)絡(luò)通信。包括普通 HTTPS 請求（request）、上傳文件（uploadFile）、下載文件（downloadFile) 和 WebSocket 通信（connectSocket） 配置流程 服務(wù)器域名請在 「小程序后臺-設(shè)置-開發(fā)設(shè)置-服務(wù)器域名」 中進行配置，配置時需要注意： 域名只支持 https (request、uploadFile、downloadFile) 和 wss (connectSocket) 協(xié)議； 域名不能使用 IP 地址或 localhost； 域名必須經(jīng)過 ICP 備案； 出于安全考慮，api.weixin.qq.com 不能被配置為服務(wù)器域名，相關(guān)API也不能在小程序內(nèi)調(diào)用。 開發(fā)者應(yīng)將 appsecret 保存到后臺服務(wù)器中，通過服務(wù)器使用 appsecret 獲取 accesstoken，并調(diào)用相關(guān) API； 對于每個接口，分別可以配置最多 20 個域名。

HTTPS 證書，小程序必須使用 HTTPS 發(fā)起網(wǎng)絡(luò)請求。請求時系統(tǒng)會對服務(wù)器域名使用的 HTTPS 證書進行校驗，如果校驗失敗，則請求不能成功發(fā)起。由于系統(tǒng)限制，不同平臺對于證書要求的嚴(yán)格程度不同。為了保證小程序的兼容性，建議開發(fā)者按照最高標(biāo)準(zhǔn)進行證書配置，并使用相關(guān)工具檢查現(xiàn)有證書是否符合要求。 對證書要求如下： HTTPS 證書必須有效； 證書必須被系統(tǒng)信任，即根證書被已系統(tǒng)內(nèi)置 部署 SSL 證書的網(wǎng)站域名必須與證書頒發(fā)的域名一致 證書必須在有效期內(nèi) 證書的信任鏈必需完整（需要服務(wù)器配置） iOS 不支持自簽名證書; iOS 下證書必須滿足蘋果 App Transport Security (ATS) 的要求; TLS 必須支持 1.2 及以上版本。部分舊 Android 機型還未支持 TLS 1.2，請確保 HTTPS 服務(wù)器的 TLS 版本支持 1.2 及以下版本; 部分 CA 可能不被操作系統(tǒng)信任，請開發(fā)者在選擇證書時注意小程序和各系統(tǒng)的相關(guān)通告。 Chrome 56/57 內(nèi)核對 WoSign、StartCom 證書限制周知 證書有效性可以使用 openssl s_client -connect example.com:443 命令驗證，也可以使用其他在線工具。 除了網(wǎng)絡(luò)請求 API 外，小程序中其他 HTTPS 請求如果出現(xiàn)異常，也請按上述流程進行檢查。如 https 的圖片無法加載等。

網(wǎng)絡(luò)請求 超時時間 默認(rèn)超時時間和最大超時時間都是 60s； 超時時間可以在 app.json 中配置。 使用限制 網(wǎng)絡(luò)請求的 referer header 不可設(shè)置。其格式固定為 https://servicewechat.com/{appid}/{version}/page-frame.html，其中 {appid} 為小程序的 appid，{version} 為小程序的版本號，版本號為 0 表示為開發(fā)版、體驗版以及審核版本，版本號為 devtools 表示為開發(fā)者工具，其余為正式版本； request、uploadFile、downloadFile 的最大并發(fā)限制是 10 個； 小程序進入后臺運行后（非置頂聊天），如果 5s 內(nèi)網(wǎng)絡(luò)請求沒有結(jié)束，會回調(diào)錯誤信息 fail interrupted；在回到前臺之前，網(wǎng)絡(luò)請求接口調(diào)用都會無法調(diào)用。 返回值編碼 建議服務(wù)器返回值使用 UTF-8 編碼。對于非 UTF-8 編碼，小程序會嘗試進行轉(zhuǎn)換，但是會有轉(zhuǎn)換失敗的可能。 小程序會自動對 BOM 頭進行過濾（只過濾一個BOM頭）。 回調(diào)函數(shù) 只要成功接收到服務(wù)器返回，無論 statusCode 是多少，都會進入 success 回調(diào)。請開發(fā)者根據(jù)業(yè)務(wù)邏輯對返回值進行判斷。

插件調(diào)用 API 的限制 插件可以調(diào)用的 API 與小程序不同，主要有兩個區(qū)別： 插件的請求域名列表與小程序相互獨立； 一些 API 不允許插件調(diào)用（這些函數(shù)不存在于 wx 對象下）。 wx.login 和 wx.requestPayment 在插件中不能使用，但可以通過插件功能頁來 獲得用戶信息 和 進行支付 ，請參考插件功能頁。