<commit_before># ChinaSMS 短信平台 Ruby 接口

[![Build Status](https://travis-ci.org/saberma/china_sms.png?branch=master)](https://travis-ci.org/saberma/china_sms)

## 支持以下短信平台

所有短信平台都禁止发送私人短信，并要求在短信内容末尾加上签名后缀，如【19屋】

* [推立方](http://tui3.com/) 专注于注册校验码等实时应用，需要[配置内容格式和签名](http://www.tui3.com/Members/smsconfigv2/)，会自动在短信加上签名后缀。短信计数：移动/联通每条短信的最大长度为64字符，电信每条最大长度60字符（半角、全角各算一个）。超过该长度后，短信后面自动增加分页信息(x/y),此时，每条短信最大长度需要再减3（不超过10页）
* [云片网](http://www.yunpian.com/) 专注于帮助企业与客户更好的沟通, 提供短信服务, 功能强大, 可以配置多种[模板](http://www.yunpian.com/api/tpl.html), 实时性高, 定制型强, 价格优惠.
* [短信宝](http://www.smsbao.com/)
* [畅友网络](http://www.chanyoo.cn/) 群发短信需要半小时左右的时间审核，星期五等繁忙时段会有几个小时的延时，不适合发送注册校验码等实时短信，单次最多发送500个号码
* [亿美软通](http://www.emay.cn/)

非常感谢 [推立方](http://tui3.com/) 为 [19屋活动平台](http://19wu.com) 提供短信赞助。

## 安装

加入以下代码到 Gemfile:

    gem 'china_sms'

然后执行:

    $ bundle

或者直接安装：

    $ gem install china_sms

## 使用

```ruby
# 支持 :tui3, :yunpian, :smsbao, :chanyoo, :emay 短信接口
ChinaSMS.use :tui3, username: 'YOUR_USERNAME', password: '<PASSWORD>'
ChinaSMS.to '13912345678', '[Test]China SMS gem has been released.'

# :yunpian 的参数有
#    :company    默认是 `云片网`
#    :tpl_id     默认是 2

ChinaSMS.use :yunpian, password: '<PASSWORD>'
ChinaSMS.to '13912345678', '[Test]China SMS gem has been released.', company: '19Wu'

```

## 贡献

```bash
git clone <EMAIL>:saberma/china_sms.git<commit_msg>Update readme about yunpian tpl_send<commit_after># ChinaSMS 短信平台 Ruby 接口

[![Build Status](https://travis-ci.org/saberma/china_sms.png?branch=master)](https://travis-ci.org/saberma/china_sms)

## 支持以下短信平台

所有短信平台都禁止发送私人短信，并要求在短信内容末尾加上签名后缀，如【19屋】

* [推立方](http://tui3.com/) 专注于注册校验码等实时应用，需要[配置内容格式和签名](http://www.tui3.com/Members/smsconfigv2/)，会自动在短信加上签名后缀。短信计数：移动/联通每条短信的最大长度为64字符，电信每条最大长度60字符（半角、全角各算一个）。超过该长度后，短信后面自动增加分页信息(x/y),此时，每条短信最大长度需要再减3（不超过10页）
* [云片网](http://www.yunpian.com/) 专注于帮助企业与客户更好的沟通, 提供短信服务, 功能强大, 可以配置多种[模板](http://www.yunpian.com/api/tpl.html), 实时性高, 定制型强, 价格优惠.
* [短信宝](http://www.smsbao.com/)
* [畅友网络](http://www.chanyoo.cn/) 群发短信需要半小时左右的时间审核，星期五等繁忙时段会有几个小时的延时，不适合发送注册校验码等实时短信，单次最多发送500个号码
* [亿美软通](http://www.emay.cn/)

非常感谢 [推立方](http://tui3.com/) 为 [19屋活动平台](http://19wu.com) 提供短信赞助。

## 安装

加入以下代码到 Gemfile:

    gem 'china_sms'

然后执行:

    $ bundle

或者直接安装：

    $ gem install china_sms

## 使用

```ruby
# 支持 :tui3, :yunpian, :smsbao, :chanyoo, :emay 短信接口
ChinaSMS.use :tui3, username: 'YOUR_USERNAME', password: '<PASSWORD>'
ChinaSMS.to '13912345678', '[Test]China SMS gem has been released.'


# :yunpian
#   如果content(第二个参数) 是字符串
#     调用 通用接口 发送短信
#   如果是 Hash
#     调用 模板接口 发送短信
#     可选参数：
#       :tpl_id 默认是 2

ChinaSMS.use :yunpian, password: '<PASSWORD>'

# 通用接口
ChinaSMS.to '13912345678', '[Test]China SMS gem has been released.'

# 模板接口
# 模板是 "您的验证码是#code#【#company#】”
tpl_params = { code: 123, company: '19wu' }
ChinaSMS.to '13912345678', tpl_params, tpl_id: 1

```

## 贡献

```bash
git clone <EMAIL>:saberma/china_sms.git
{'fraction_non_alphanumeric': 0.17749658002735977, 'fraction_numerical': 0.037277701778385776, 'mean_word_length': 5.081081081081081, 'pattern_counts': {'":': 0, '<': 9, '<?xml version=': 0, '>': 9, 'https://': 4, 'lorem ipsum': 0, 'www.': 12, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3533913', 'n_tokens_mistral': 1889, 'n_tokens_neox': 2016, 'n_words': 200}