Dev DOC - SMSMobileAPI

SMSmobileAPI Geliştirici Belgeleri WhatsApp mesajlarını yalnızca API'miz aracılığıyla gönderebilirsiniz. Daha fazla bilgi edinmek için buraya tıklayın.

SMSmobileAPI olarak API'mizi mümkün olduğunca her türlü mimari veya platformla uyumlu hale getirmeye çalışıyoruz.
REST, SOAP, cURL veya Python, JavaScript, PHP gibi çeşitli programlama dillerini kullanıyor olun, API'miz projelerinize sorunsuz bir şekilde entegre olacak şekilde tasarlanmıştır.

E-ticaret çözümleri ve yazılımları için hazır eklentilerimiz de mevcuttur. Bunları keşfetmek için buraya tıklayın.

Herhangi bir sorunuz, öneriniz varsa veya yardıma ihtiyacınız varsa ekibimiz size yardımcı olmak için burada.
Bize ulaşmaktan çekinmeyin api@smsmobileapi.com

.

API REST

cURL

Composer

JavaScript

piton

Düğüm.js

Yakut

WSDL

SMS ve WhatsApp API'si gönder

Bu uç nokta cep telefonunuzdan SMS göndermenize olanak tanır.

ELDE ETMEK POSTALAMAK https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&recipients=PHONE_NUMBER&message=MESSAGE_TO_SEND

Parametreler:

- apikey: Benzersiz API anahtarınız.

- recipients: Alıcının telefon numarası.

- message: Gönderilecek mesaj (Mesaj uzunluğu 160 karakterle sınırlı değildir; daha uzun mesajlar gönderebilirsiniz)

- sendwa: 1 = Mesajın WhatsApp üzerinden gönderilmesi gerekmektedir.

