服务概述
为了更好的服务开发者和ThinkPHP生态,官方优选优质稳定的短信服务商正式推出了短信API服务,目前仅支持验证码和通知短信,后续还会陆续开通更多的短信服务。
由于短信服务是单独规划和设计的,调用接口统一纳入了ThinkAPI
服务,所以我们对短信API接口做了统一规划,将来还会陆续接入更多的短信服务通道和短信业务,由于调用参数和返回数据等规范已经统一,所以不会影响原有接口的使用。
接口调用(调用须知)
短信发送之前,首先要完成模板和签名的申请,登录市场后点击右上角用户头像选择“我的服务->短信服务”,在签名管理和模板管理里面申请即可,审核通过后才可以进行短信发送调用。一旦检查发现有任何违规内容发送的话,我们将会对签名和模板进行冻结,已购买的套餐资费不退,并且保留追究相关责任的权利。
请求地址
GET https://api.topthink.com/sms/send
请求参数
参数名称 类型 必须 描述
signId Number 是 签名id,在我的服务->短信服务->签名管理里面查看
templateId Number 是 模板id,在我的服务->短信服务->模板管理里面查看
phone String 是 要发送的国内11位手机号码
params Json 否 模板变量 使用Json对象格式
返回data
参数
名称 类型 说明
id String 短信发送任务id
注意:短信发送最终是否成功的确认是运营商异步确认的,所以需要在我的服务->短信服务->发信记录里面确认,最终的计费也是以发信记录里面的成功次数来计费。
SDK调用
$client = new Client("YourAppCode");
$result = $client->smsSend()
->withSignId('78')
->withTemplateId('234')
->withPhone('15687902345')
->withParams('{"code": "7865"}')
->request();
dump($result);
返回结果示例:
{
"code": 0,
"message": "发送成功",
"data":{
"id": "6055df2f45e10"
}
}
接口费用(¥0.035/次起)
目前通知类短信和验证码短信的单次价格是¥
0.035
起,采用套餐包的方式购买次数。
更多接口服务
ThinkAPI
统一API
接口服务是由官方联合合作伙伴封装的一套接口调用服务及SDK
,旨在帮助ThinkPHP
开发者更方便和更低成本调用官方及第三方的提供的各类API
接口及服务,从而更好的构建开发者生态。更多API接口可以参见这里。