mina:api_interface
这是本文档旧的修订版!
6.API 接口
API发起请求 wx.request
在小程序/小游戏中使用网络相关的 API 时,需要注意下列问题:
- 每个微信小程序需要事先设置通讯域名,小程序只可以跟指定的域名进行网络通信。
- 服务器域名请在 「小程序后台-开发-开发设置-服务器域名」 中进行配置。
- 域名只支持 https,不能使用 IP 地址,可以配置端口。
- 域名必须经过 ICP 备案。
- api.weixin.qq.com 不能被配置为服务器域名,相关API也不能在小程序内调用。通过服务器使用 getAccessToken 接口获取 access_token,并调用相关 API;
- 超时时间可以在 app.json 或 game.json 中通过 networktimeout 配置。
wx.request({ url: 'test.php', //仅为示例,并非真实的接口地址 data: { x: '' , y: '' }, header:{ "Content-Type":"application/json" //返回的数据是什么类型 }, success: function(res) { console.log(res.data) } }) requestTask.abort() // 取消请求任务
OBJECT参数说明
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| url | String | 是 | 开发者服务器接口地址 |
| data | data | 请求的参数 | |
| success | Function | 收到开发者服务成功返回的回调函数,res = {data: '开发者服务器返回的内容'} | |
| complete | Function | 接口调用结束的回调函数(调用成功、失败都会执行) |
success返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| data | Object/String/ArrayBuffer | 开发者服务器返回的数据 |
| statusCode | Number | 开发者服务器返回的 HTTP 状态码 |
| header | Object | 开发者服务器返回的 HTTP Response Header |
以天气api为例
//获取数据 wx.request({ url: '******', //这里填写你的接口路径 header: { //这里写你借口返回的数据是什么类型,这里就体现了微信小程序的强大,直接给你解析数据,再也不用去寻找各种方法去解析json,xml等数据了 'Content-Type': 'application/json' }, data: {//这里写你要请求的参数 x: '' , y: '' }, success: function(res) { //这里就是请求成功后,进行一些函数操作 console.log(res.data) } })
// js文件 onLoad: function () { var that = this//不要漏了这句,很重要 wx.request({ url: 'https://www.apiopen.top/weatherApi?city=成都', headers: { 'Content-Type': 'application/json' }, success: function (res) { that.setData({ date: res.data.data.forecast[0].date, fengxiang: res.data.data.forecast[0].fengxiang, type: res.data.data.forecast[0].type //res代表success函数的事件对,data是固定的,fengxiang是是上面json数据中fengxiang }) } }) }
//wxml文件
{{date}}
{{fengxiang}}
{{type}}
公共参数封装
媒体
文件
数据
位置
设备
mina/api_interface.1598071444.txt.gz · 最后更改: 2020/08/22 12:44 由 sabertoy
