NiazpardazSms SDK for Ruby

gem 'niazpardaz_sms'

require 'niazpardaz_sms'

# روش 1: ایجاد مستقیم کلاینت
client = NiazpardazSms::Client.new('YOUR_API_KEY')

# روش 2: پیکربندی سراسری
NiazpardazSms.configure do |config|
  config.default_api_key = 'YOUR_API_KEY'
  config.default_timeout = 30
end

client = NiazpardazSms.client

NiazpardazSms.configure do |config|
  config.default_api_key = ENV.fetch('NIAZPARDAZ_API_KEY', nil)
end

require 'sinatra'
require 'niazpardaz_sms'

configure do
  NiazpardazSms.configure do |config|
    config.default_api_key = ENV['NIAZPARDAZ_API_KEY']
  end
end

post '/send_sms' do
  client = NiazpardazSms.client
  result = client.send_sms(
    from_number: params[:from],
    to_number: params[:to],
    message: params[:message]
  )
  
  json result.success? ? { status: 'ok', id: result.batch_sms_id } : { status: 'error' }
end

# config/providers/niazpardaz_sms.rb
Hanami.app.register_provider :niazpardaz_sms do
  start do
    require 'niazpardaz_sms'
    
    NiazpardazSms.configure do |config|
      config.default_api_key = ENV['NIAZPARDAZ_API_KEY']
    end
    
    register 'niazpardaz_sms.client', NiazpardazSms.client
  end
end

require 'niazpardaz_sms'

# ساخت کلاینت با API Key
client = NiazpardazSms::Client.new('YOUR_API_KEY')

# ارسال پیامک
result = client.send_sms(
  from_number: '10001234',
  to_number: '09123456789',
  message: 'سلام از نیازپرداز!'
)

if result.success?
  puts "شناسه ارسال: #{result.batch_sms_id}"
else
  puts "خطا: #{result.result_description}"
end

result = client.send_sms(
  from_number: '10001234',
  to_number: '09123456789',
  message: 'متن پیامک',
  is_flash: false,
  send_delay: nil
)

puts "شناسه ارسال: #{result.batch_sms_id}"
puts "وضعیت: #{result.result_description}"

result = client.send_bulk_sms(
  from_number: '10001234',
  to_numbers: ['09123456789', '09198765432'],
  message: 'پیام گروهی',
  is_flash: false
)

puts "شناسه ارسال: #{result.batch_sms_id}"
puts "وضعیت: #{result.result_description}"

result = client.send_sms_like_to_like(
  from_number: '10001234',
  to_numbers: ['09123456789', '09198765432'],
  messages: ['سلام علی جان', 'سلام رضا جان']
)

puts "SmsId: #{result.sms_id}"

result = client.send_voice_otp(
  from_number: '10001234',
  to_number: '09123456789',
  otp: '12345'
)

puts "شناسه ارسال: #{result.batch_sms_id}"
puts "وضعیت: #{result.result_description}"

delivery = client.get_batch_delivery(
  batch_sms_id: 123456,
  page_index: 1,
  page_size: 100
)

if delivery.success?
  delivery.delivery_hash.each do |number, status|
    puts "#{number}: #{NiazpardazSms::Models::SmsDeliveryStatus.description(status)}"
  end
end

delivery = client.get_delivery_like_to_like(sms_id: 789)

if delivery.success?
  delivery.numbers.each_with_index do |number, i|
    puts "#{number}: #{delivery.delivery_status[i]}"
  end
end

credit = client.get_credit

if credit.success?
  puts "اعتبار: #{credit.credit}"
end

senders = client.get_sender_numbers

senders.senders.each do |sender|
  puts sender
end

inbox_count = client.get_inbox_count(is_read: false)
puts "تعداد: #{inbox_count.inbox_count}"

messages = client.get_messages(
  message_type: 1,
  from_numbers: '10001234',
  page_index: 1,
  page_size: 50
)

if messages.success?
  messages.messages.each do |message|
    puts "متن پیامک: #{message.content}"
  end
end

messages = client.get_messages_by_date_range(
  message_type: 1,
  from_numbers: '10001234',
  from_date: Time.now - 86400, # دیروز
  to_date: Time.now
)

if messages.success?
  messages.messages.each do |message|
    puts "متن پیامک: #{message.content}"
  end
end

result = client.number_is_in_telecom_blacklist(number: '09123456789')
puts "در لیست سیاه: #{result.blacklisted?}"

blacklist = client.extract_telecom_blacklist_numbers(
  numbers: ['09123456789', '09198765432', '09351234567']
)

if blacklist.success?
  blacklist.blacklist_numbers.each do |number|
    puts number
  end
end

check = client.check_sms_content(message: 'متن پیامک تست')
puts "متن معتبر است: #{check.valid?}"

begin
  result = client.send_sms(
    from_number: '10001234',
    to_number: '09123456789',
    message: 'تست'
  )
  
  unless result.success?
    puts "خطا: #{result.result_description}"
  end
rescue NiazpardazSms::Errors::ValidationError => e
  puts "خطای اعتبارسنجی: #{e.message}"
rescue NiazpardazSms::Errors::ApiError => e
  puts "خطای API: #{e.message}"
  puts "کد خطا: #{e.error_code}"
  puts "وضعیت HTTP: #{e.http_status}"
rescue NiazpardazSms::Errors::NetworkError => e
  puts "خطای شبکه: #{e.message}"
end

require 'faraday'

connection = Faraday.new do |faraday|
  faraday.request :json
  faraday.response :json
  faraday.adapter :net_http
  faraday.options.timeout = 60
  faraday.options.open_timeout = 10
end

client = NiazpardazSms::Client.new('YOUR_API_KEY', connection: connection)

client = NiazpardazSms::Client.new('YOUR_API_KEY', timeout: 60)

client = NiazpardazSms::Client.new(
  'YOUR_API_KEY',
  base_url: 'https://custom-url.example.com/api'
)

class SendSmsJob
  include Sidekiq::Job

  def perform(to_number, message)
    client = NiazpardazSms.client
    result = client.send_sms(
      from_number: ENV['SMS_FROM_NUMBER'],
      to_number: to_number,
      message: message
    )
    
    unless result.success?
      raise "SMS failed: #{result.result_description}"
    end
  end
end

# استفاده
SendSmsJob.perform_async('09123456789', 'سلام!')

class SendSmsJob < ApplicationJob
  queue_as :default

  def perform(to_number, message)
    client = NiazpardazSms.client
    result = client.send_sms(
      from_number: ENV['SMS_FROM_NUMBER'],
      to_number: to_number,
      message: message
    )
    
    unless result.success?
      raise "SMS failed: #{result.result_description}"
    end
  end
end

# استفاده
SendSmsJob.perform_later('09123456789', 'سلام!')