Dev DOC - SMSMobileAPI

SMS Belgeleri

SMSmobileAPI Geliştirici Belgeleri

SMSmobileAPI olarak API'mizi mümkün olduğunca her türlü mimari veya platformla uyumlu hale getirmeye çalışıyoruz.
Whether you’re using REST, SOAP, cURL, or various programming languages like Python, JavaScript, PHP, and more, our API is designed to integrate seamlessly into your projects.

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

.

API REST

cURL

Composer

JavaScript

piton

Düğüm.js

Yakut

WSDL

SMS gönder

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

Bitiş noktası:

ELDE ETMEK POSTALAMAK https://api.smsmobileapi.com/sendsms/

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.

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)

Bitiş noktası:

ELDE ETMEK POSTALAMAK https://api.smsmobileapi.com/resend/

Parametre:

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

Örnek:


        https://api.smsmobileapi.com/resend/?apikey=API_ANAHTARINIZ&guid=MESAJIN_GUID'İNİ ALIN

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.

Bitiş noktası:

ELDE ETMEK https://api.smsmobileapi.com/log/sent/sms/

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.

Örnek:


        https://api.smsmobileapi.com/log/sent/sms?apikey=API_ANAHTARINIZI ALIN

SMS Alındı

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

Bitiş noktası:

ELDE ETMEK https://api.smsmobileapi.com/getsms/

Parametre:

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

Örnek:


        https://api.smsmobileapi.com/getsms/?apikey=API_ANAHTARINIZI ALIN

SMS'i sil

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

Bitiş noktası:

ELDE ETMEK https://api.smsmobileapi.com/deletesms/

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.

Örnek:


        https://api.smsmobileapi.com/deletesms/?apikey=API_ANAHTARINIZI ALIN

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 Received

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.

Kimlik doğrulama

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. 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. 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.

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:

🔗 SMS Mobile API PHP SDK on GitHub : https://github.com/SmsMobileApi/smsmobileapi-php/tree/main

GitHub'da şunları bulacaksınız:
✔️ Full installation guide
✔️ Example usage
✔️ API reference and best practices

Need help? Feel free to open an issue on GitHub! 🎯

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.

WhatsApp mesajlarını yalnızca API'miz aracılığıyla gönderebilirsiniz. Daha fazla bilgi edinmek 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 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

SMS Belgeleri

SMS gönder

Gönderilmemiş SMS'i yeniden gönder

LOG SMS Gönderildi

SMS alın

SMS'i sil

SMS Alındı - Webhook

Kimlik doğrulama

SMS gönder

Bitiş noktası:

Parametreler:

Örnek:

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

Bitiş noktası:

Parametre:

Örnek:

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

Bitiş noktası:

Parametre:

Örnek:

SMS Alındı

Bitiş noktası:

Parametre:

Örnek:

SMS'i sil

Bitiş noktası:

Parametre:

Örnek:

Webhook – SMS Received

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

Webhook Yükü

Yük Alanları:

Örnek Webhook Uç Noktası

Webhook'u test etme

Sorun giderme

Kimlik doğrulama

1. API Anahtar Kimlik Doğrulaması

2. OAuth2 Kimlik Doğrulaması

Erişim Belirteci Elde Etme

Erişim Belirtecini Kullanma:

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

SMS gönder

WSDL URL

Parametreler:

Örnek

SMS ve WhatsApp gönder

Temel cURL Komutu

PHP'de cURL Örneği

SMS ve WhatsApp gönder

`requests` Kütüphanesini Kullanma

`http.client` Kütüphanesini Kullanma

SMS Mobil API - PHP SDK (Composer)

SMS ve WhatsApp gönder

`fetch` API'sini kullanma

`XMLHttpRequest` Kullanımı

SMS ve WhatsApp gönder

`axios` Kütüphanesini Kullanma

SMS ve WhatsApp gönder

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

Geliştiriciler İçin SSS

API Anahtarı Nasıl Oluşturulur?

API Anahtarımı Her Zaman Nereden Bulabilirim?

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

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