Alidayu sms sdk ruby version of Aliyun(阿里云阿里大于短信SDK).

# Manually from RubyGems.org
$ gem install alidayu-sms

# Or Gemfile if you are using Bundler
$ gem alidayu-sms

alisms = Alidayu::Sms.new(sms_template: YOUR_SMS_TEMPLATE, sms_sign: YOUR_SMS_SIGN)
alisms.send_to(138xxxxxxxx, {code: 1234})
# true or false

# or use send! if you wanna raise error
alisms.send_to!(138xxxxxxxx, {code: 1234})
# true or raise Alidayu::RequestError

You can also use send_sms to send Alidayu sms, it's an alias of send_to.

Before you sending any sms message, a valid configuration is necessary. Alidayu-sms supports you use it under Rails or in pure Ruby environment.

The Alidayu-sms configuration file is a YAML file, by default located at config/alidayu.yml. You need to set your Alidayu access_key which you can get from Aliyun. Here is an example configuration file:

# config/alidayu.yml
development: &defaults
  access_key_id: YOUR_ACCESS_KEY_ID
  access_key_secret: YOUR_ACCESS_KEY_SECRET

test:
  <<: *defaults

production:
  <<: *defaults

If you are using Sinatra or anything pure Ruby, use Alidayu::Sms.configuration to configrate Alidayu-sms.

require 'alidayu/sms'

Alidayu::Sms.configuration do |config|
  config.access_key_id = YOUR_ACCESS_KEY_ID
  config.access_key_secret = YOUR_ACCESS_KEY_SECRET
end

Released under the MIT license. See LICENSE file for details.