- sendsms: 1 = Mesaj geleneksel bir SMS yoluyla gönderilmelidir. (Eğer sms gönder boş: varsayılan olarak gönderilir, SMS'i engellemek için 0 olarak ayarlanır)

- schedule_timestamp = SMS'in gönderileceği zamanı temsil eder - **UNIX zaman damgası (GMT 0)** olmalıdır

Örnek:


        https://api.smsmobileapi.com/sendsms?apikey=API_ANAHTARINIZ&recipients=+1234567890&message=HelloWorld adresini edinin

Not : Operatörünüzden kaynaklanan bir iletim hatası olması durumunda, varsayılan bir fonksiyon aynı SMS'i belirli bir süre içerisinde en fazla 3 kez göndermeyi dener.

SMSMobile API iki kimlik doğrulama yöntemini destekler: basit bir API Anahtarı veya istemci kimliği ve istemci sırrı içeren OAuth2 protokolü kullanılarak.

1. SMS Göndermek İçin API Anahtar Kimlik Doğrulaması

Bu yöntem, bir GET veya POST isteğinde parametre olarak dahil edilebilecek bir API Anahtarı gerektirir. API isteklerinizi doğrulamanın basit bir yoludur.

2. SMS Göndermek İçin OAuth2 Kimlik Doğrulaması

OAuth2 daha güvenli ve ölçeklenebilir bir kimlik doğrulama yöntemi sağlar.
Daha sonra API isteklerinize dahil edilmesi gereken bir erişim belirteci elde etmek için bir istemci kimliği ve istemci sırrı kullanmanız gerekecektir. Yetkilendirme Başlık.

client_id ve client_secret bilgilerine, uygulamayı yükleyip mobil cihazınızda bir hesap oluşturduktan sonra erişebileceğiniz kontrol panelinizden ulaşabilirsiniz.
Mobil uygulamayı hemen indirin veya gösterge panelinize erişin.

Erişim Belirteci Elde Etme

Erişim belirteci almak için istemci kimliğiniz ve istemci sırrınızla belirteç uç noktasına bir POST isteği gönderin.


curl -X POST https://api.smsmobileapi.com/oauth2/token \

-H "Content-Type: application/x-www-form-urlencoded" \

-d "grant_type=client_credentials" \

-d "client_id=1ab0ex4b4c1ef2c800690d" \

-d "client_secret=3ed108a93d0414074b94364290b6a7348475e93a0567005"

Erişim Belirtecini Kullanma:

Erişim belirtecini aldıktan sonra bunu şuraya ekleyin: Yetkilendirme API isteklerinizin başlığı:


curl -X POST https://api.smsmobileapi.com/sendsms \

-H "Yetkilendirme: Taşıyıcı abc123xyz456" \

-H "İçerik Türü: application/x-www-form-urlencoded" \

-d "alıcılar=+1234567890" \

-d "mesaj=Merhaba"

Hangi Yöntemi Kullanmalısınız?

- Kullanmak API Anahtar Kimlik Doğrulaması hızlı ve kolay entegrasyonlar için.

- Kullanmak OAuth2 Kimlik Doğrulaması Entegrasyonlarınızda gelişmiş güvenlik ve ölçeklenebilirlik için.

Daha detaylı bilgi için lütfen tam dokümanlara bakınız.

Gönderilmemiş bir SMS'i yeniden gönder

Bu API uç noktası, gönderilmemiş bir SMS'i yeniden göndermek için kullanılır (yalnızca mesajda bir hata durumu varsa)

ELDE ETMEK POSTALAMAK https://api.smsmobileapi.com/resend/?apikey=YOUR_API_KEY

Parametre:

- guid: (gerekli) Tekrar gönderilecek mesajın GUID'si.

API'den gönderilen SMS'lerin günlüğü

Bu API uç noktası, API aracılığıyla gönderilen SMS mesajlarının günlüğünü almak için kullanılır.

ELDE ETMEK https://api.smsmobileapi.com/log/sent/sms?apikey=YOUR_API_KEY

Parametre:

- apikey: (gerekli) API anahtarınız.

- guid_message: Sıralama ve filtreleme için kullanılan mesajın benzersiz tanımlayıcısına göre kısaltılır.

- before: Bu belirli zaman damgasından veya GUID'den önce gönderilen mesajları al.

- error_api: API isteği sırasında hatayla karşılaşan tüm SMS'leri listelemek için `1` (`&error_api=1`) girin.

- error_mobile: Mobil işlem sırasında hatayla karşılaşan tüm SMS'leri listelemek için `1` (`&error_mobile=1`) girin.

- keyword: Alıcının numarasına veya SMS içeriğine göre mesajları filtrelemek için bir anahtar sözcük.

Mobil API'de SMS alın

Bu API uç noktası akıllı telefona gelen SMS mesajlarını almak için kullanılır.

ELDE ETMEK https://api.smsmobileapi.com/getsms/?apikey=YOUR_API_KEY

Parametre:

- apikey: Sahip olduğunuz veya alacağınız API anahtarı.

SMS API'yi Sil

Bu API uç noktası, SMS Mobil API'nin sunucu günlüğünden SMS mesajlarını silmek için kullanılır

ELDE ETMEK https://api.smsmobileapi.com/deletesms/?apikey=YOUR_API_KEY

Parametre:

- apikey: Sahip olduğunuz API anahtarı.

- guid_message: Silinecek mesajın benzersiz kimliği.

- date_start: Tek başına kullanıldığında belirtilen güne ait tüm mesajları siler.

- date_start and date_end: Belirli bir süre içerisinde mesajları silmek için birleştirilmiştir.

Not: Silinen SMS'ler yalnızca mobil uygulama hesabınızın günlüklerinde saklananlardır. Mobil cihazınızdaki SMS'ler silinmeyecektir, çünkü bunlara erişimimiz yoktur.

.

Webhook – SMS Alındı

Bu webhook sistemi, bir SMS alındığında yapılandırılmış URL'ye bir POST isteği gönderir. Sistem, SMS ayrıntılarını belirtilen webhook URL'sine ileterek gerçek zamanlı güncellemeleri garanti eder.

Pano'da Webhook Nasıl Yapılandırılır

Panoda webhook URL'nizi ayarlamak için şu adımları izleyin:

Hesabınıza giriş yapın SMS Mobil API Panosu.
Şuraya gidin: Webhook Ayarları bölüm.
Webhook URL'nizi girin (örneğin, https://example.com/webhook-endpoint
Üzerine tıklayın Webhook'u kaydet düğme.
Kaydedildikten sonra sistem yapılandırılmış URL'ye SMS ayrıntılarını göndermeye başlayacaktır.

Webhook Yükü

Bir SMS alındığında sistem webhook URL'nize aşağıdaki JSON verisini gönderir:

{

    "tarih": "2025-01-20",

    "saat": "10:15:00",

    "zaman_alındı": "2025-01-20 10:14:50",

    "mesaj": "Merhaba, bu bir testtir.",

    "numara": "+123456789",

    "guid": "abcde12345"

}

Yük Alanları:

tarih: SMS'in eklendiği tarih (YYYY-AA-GG).
saat: SMS'in eklendiği saat (SS:dd:ss).
alınan_zaman: SMS'in alındığı saat.
mesaj: SMS'in içeriği.
sayı: Gönderenin telefon numarası.
kılavuz: SMS'in benzersiz tanımlayıcısı.

Örnek Webhook Uç Noktası

Sunucunuz gelen POST isteklerini işlemeye hazır olmalıdır. Aşağıda webhook yükünü işlemek için bir PHP betiği örneği verilmiştir:

<?php

// Gelen yükü oku

$payload = file_get_contents('php://input');

$data = json_decode($yük, doğru);




// SMS verilerini işle

eğer ($veri) {

    // Örnek: SMS verilerini bir dosyaya kaydedin

    file_put_contents('sms_log.txt', print_r($data, true), FILE_APPEND);




    // HTTP 200 durumuyla yanıtla

    http_yanıt_kodu(200);

    echo "Webhook başarıyla alındı.";

} başka {

    // Kötü isteklere HTTP 400 durumuyla yanıt ver

    http_yanıt_kodu(400);


    echo "Geçersiz yük.";

}

?>

Webhook'u test etme

Webhook yapılandırmanızı test etmek için şu araçları kullanın:

Bu araçlar sistem tarafından gönderilen yükü incelemenize ve webhook kurulumunuzdaki sorunları gidermenize olanak tanır.

Sorun giderme

Webhook URL'sinin doğru ve herkes tarafından erişilebilir olduğundan emin olun.
Sunucunuzun başarılı istekler için HTTP 200 durum kodu döndürdüğünü doğrulayın.
Yükün işlenmesinde herhangi bir hata olup olmadığını görmek için sunucu kayıtlarınızı kontrol edin.

SMS gönder

WSDL URL

https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl

Parametreler:

- recipients: Alıcının cep telefonu numarası.

- message: Gönderilecek mesaj. (Mesaj uzunluğu 160 karakterle sınırlı değildir; daha uzun mesajlar gönderebilirsiniz)

- apikey: Sahip olduğunuz veya alacağınız API anahtarı.

Örnek


                require_once "lib/nusoap.php";

                

                $client = new nusoap_client("https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl", true);

                $error  = $client->getError();

                

                $result = $client->call("sendSms", array("recipients" =>$_GET['recipients'],"message" =>$_GET['message'],"apikey" =>$_GET['apikey']));

                

                print_r($result);

SMS ve WhatsApp gönder

Temel cURL Komutu

SMSmobileAPI üzerinden SMS göndermek için aşağıdaki cURL komutunu kullanabilirsiniz:


        curl -X POST https://api.smsmobileapi.com/sendsms/ \

        -d "recipients=PHONE_NUMBER" \

        -d "message=YOUR_MESSAGE" \

        -d "apikey=YOUR_API_KEY" 

		
		 -d "sendwa=1"

		 -d "sendsms=1"

PHP'de cURL Örneği

Eğer PHP kullanıyorsanız, cURL kullanarak SMS göndermenin yolu şöyledir:


        <?php

        

        $url = 'https://api.smsmobileapi.com/sendsms/';

        $data = array(

            'recipients' => 'PHONE_NUMBER',

            'message' => 'YOUR_MESSAGE',

            'apikey' => 'YOUR_API_KEY'

		    'sendwa' => '1'

		    'sendsms' => '1'

        );

        

        $options = array(

            CURLOPT_URL => $url,

            CURLOPT_POST => true,

            CURLOPT_POSTFIELDS => http_build_query($data),

            CURLOPT_RETURNTRANSFER => true,

        );

        

        $ch = curl_init();

        curl_setopt_array($ch, $options);

        $response = curl_exec($ch);

        curl_close($ch);

        

        echo $response;

        

        ?>

Bu PHP örneği, gerekli parametreleri ilişkisel bir dizi olarak geçirerek cURL kullanarak SMSmobileAPI'ye bir POST isteğinin nasıl gönderileceğini göstermektedir.

SMS ve WhatsApp gönder

Resmi Python Modülümüzü kullanın: https://smsmobileapi.com/python/
veya manuel yolu kullanın ...

`requests` Kütüphanesini Kullanma

`requests` kütüphanesi Python için popüler ve basit bir HTTP kütüphanesidir. SMSmobileAPI üzerinden SMS göndermek için bunu nasıl kullanabileceğiniz aşağıda açıklanmıştır:


        import requests



        url = "https://api.smsmobileapi.com/sendsms/"



        payload = {

            "recipients": "PHONE_NUMBER",

            "message": "YOUR_MESSAGE",

            "apikey": "YOUR_API_KEY"

        }



        response = requests.post(url, data=payload)



        print(response.text)

Bu örnek, SMSmobileAPI'ye yapılan basit bir POST isteğini, belirli bir telefon numarasına mesaj göndermeyi göstermektedir.

`http.client` Kütüphanesini Kullanma

`http.client` kütüphanesi Python'un standart kütüphanesinde yer alır ve API'nizle etkileşim kurmak için de kullanılabilir:


        import http.client

        import urllib.parse



        conn = http.client.HTTPSConnection("api.smsmobileapi.com")



        params = urllib.parse.urlencode({

            "recipients": "PHONE_NUMBER",

            "message": "YOUR_MESSAGE",

            "apikey": "YOUR_API_KEY"

        })



        headers = { "Content-type": "application/x-www-form-urlencoded" }



        conn.request("POST", "/sendsms/", params, headers)

        response = conn.getresponse()

        data = response.read()



        print(data.decode("utf-8"))

        conn.close()

Bu örnek, API'ye bir POST isteği göndermek için `http.client` kütüphanesinin nasıl kullanılacağını gösterir. Parametreler URL kodludur ve uygun başlıklarla gönderilir.

SMS Mobil API - PHP SDK (Composer)

SMS Mobile API PHP SDK'sı Composer üzerinden edinilebilir ve bu sayede SMS gönderimini PHP uygulamalarınıza entegre etmek kolaylaşır.


		besteci smsmobileapi/sdk gerektirir

Ayrıntılı dokümantasyon, kurulum talimatları ve kullanım örnekleri için GitHub depolarımızı ziyaret edin:

🔗 GitHub'da SMS Mobil API PHP SDK'sı: https://github.com/SmsMobileApi/smsmobileapi-php/tree/main

GitHub'da şunları bulacaksınız:
✔️ Tam kurulum kılavuzu
✔️ Örnek kullanım
✔️ API referansı ve en iyi uygulamalar

Yardıma mı ihtiyacınız var? GitHub'da bir sorun açmaktan çekinmeyin! 🎯

SMS ve WhatsApp gönder

`fetch` API'sini kullanma

`fetch` API, JavaScript'te HTTP istekleri yapmak için modern ve çok yönlü bir yoldur. SMSmobileAPI aracılığıyla bir SMS göndermek için bunu nasıl kullanabileceğiniz aşağıda açıklanmıştır:


        const url = "https://api.smsmobileapi.com/sendsms/";



        const data = {

            recipients: "PHONE_NUMBER",

            message: "YOUR_MESSAGE",

            apikey: "YOUR_API_KEY"

        };



        fetch(url, {

            method: "POST",

            headers: {

                "Content-Type": "application/x-www-form-urlencoded"

            },

            body: new URLSearchParams(data)

        })

        .then(response => response.text())

        .then(result => console.log(result))

        .catch(error => console.error("Error:", error));

Bu örnek, çoğu modern tarayıcıda desteklenen `fetch` API'sini kullanarak bir POST isteğinin nasıl gönderileceğini göstermektedir.

`XMLHttpRequest` Kullanımı

Daha eski tarayıcıları desteklemeniz gerekiyorsa `XMLHttpRequest` nesnesini kullanabilirsiniz:


        const xhr = new XMLHttpRequest();

        const url = "https://api.smsmobileapi.com/sendsms/";



        const data = "recipients=PHONE_NUMBER&message=YOUR_MESSAGE&apikey=YOUR_API_KEY";



        xhr.open("POST", url, true);

        xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");



        xhr.onreadystatechange = function() {

            if (xhr.readyState === 4 && xhr.status === 200) {

                console.log(xhr.responseText);

            }

        };



        xhr.send(data);

Bu örnek, `fetch` komutunu desteklemeyen eski tarayıcılarla uyumluluk sağlayarak, bir POST isteği göndermek için `XMLHttpRequest` komutunun nasıl kullanılacağını göstermektedir.

SMS ve WhatsApp gönder

`axios` Kütüphanesini Kullanma

`axios` kütüphanesi Node.js için popüler bir HTTP istemcisidir. SMSmobileAPI üzerinden SMS göndermek için bunu nasıl kullanabileceğiniz aşağıda açıklanmıştır:


        const axios = require('axios');



        const url = 'https://api.smsmobileapi.com/sendsms/';

        const data = {

            recipients: 'PHONE_NUMBER',

            message: 'YOUR_MESSAGE',

            apikey: 'YOUR_API_KEY'

        };



        axios.post(url, data)

        .then(response => {

            console.log(response.data);

        })

        .catch(error => {

            console.error('Error:', error);

        });

Bu örnek, Node.js'de `axios` kullanılarak SMSmobileAPI ile etkileşime geçmek için bir POST isteğinin nasıl gönderileceğini göstermektedir.

SMS ve WhatsApp gönder

`Net::HTTP` Kütüphanesini Kullanma

SMSmobileAPI üzerinden SMS göndermek için Ruby'deki `Net::HTTP` kütüphanesini kullanabilirsiniz:


        require 'net/http'

        require 'uri'



        uri = URI.parse("https://api.smsmobileapi.com/sendsms/")

        request = Net::HTTP::Post.new(uri)

        request.set_form_data(

            "recipients" => "PHONE_NUMBER",

            "message" => "YOUR_MESSAGE",

            "apikey" => "YOUR_API_KEY"

        )



        req_options = {

            use_ssl: uri.scheme == "https",

        }



        response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|

            http.request(request)

        end



        puts response.body

Bu örnek, Ruby'de `Net::HTTP` kullanılarak SMSmobileAPI'ye bir POST isteğinin nasıl gönderileceğini göstermektedir.

API anahtarını ve hizmetini basit formla test etmek için buraya tıklayın

Mobil telefona yüklenen Android sürümüne bağlı olarak, SmsMobileApi uygulaması ön planda olmadığında işletim sistemi otomatik SMS gönderme ve alma özelliğinin düzgün çalışmasını engelleyebilir.
Bu sorun, uygulama etkin bir şekilde başlatılmadığında arka planda çalışmaya çalışan bir işlemden kaynaklanır. Ancak, farklı sürümlerde farklılık gösteren Android'in pil optimizasyonu önlemleri nedeniyle, bu arka plan işlemi doğru şekilde başlatılamayabilir. Android'in pil optimizasyonu, pil ömrünü korumak için uygulamaların arka plan etkinliğini sınırlamak üzere tasarlanmıştır; bu, düzgün çalışması için arka plan işlemleri gerektiren uygulamaları istemeden etkileyebilir.

Bu sorunu gidermek için kullanıcılar, SmsMobileApi'nin kaynakları kısıtlama olmaksızın kullanmasına izin vermek için Android ayarlarını manuel olarak yapılandırabilirler.
Bu, belirli uygulama için pil optimizasyon ayarlarını ayarlamayı içerir ve esasen Android'e SmsMobileApi'nin arka planda çalışmasına ve gerektiğinde kaynakları kullanmasına izin verildiğini bildirir. Bunu yaparak, uygulama ön planda etkin uygulama olmasa bile otomatik olarak SMS mesajları gönderip alabilmelidir. Bu ayarlama, gerekli arka plan işleminin kesintisiz çalışmasını sağlayarak, aksi takdirde düzgün çalışmasını engelleyebilecek pil optimizasyon özelliklerinin önüne geçer.

Geliştiriciler İçin SSS

API Anahtarı Nasıl Oluşturulur?

Akordeon Örnek AçıklamasıBir API anahtarı oluşturmak için, uygulamamızı cep telefonunuza indirin ve ücretsiz bir hesap oluşturun. Bir API anahtarı otomatik olarak oluşturulacak ve cep telefonunuza bağlanacaktır. Ayrıca tüm gerekli bilgileri içeren bir e-posta alacaksınız. Bu süreç, minimum kurulumla hizmetlerimizi hızlı ve kolay bir şekilde kullanmaya başlayabilmenizi sağlar.

API Anahtarımı Her Zaman Nereden Bulabilirim?

Mobil uygulamanızda, API anahtarınızın her zaman görünür olduğu AYARLAR veya YARDIM menüsüne gidin. Bu, hizmetlerimizi entegre etmek veya kullanmak için ihtiyaç duyduğunuzda API anahtarınıza kolayca erişebilmenizi sağlar.

API Anahtarının Oluşturulması Anonim Olabilir mi?

Evet, bir API anahtarı oluşturmak için herhangi bir kimlik kanıtına ihtiyacımız yok. API'miz ile cep telefonunuz arasındaki iletişim bu nedenle 100% anonimdir. Bu yaklaşım, kullanıcıların hizmetlerimizi kullanırken gizliliklerini korumalarına olanak tanır.

Bugün SMSmobileAPI'yi kullanmaya başlayın!

SMS hizmetlerinizi hareket halindeyken yönetmenin özgürlüğünü ve esnekliğini deneyimleyin. Mobil uygulamamızı hemen indirin ve kusursuz SMS entegrasyonuna doğru ilk adımı atın.

Uygulamayı İndirin