×

支付宝小程序介绍

支付宝小程序 开发者入驻支付宝小程序 创建小程序支付宝小程序 开发准备支付宝小程序 提审、发布与修改

支付宝小程序 开放能力

支付宝小程序 获取会员信息支付宝小程序 接入支付支付宝小程序 芝麻信用评分(普惠版)支付宝卡包产品介绍alipay.system.oauth.token(换取授权访问令牌)蚂蚁金服支付宝开发文档——第三方应用授权支付宝小程序介绍 信用借还支付宝小程序 二维码支付宝小程序 安全检测支付宝小程序DEMO

支付宝小程序开发文档

蚂蚁支付宝小程序开发教程手册文档

支付宝小程序 框架

支付宝小程序框架 概述·overview支付宝小程序框架 App支付宝小程序框架 Page支付宝小程序框架 视图层·axml支付宝小程序框架 事件·events支付宝小程序框架 样式·acss支付宝小程序框架 兼容·compatibility

支付宝小程序 组件

支付宝小程序 视图容器

支付宝小程序组件 视图容器·View支付宝小程序组件 滑块视图容器·Swiper支付宝小程序组件 可滚动视图区域·Scroll View

支付宝小程序 基础内容

支付宝小程序组件 文本·Text支付宝小程序组件 图标·Icon支付宝小程序组件 进度条·Progress

支付宝小程序 表单组件

支付宝小程序表单组件 单选项目·Switch支付宝小程序表单组件 滑动选择器·Slider支付宝小程序表单组件 输入框·Textarea支付宝小程序表单组件 Label支付宝小程序表单组件 Radio支付宝小程序表单组件 输入框·Input支付宝小程序表单组件 嵌入页面的滚动选择器·Picker View支付宝小程序表单组件 多选项目·Checkbox支付宝小程序表单组件 表单·Form支付宝小程序表单组件 按钮·Button支付宝小程序表单组件 Picker

支付宝小程序 导航

支付宝小程序组件 页面链接·Navigator

支付宝小程序 媒体组件

支付宝小程序组件 图片·Image

支付宝小程序 画布

支付宝小程序组件 画布·Canvas

支付宝小程序 地图

支付宝小程序组件 地图·Map

支付宝小程序 开放组件

支付宝小程序 关注生活号组件 lifestyle支付宝小程序 云客服组件 Contact-button

支付宝小程序 API

支付宝小程序 界面

支付宝小程序API 导航栏支付宝小程序API TabBar支付宝小程序API 交互反馈支付宝小程序API 下拉刷新支付宝小程序API 联系人支付宝小程序API 选择城市支付宝小程序API 选择日期支付宝小程序API 动画·Animation支付宝小程序API 画布·canvas支付宝小程序API 地图支付宝小程序API 键盘支付宝小程序API 滚动支付宝小程序API 节点查询

支付宝小程序 开放接口

支付宝小程序API 用户授权支付宝小程序API 客户端获取会员信息支付宝小程序API 小程序唤起支付支付宝小程序API 小程序二维码支付宝小程序API 跳转支付宝卡包支付宝小程序API 芝麻认证支付宝小程序API 信用借还

支付宝小程序 多媒体

支付宝小程序API 图片·Image支付宝小程序API 缓存支付宝小程序API 文件支付宝小程序API 位置支付宝小程序API 网络

支付宝小程序API 设备

支付宝小程序API 获取基础库版本号支付宝小程序API canIUse支付宝小程序API 系统信息支付宝小程序API 网络状态支付宝小程序API 剪贴板支付宝小程序API 摇一摇支付宝小程序API 震动支付宝小程序API 拨打电话支付宝小程序API 获取服务器时间支付宝小程序API 用户截屏事件支付宝小程序API 屏幕亮度支付宝小程序API 扫码

支付宝小程序API 蓝牙

支付宝小程序蓝牙 快速接入支付宝小程序蓝牙 API列表支付宝小程序API 数据安全支付宝小程序API 分享支付宝小程序API 自定义分析

支付宝小程序 开发工具

