网络能力

请求

request


支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎ ✔︎


参数

字段 类型 必填 说明
url string 开发者服务器接口地址
params object 请求参数
headers Object 设置请求的 headers,content-type 默认为 application/json
method string 默认为 GET
paramsType number 请求参数的类型


method的合法值**

说明
GET 使用GET方式
POST 使用POST方式


paramsType的合法值

说明
0 键值对
1 json格式,只支持POST请求,会在header中自动添加content-type:application/json


成功回调返回**

字段 类型 说明
status number 响应码
headers object 响应头
data string 响应数据


示例**

mtl.request({
  url: "https://some-domain.com/api/user",
  method: "get",
  headers: { "X-Requested-With": "XMLHttpRequest" },
  params: {
    ID: 12345
  },
  paramsType: 0,
  success: function(res) {
    var data = res.data; // 返回数据
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

文件上传

uploadFile

文件上传将本地文件上传到指定服务器。客户端发起一个 HTTPS POST 请求,其中 content-typemultipart/form-data

支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎


参数**

字段 类型 必填 说明
url string 指定服务器地址
filePath string 文件路径
header Object HTTP 请求 Header
formData Object HTTP 请求中其他额外的 form data


示例**

mtl.uploadFile({
  url: "",
  filePath: "",
  header: 
  {
    "content-type":"multipart/form-data"
  },
  formData: {},
  success: function(res) {
    // 成功回调
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

文件下载

downloadFile

从网络下载到手机本地并返回本地url

支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎


参数

字段 类型 必填
url string 需要下载资源的url
fileType string 文件格式jpg,txt,pdf等
fileName string 文件名 如abc.jpg等
autoPreview int 是否自动打开预览界面,0不打开,1打开,默认0
header object http请求头部参数
formBody object http请求额外body参数-表单形式
jsonBody string http请求额外参数-json形式


示例

mtl.downloadFile({
  url: "",
  fileType: "",
  fileName: "",
  autoPreview: 0,
  header: {},
  formBody: {},
  jsonBody: "",
  success: function(res) {
        // 成功回调
  },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});