README.md in globalsms-1.0.4 vs README.md in globalsms-1.0.5
- old
+ new
@@ -140,10 +140,25 @@
# "result" => true, "message_id" => "239931", "numbers" => ["5493666157"], "total_numbers_count" => 1, "turkcell_numbers_count" => 0, "vodafone_numbers_count" => 1, "avea_numbers_count" => 0, "total_credit" => 1, "0" => ""
# }]
# }
```
+#### İleri tarihli mesajın gönderimini iptal etme
+
+İleri tarihli(gelecekte) gönderilmesi planlanmış bir SMS-in gönderimini iptal etmek için kullanılır. Argüman olarak tek
+bir veya birden fazla `message_id` alabilir.
+
+```ruby
+require 'globalsms'
+
+sms = GlobalSMS::SMS.new(init_args)
+
+sms.cancel(3614893)
+
+# {"result":true,"message_id":"3614893","credit_change":"1"}
+```
+
### Rapor Alma
Gönderilmiş mesajlara ait raporları almak için fonksiyonlara argüman olarak tek bir çağrı için `message_id`, birden fazla çağrı için `message_id` leri içeren bir array verilir. Fonksiyon geriye **hash** döndürür.
@@ -155,21 +170,21 @@
init_args = {
api_key: "api-key",
api_secret: "api-secret"
}
-sms = GlobalSMS::REPORT.new(init_args)
+report = GlobalSMS::REPORT.new(init_args)
```
#### Bir mesaja ait raporları görüntüleme
```ruby
require 'globalsms'
-sms = GlobalSMS::REPORT.new(init_args)
+report = GlobalSMS::REPORT.new(init_args)
-sms.message(239916, limit=250)
+report.message(239916, limit=250)
# {
# "result" => true, "data" => [{
# "id" => "34163245", "created_datetime" => "2015-05-05 14:54:32", "gsm_no" => "5493666154", "gsm_operator" => "2", "sent_status" => "2", "sent_datetime" => "2015-05-05 14:54:37", "out_status" => "255", "out_datetime" => "2015-05-05 14:54:37", "report_message" => "COMMAND_ERROR", "name" => nil
# }], "totals" => {
@@ -185,13 +200,13 @@
Argüman verilmezse, ön tanımlı olarak en son yollanan (1) mesaja ait raporu döndürür.
```ruby
require 'globalsms'
-sms = GlobalSMS::REPORT.new(init_args)
+report = GlobalSMS::REPORT.new(init_args)
-sms.last_n(10)
+report.last_n(10)
# {
# "result" => true, "data" => [{
# "id" => "239931", "created_datetime" => "2015-05-05 15:00:52", "originator" => "DENEME", "originator_id" => "1616", "total_num" => "1", "pieces" => "1", "total_sent" => "1", "num_reached" => "0", "num_not_reached" => "0", "num_waiting_for_time" => "0", "text" => "Ve De Bir Başka Mesaj Metni", "time_to_send" => "2015-05-05 15:00:52"
# }, {
@@ -218,35 +233,39 @@
# }
```
#### Belirli tarihler arasında gönderilmiş mesajlara ait raporları görüntüleme
-Bu fonsiyon argüman olarak **hash** alır ve sonuç olarak **hash** döner.
+Bu fonsiyon argüman olarak **hash** alır ve sonuç olarak **hash** döner. 'limit' değeri sorgu cevabının boyutunu ayarlar. Azami değeri 200-dür. 200-den fazlası için cevap dönmez veya 20 adet döner. Bu sebeple 'start' değeri
+kullanılarak sayfalama yapılır. Örneğin 'limit' değeri 100 ve 'start' değeri 100 ise 2. sayfa(100 ve 200 arası
+değerler) döner. 'limit' ve 'start' değerleri girilmezse ilk 200 kayıt listelenir.
Ön tanımlı değerler:
start_time: "00:00:00"
end_time: "23:59:59"
+ limit: "200"
+ start: "0"
Kullanıcının gireceği değerler:
start_date: "2015-05-06"
end_date: "2015-05-06"
```ruby
require 'globalsms'
-sms = GlobalSMS::REPORT.new(init_args)
+report = GlobalSMS::REPORT.new(init_args)
args = {
start_date: "2015-05-06",
end_date: "2015-05-06",
start_time: "20:21:20",
end_time: "20:22:00"
}
-sms.between(args)
+report.between(args)
# {
# "result" => true, "data" => [{
# "id" => "243408", "created_datetime" => "2015-05-06 20:21:30", "originator" => "DENEME", "originator_id" => "1649", "total_num" => "2", "pieces" => "1", "total_sent" => "2", "num_reached" => "2", "num_not_reached" => "0", "num_waiting_for_time" => "0", "text" => "Mesaj Metni", "time_to_send" => "2015-05-06 20:21:30"
# }], "totals" => {
@@ -265,23 +284,23 @@
init_args = {
api_key: "api-key",
api_secret: "api-secret"
}
-sms = GlobalSMS::INFO.new(init_args)
+info = GlobalSMS::INFO.new(init_args)
```
#### Gönderici adlarını görüntüleme
Bu fonksiyon argüman almaz.
```ruby
require 'globalsms'
-sms = GlobalSMS::INFO.new(init_args)
+info = GlobalSMS::INFO.new(init_args)
-sms.originator_list
+info.originator_list
# {
# "result" => true, "data" => [{
# "originator_id" => "1616", "title" => "DENEME", "created_datetime" => "2015-04-27 20:25:39", "updated_datetime" => "2015-04-27 20:25:44", "approved_datetime" => "2015-04-27 20:25:44", "description" => "", "status" => "1"
# }]
@@ -291,12 +310,12 @@
#### Kullanıcı detaylarını ve kalan kredi bilgisini görüntüleme
```ruby
require 'globalsms'
-sms = GlobalSMS::INFO.new(init_args)
+info = GlobalSMS::INFO.new(init_args)
-sms.user_info
+info.user_info
# {
# "result" => true, "data" => {
# "firstname" => "Salih", "lastname" => "Özdemir", "username" => "salihozd", "email" => "me@salihozdemir.net", "image" => nil, "credit" => "8"
# }