支付宝小程序开发工具 概览支付宝小程序开发工具 编码支付宝小程序开发工具 调试支付宝小程序开发工具 上传支付宝小程序开发工具 体验版测试支付宝小程序开发工具 设置支付宝小程序开发工具 ESLint支付宝小程序开发工具 历史更新日志支付宝小程序开发工具 下载支付宝小程序 更新日志支付宝小程序 常见问题如何发布支付宝小程序?如何开发支付宝小程序?

支付宝小程序API 网络


支付宝小程序API 网络

my.httpRequest

向指定服务器发起一个跨域 http 请求。

入参

名称 类型 必填 描述
url String 目标服务器url
headers Object 设置请求的 HTTP 头,默认 {'Content-Type': 'application/x-www-form-urlencoded'}
method String 默认GET,目前支持GET,POST
data String 请求参数
timeout Number 超时时间,单位ms,默认30000
dataType String 期望返回的数据格式,默认json,支持json,text,base64
success Function 调用成功的回调函数
fail Function 调用失败的回调函数
complete Function 调用结束的回调函数(调用成功、失败都会执行)

success 返回值

名称 类型 描述
data String 响应数据,格式取决于请求时的 dataType 参数
status Number 响应码
headers Object 响应头

错误码

error 描述
11 无权跨域
12 网络出错
13 超时
14 解码失败
19 HTTP错误

代码示例

my.httpRequest({
  url: 'http://httpbin.org/post',
  method: 'POST',
  data: {
    from: '支付宝',
    production: 'AlipayJSAPI',
  },
  dataType: 'json',
  success: function(res) {
    my.alert({content: 'success'});
  },
  fail: function(res) {
    my.alert({content: 'fail'});
  },
  complete: function(res) {
    my.hideLoading();
    my.alert({content: 'complete'});
  }
});

注意:如果 httpRequest 调用返回「无权调用该接口」时,则需要在开放平台的 httpRequest 中添加你需要访问的域名地址

my.uploadFile

上传本地资源到开发者服务器。

入参

名称 类型 必填 描述
url String 开发者服务器地址
filePath String 要上传文件资源的本地定位符
fileName String 文件名,即对应的 key, 开发者在服务器端通过这个 key 可以获取到文件二进制内容
fileType String 文件类型,image/video
header Object HTTP 请求 Header
formData Object HTTP 请求中其他额外的 form 数据
success Function 调用成功的回调函数
fail Function 调用失败的回调函数
complete Function 调用结束的回调函数(调用成功、失败都会执行)

success 返回值

名称 类型 描述
data String 服务器返回的数据
statusCode String HTTP 状态码
header Object 服务器返回的 header

错误码

error 描述
11 文件不存在
12 上传文件失败
13 没有权限

代码示例

my.uploadFile({
  url: '请使用自己服务器地址',
  fileType: 'image',
  fileName: 'file',
  filePath: '...',
  success: (res) => {
    my.alert({
      content: '上传成功'
    });
  },
});

my.downloadFile

下载文件资源到本地。

入参

名称 类型 必填 描述
url String 下载文件地址
header Object HTTP 请求 Header
success Function 调用成功的回调函数
fail Function 调用失败的回调函数
complete Function 调用结束的回调函数(调用成功、失败都会执行)

success 返回值

名称 类型 描述
apFilePath String 文件临时存放的位置

错误码

error 描述
12 下载失败
13 没有权限

代码示例

my.downloadFile({
      url: 'http://img.alicdn.com/tfs/TB1x669SXXXXXbdaFXXXXXXXXXX-520-280.jpg',
      success({ apFilePath }) {
        abridge.previewImage({
          urls: [apFilePath],
        });
      },
      fail(res) {
        abridge.alert({
          content: res.errorMessage || res.error,
        });
      },
    });

my.connectSocket

创建一个 WebSocket 的连接;一个支付宝小程序同时只能保留一个 WebSocket 连接,如果当前已存在 WebSocket 连接,会自动关闭该连接,并重新创建一个新的 WebSocket 连接。

入参

名称 类型 必填 描述
url String 目标服务器url
data Object 请求的参数
headers Object 设置请求的头部
success Function 调用成功的回调函数
fail Function 调用失败的回调函数
complete Function 调用结束的回调函数(调用成功、失败都会执行)

