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

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

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

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

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