舟山闪爸电子技术有限公司

微信小程序API發(fā)起請求,wx.request發(fā)起請求

wx.request(OBJECT)


OBJECT參數(shù)說明:

參數(shù)名 類型 必填 說明
url String 開發(fā)者服務(wù)器接口地址
data Object、String 請求的參數(shù)
header Object 設(shè)置請求的 header , header 中不能設(shè)置 Referer
method String 默認為 GET,有效值:OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, CONNECT
dataType String 默認為 json。如果設(shè)置了 dataType 為 json,則會嘗試對響應(yīng)的數(shù)據(jù)做一次 JSON.parse
success Function 收到開發(fā)者服務(wù)成功返回的回調(diào)函數(shù),res = {data: '開發(fā)者服務(wù)器返回的內(nèi)容'}
fail Function 接口調(diào)用失敗的回調(diào)函數(shù)
complete Function 接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會執(zhí)行)

 

success返回參數(shù)說明:

參數(shù) 說明 最低版本
data 開發(fā)者服務(wù)器返回的數(shù)據(jù)  
statusCode 開發(fā)者服務(wù)器返回的狀態(tài)碼  
header 開發(fā)者服務(wù)器返回的 HTTP Response Header 1.2.0
data 數(shù)據(jù)說明 最終發(fā)送給服務(wù)器的數(shù)據(jù)是 String 類型,如果傳入的 data 不是 String 類型,會被轉(zhuǎn)換成 String 。轉(zhuǎn)換規(guī)則如下:
  • 對于 header['content-type'] 為 'application/json' 的數(shù)據(jù),會對數(shù)據(jù)進行 JSON 序列化
  • 對于 header['content-type'] 為 'application/x-www-form-urlencoded' 的數(shù)據(jù),會將數(shù)據(jù)轉(zhuǎn)換成 query string (encodeURIComponent(k)=encodeURIComponent(v)&encodeURIComponent(k)=encodeURIComponent(v)...)

示例代碼:

wx.request({
  url: 'test.php', //僅為示例,并非真實的接口地址
  data: {
     x: '' ,
     y: ''
  },
  header:{
      "Content-Type":"application/json"
  },
  success: function(res) {
     console.log(res.data)
  }
})

 

 

返回值:

基礎(chǔ)庫 1.4.0 開始支持,低版本需做兼容處理

返回一個requestTask對象,通過requestTask,可中斷請求任務(wù)。

requestTask 對象的方法列表:

方法 參數(shù) 說明 最低版本
abort   中斷請求任務(wù) 1.4.0

示例代碼:

const requestTask = wx.request({
  url: 'test.php', //僅為示例,并非真實的接口地址
  data: {
     x: '' ,
     y: ''
  },
  header: {
      'content-type': 'application/json'
  },
  success: function(res) {
    console.log(res.data)
  }
})

requestTask.abort() // 取消請求任務(wù)

Bug & Tip

  1. tip: content-type 默認為 'application/json'
  2. bug: 開發(fā)者工具0.10.102800版本,headercontent-type設(shè)置異常;
  3. tip: 客戶端的 HTTPS TLS 版本為1.2,但Android的部分機型還未支持 TLS 1.2,所以請確保 HTTPS 服務(wù)器的 TLS 版本支持1.2及以下版本;
  4. tip: 要注意 method 的 value 必須為大寫(例如:GET);
  5. tip: url 中不能有端口;
  6. tip: request 的默認超時時間和最大超時時間都是 60s
  7. tip: request 的最大并發(fā)數(shù)是 5
  8. tip: 網(wǎng)絡(luò)請求的 referer 是不可以設(shè)置的,格式固定為 https://servicewechat.com/{appid}/{version}/page-frame.html,其中{appid}為小程序的 appid,{version}為小程序的版本號,版本號為 0 表示為開發(fā)版。
 

 

更多微信小程序開發(fā)教程,可以關(guān)注。
【本站聲明】
  1、本站文章中所選用的圖片及文字來源于網(wǎng)絡(luò)以及用戶投稿,由于未聯(lián)系到知識產(chǎn)權(quán)人或未發(fā)現(xiàn)有關(guān)知識產(chǎn)權(quán)的登記,如有知識產(chǎn)權(quán)人并不愿意我們使用,如果有侵權(quán)請立即聯(lián)系。
  2、本網(wǎng)站不對文章中所涉及的內(nèi)容真實性、準確性、可靠性負責(zé),僅系客觀性描述,如您需要了解該類商品/服務(wù)詳細的資訊,請您直接與該類商品/服務(wù)的提供者聯(lián)系。


KESION 科汛軟件

KESION 科汛軟件是國內(nèi)領(lǐng)先的在線教育軟件及私域社交電商軟件服務(wù)提供商,長期專注于為企業(yè)提供在線教育軟件及社交電商SaaS平臺解決方案。
公司核心產(chǎn)品云開店SaaS社交電商服務(wù)平臺、在線教育SaaS服務(wù)平臺、教育企業(yè)數(shù)字化SaaS云平臺、企微營銷助手、私有化獨立部署品牌網(wǎng)校和在線教育咨詢等。

KESION 不斷通過技術(shù)創(chuàng)新,提供產(chǎn)品和服務(wù),助力企業(yè)向數(shù)字化轉(zhuǎn)型,通過科技驅(qū)動商業(yè)革新,讓商業(yè)變得更智慧!



▼點擊進入科汛官網(wǎng)了解更多



上/下篇
換一換相關(guān)推薦
精選內(nèi)容
熱點精選