错误码

error 描述
1 未知错误
2 网络连接已经存在
3 URL参数为空
4 无法识别的URL格式
5 URL必须以ws或者wss开头
6 连接服务器超时
7 服务器返回的https证书无效
8 服务端返回协议头无效
9 WebSocket请求没有指定Sec-WebSocket-Protocol请求头
10 网络连接没有打开,无法发送消息
11 消息发送失败
12 无法申请更多内存来读取网络数据

示例代码

my.connectSocket({
  url: 'test.php',
  data: {},
  header:{
    'content-type': 'application/json'
  },
  method:"GET",
});

my.onSocketOpen

监听WebSocket连接打开事件。

示例代码

my.connectSocket({
  url: 'test.php',
});

my.onSocketOpen(function(res) {
  console.log('WebSocket 连接已打开!');
});

my.onSocketError

监听WebSocket错误。

示例代码

my.connectSocket({
  url: '开发者的服务器地址'
});

my.onSocketOpen(function(res){
  console.log('WebSocket 连接已打开!');
});

my.onSocketError(function(res){
  console.log('WebSocket 连接打开失败,请检查!');
});

my.sendSocketMessage

通过 WebSocket 连接发送数据,需要先使用 my.connectSocket 发起建连,并在 my.onSocketOpen 回调之后再发送数据。

入参

名称 类型 必填 描述
data String/ArrayBuffer 需要发送的内容
success Function 回调函数
fail Function 调用失败的回调函数
complete Function 调用结束的回调函数(调用成功、失败都会执行)

示例代码

my.sendSocketMessage({
    data: this.data.toSendMessage, // 需要发送的内容
    success: (res) => {
        my.alert({content: '数据发送!' + this.data.toSendMessage});
    },
});

my.onSocketMessage

监听WebSocket接受到服务器的消息事件。

回调返回值

名称 类型
描述 data
String/ArrayBuffer 服务器返回的消息

示例代码

my.connectSocket({
  url: '服务器地址'
})

my.onSocketMessage(function(res) {
  console.log('收到服务器内容:' + res.data)
})

my.closeSocket

入参

名称 类型 必填 描述
success Function 回调函数
fail Function 调用失败的回调函数
complete Function 调用结束的回调函数(调用成功、失败都会执行)

代码示例

关闭WebSocket连接。

my.onSocketOpen(function() {
  my.closeSocket()
})

my.onSocketClose(function(res) {
  console.log('WebSocket 已关闭!')
})

my.onSocketClose

代码示例

监听WebSocket关闭。

onLoad() {
    // 注意: 回调方法的注册在整个小程序启动阶段只要做一次,调多次会有多次回调
    my.onSocketClose((res) => {
      my.alert({content: '连接已关闭!'});
      this.setData({
        sendMessageAbility: false,
        closeLinkAbility: false,
      });
    });
    // 注意: 回调方法的注册在整个小程序启动阶段只要做一次,调多次会有多次回调
    my.onSocketOpen((res) => {
      my.alert({content: '连接已打开!'});
      this.setData({
        sendMessageAbility: true,
        closeLinkAbility: true,
      });
    });

    my.onSocketError(function(res){
      my.alert('WebSocket 连接打开失败,请检查!' + res);
    });

    // 注意: 回调方法的注册在整个小程序启动阶段只要做一次,调多次会有多次回调
    my.onSocketMessage((res) => {
      my.alert({content: '收到数据!' + JSON.stringify(res)});
    });
  }

connect_start() {
    my.connectSocket({
      url: '服务器地址', // 开发者服务器接口地址,必须是 wss 协议,且域名必须是后台配置的合法域名
      success: (res) => {
        my.showToast({
          content: 'success', // 文字内容
        });
      },
      fail:()=>{
        my.showToast({
          content: 'fail', // 文字内容
        });
      }
    });
  },
  • 注意:所有 on 开头的监听事件函数,建议放到 Page 页面的 onLoad() 函数中执行,否则容易造成多次监听同一个重复事件。

分类导航

关注微信下载离线手册

bootwiki移动版 bootwiki
(群号:472910771)