阅读(152) (0)

快应用 发送短信

2018-06-25 15:41:58 更新

接口声明

{"name": "system.sms"}

导入模块

import sms from '@system.sms' 
或 
const sms = require('@system.sms')

接口定义

sms.send(OBJECT)

发送短信,每次发送都需要用户授权

权限要求

发送短信

参数:

参数名 类型 必填 说明
address String 目标号码
content String 短信内容(不可超过70字符)
success Function 成功回调
fail Function 失败回调
complete Function 执行结束后的回调
fail返回错误代码
错误码 说明
201 用户拒绝,获取发短信权限失败

示例:

sms.send({
  address:'123456',
  content:'这是短信内容',
  success: function () {
    console.log('handling success')
  },
  fail: function (data, code) {
    console.log("handling fail, code=" + code);
  }
})

sms.readSafely(OBJECT) 1050+

获取手机短信内容,用于获取手机验证码等场景(仅允许获取 5 分钟内的应用短信)。 安全性:短信中通过增加应用签名 hash 信息,接口获取短信时通过 hash 来验证区分该应用的短信内容。 短信格式:11 位签名 hash 字符放到短信末尾,可通过 Debugger 工具获取。

【某某应用】您的验证码是:1111,5分钟内有效,请勿泄漏。如非本人操作,请忽略此信息。
FA+9qCX9VSu

参数:

参数名类型必填说明
timeoutLong超时时间,单位是 ms,默认值为 60000(一分钟)
successFunction成功回调
failFunction失败回调
completeFunction执行结束后的回调
success 返回值:
参数值类型说明
messageString原始短信内容
fail 返回错误代码
错误码说明
204超时返回

示例

sms.readSafely({
  success: function(data) {
    console.log('handling success. message=' + data.message)
  },
  fail: function(data, code) {
    console.log('handling fail, result data=' + data + ', code=' + code)
  }
})

后台运行限制

manifest 中申请后可用。

后台运行详细用法参见 后台运行脚本