GET ile SMS Gönderme
/v2/api_key /smsviaget /request_response_type /?header =ID ya da Başlık Adı &gsms =GSM1, GSM2, GSM3,... &groupids =Grup ID'leri &timeout =Zaman Aşımı Değeri &message =Mesaj Metni (Base64) &deliverytime =Gönderilme Tarihi &gsm_isunique =Tekrarlanan numaralara gönderim &track_id =Gönderimin benzersiz izleme ID'si &report_url =Gönderim raporunun post edileceği adres &commercial =1 veya 0 &recipient_type =BIREYSEL veya TACIR
Örnek
https://organikapi.com/v2/ce136df4c9c92d1428e828aba07d3b05/smsviaget/?header =ORGANIKHBR &gsms =905001234567,905001234568,905001234569 &message =QnUgYmlyIGRlbmVtZSBtZXNhasSxZMSxcg==
Değişken | Gereklilik | Varsayılan Değer | Açıklama |
header |
Zorunlu | N/A | Gönderdiğiniz SMS'in kim tarafından atıldığı bilgisidir. Kayıtlı başlıklarınızdan birinin ID'si veya direkt adını alabilir. Başlık adı yazılırken kayıtlı başlık adıyla aynı şekilde ve büyük-küçük harf djuyarlılığıyla yazıldığından emin olunuz. Başlık adlarının tutmaması durumunda gönderiminiz gerçekleşmeyecektir. |
gsms |
Değişken | N/A | Mesajınızın atılacağı numaraları belirlediğiniz değişkendir. , ile ayırarak birden fazla numara yazabilirsiniz (Örn: 905301234567,901234566,901234555,...). Bu değişkende belirttiğiniz virgül ile ayrılmış numaraların sınırlaması yoktur, n tane olabilir. |
groupids |
Değişken | N/A | Kayıtlı gruplarınıza gönderim yapmak istiyorsanız, bir veya birden fazla grup ID değerini bu değişkene yazarak gönderim yapabilirsiniz (Örn: 1,2,3,4,...). Birden fazla grup ID'si yazdığınız durumlarda, ID değerlerinden geçersiz olanlar varsa gönderiminiz sadece geçerli ID'lere yapılır. |
timeout |
Opsiyonel | 48 | İlgili SMS operatöre iletildikten sonra mesajın operatörden alıcıya iletilmek için en fazla ne kadar süre ile bekletileceğini belirlediğiniz değişkendir. |
message |
Zorunlu | N/A | Gönderiminizin metnidir. |
deliverytime |
Opsiyonel | N/A | Gönderiminizin ileri bir tarihte yapılmasını istiyorsanız, istediğiniz tarihi bu parametreyle gönderebilirsiniz. Gönderdiğiniz tarih |
gsm_isunique |
Zorunlu | 1 | Gönderim yaptığınız numaraların içinde tekrarlanan numaralar varsa bu numaralara da gönderim yapılıp yapılmayacağını belirleyen parametredir. 1 - olduğunda tekrarlanan numaraların sadece 1 tanesine gönderim yapılır, 0 - olduğunda ise tekrarlanan numaraların tümüne gönderim yapılır. Alacağı değer |
track_id |
Opsiyonel | N/A | Gönderiminizi kendi sisteminizde takip edebilmek için üreteceğiniz benzersiz integer değerdir. |
report_url |
Opsiyonel | N/A | Gönderiminiz tamamlandıktan sonra gönderim raporunun |
commercial |
Opsiyonel | Kullanıcı, İYS Üyesi: 1 İYS Üyesi Değil: 0 |
Gönderim içeriğinizin ticari olup olmadığını belirtmek amaçlı kullanılır. 0 ve 1 değeri alabilir. |
recipient_type |
Opsiyonel | BIREYSEL | Alıcı tipini gösteren bilgidir. Değerler: |
Başarılı Yanıt:
-
Response Headers:
Reponse Body:Method: GET Status: 200 OKURL: /v2/ce136df4c9c92d1428e828aba07d3b05/smsviaget/json/ Host: organikapi.comContent-Type: application/json{ "response": { "result": true, "data": { "deliveries": [{ "track_id": "", "transaction_id": 16502030, "valid": [ { "request_gsm": 5444444444, "gsm": 905445359675, "gsm_track_id": "16502030-4730-63032793", "tl_amount": 0, "sms_count": 1, "credit_amount": 1 }, { "request_gsm": 5444444445, "gsm": 905445359675, "gsm_track_id": "16502030-4730-70484559", "tl_amount": 0, "sms_count": 1, "credit_amount": 1 } ], "invalid": [ { "request_gsm": 5444444446, "gsm": 905444444446, "error": { "number": 110, "message": "The number is incorrect." } } ] } ] } } }
-
Response Headers:
Reponse Body:Method: GET Status: 200 OKURL: /v2/ce136df4c9c92d1428e828aba07d3b05/smsviaget/xml/ Host: organikapi.comContent-Type: application/xml<?xml version="1.0" encoding="UTF-8"?> <response> <result>1</result> <data> <deliveries> <item> <track_id>2567</track_id> <transaction_id>16502030</transaction_id> <valid> <item> <request_gsm>5444444444</request_gsm> <gsm>905444444444</gsm> <gsm_track_id>16502030-4730-63032793</gsm_track_id> <tl_amount>0</tl_amount> <sms_count>1</sms_count> <credit_amount>1</credit_amount> </item> <item> <request_gsm>5444444445</request_gsm> <gsm>905444444445</gsm> <gsm_track_id>16587001-4730-70484559</gsm_track_id> <tl_amount>0</tl_amount> <sms_count>1</sms_count> <credit_amount>1</credit_amount> </item> </valid> <invalid> <item> <request_gsm>5444444446</request_gsm> <gsm>4444</gsm> <error> <number>110</number> <message>The number is incorrect.</message> </error> </item> </invalid> </item> </deliveries> </data> </response>
Node | Tip | Açıklama |
result |
Boolean / Int | Yanıt işleminin durumunu belirtir. |
data.deliveries |
Array | Gönderim görevinizdeki işlemlerin detayları burada gönderilir. |
data.deliveries.track_id |
String | Yapılan her gönderim işlemi için sizin tarafınızdan üretilen ID'dir. Bu veriyi raporlamalarınızda kullanabilirsiniz. |
data.deliveries.transaction_id |
Integer | Gönderim işleminin sistem tarafından otomatik oluşturulan benzersiz ID'sidir. Gönderim görevindeki her ileti ( |
data.valid |
Array | Gönderim görevinizdeki işleme alınan bütün GSM numaralarının detayları burada gönderilir. |
data.valid.request_gsm |
Integer | İşlem sırasında API'ye gönderdiğiniz GSM numarasıdır. |
data.valid.gsm |
Integer | |
data.valid.gsm_track_id |
String | Gönderim yapılan her numara için benzersiz olarak üretilen ID'dir. Bu veriyi raporlamalarınızda kullanabilirsiniz. |
data.valid.tl_amount |
Integer | Gönderilen SMS'in TL tutarı bilgisini verir. Yurtdışı numaralar TL bakiye ile gönderilir. TL tutarı raporlamalarda gönderilmez. |
data.valid.sms_count |
Integer | Gönderim metninizin kaç SMS uzunluğunda olduğu bilgisini verir. |
data.valid.credit_amount |
Integer | Gönderiminiz için hesaplanan toplam kredi miktarını verir. Bu miktar gönderiminiz için harcanan kredi miktarı değildir. Yurtdışı numaralar ve henüz başlamamışlar işlemler için değeri |
data.invalid |
Array | Gönderim görevinizdeki işleme alınamayan bütün GSM numaralarının detayları burada gönderilir. İçeriği |
data.invalid.request_gsm |
Integer | İşlem sırasında API'ye gönderdiğiniz GSM numarasıdır. |
data.invalid.gsm |
Integer | |
data.invalid.error.number |
Integer | İşlemin ürettiği hata kodudur. Anlamları için hata kodları sayfasına bakabilirsiniz. |
data.invalid.error.message |
Integer | İşlemin ürettiği hata mesajıdır. |
Organik API'yi kullanarak SMS gönderimi yapabilmeniz için aboneliğinizin olması gerekmektedir. Eğer aboneliğiniz yoksa buraya tıklayarak ücretsiz aboneliğinizi hızlı bir şekilde başlatabilirsiniz.