发送短信 1010+

接口声明

  1. { "name": "system.sms" }

导入模块

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

接口定义

sms.send(OBJECT)

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

权限要求

发送短信

参数:

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

示例:

  1. sms.send({
  2. address'123456',
  3. content'这是短信内容',
  4. success: function () {
  5. console.log('handling success')
  6. },
  7. fail: function (data, code) {
  8. console.log("handling fail, code=" + code);
  9. }
  10. })

sms.readSafely(OBJECT) 1050+

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

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

参数:

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

示例

  1. sms.readSafely({
  2. success: function(data) {
  3. console.log('handling success. message=' + data.message)
  4. },
  5. fail: function(data, code) {
  6. console.log('handling fail, result data=' + data + ', code=' + code)
  7. }
  8. })

后台运行限制

禁止使用。后台运行详细用法参见后台运行 脚本