Entwicklungsdokument – SMSMobileAPI

SMSmobileAPI Entwicklerdokumentation Sie können WhatsApp-Nachrichten nur über unsere API senden. Klicken Sie hier, um mehr zu erfahren.

Bei SMSmobileAPI sind wir bestrebt, unsere API so kompatibel wie möglich mit jeder Architektur oder Plattform zu machen.
Egal, ob Sie REST, SOAP, cURL oder verschiedene Programmiersprachen wie Python, JavaScript, PHP und mehr verwenden, unsere API ist für die nahtlose Integration in Ihre Projekte konzipiert.

Wir haben auch gebrauchsfertige Plugins für E-Commerce-Lösungen und -Software. Klicken Sie hier, um sie zu entdecken.

Wenn Sie Fragen oder Anregungen haben oder Hilfe benötigen, steht Ihnen unser Team gerne zur Verfügung.
Kontaktieren Sie uns gerne unter api@smsmobileapi.com

.

API REST

cURL

JavaScript

Python

Node.js

Rubin

WSDL

SMS senden & WhatsApp API

Die SMSMobile-API unterstützt zwei Authentifizierungsmethoden: die Verwendung eines einfachen API-Schlüssels oder des OAuth2-Protokolls mit einer Client-ID und einem Client-Geheimnis.

1. API-Schlüsselauthentifizierung zum Senden von SMS

Diese Methode erfordert einen API-Schlüssel, der als Parameter in einer GET- oder POST-Anfrage enthalten sein kann. Dies ist eine unkomplizierte Möglichkeit, Ihre API-Anfragen zu authentifizieren.

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

Parameter:

- apikey: Ihr eindeutiger API-Schlüssel.

- recipients: Die Telefonnummer des Empfängers.

- message: Die zu sendende Nachricht (Die Nachrichtenlänge ist nicht auf 160 Zeichen begrenzt; Sie können längere Nachrichten senden)

- sendwa: 1 = die Nachricht muss über WhatsApp versendet werden.

- sendsms: 1 = die Nachricht muss per herkömmlicher SMS versendet werden. (Wenn SMS senden ist leer: wird standardmäßig gesendet, auf 0 setzen um die SMS zu blockieren)

- schedule_timestamp = Stellt den Zeitpunkt dar, ab dem die SMS gesendet werden soll - Muss ein **UNIX-Zeitstempel (GMT 0)** sein

Beispiel:


        GET https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&recipients=+1234567890&message=Hello%20World

Hinweis: Im Falle eines von Ihrem Betreiber verursachten Zustellungsfehlers versucht eine Standardfunktion, dieselbe SMS innerhalb eines festgelegten Intervalls bis zu dreimal erneut zu versenden.

2. OAuth2-Authentifizierung zum Senden von SMS

OAuth2 bietet eine sicherere und skalierbarere Authentifizierungsmethode.
Sie müssen eine Client-ID und ein Client-Geheimnis verwenden, um ein Zugriffstoken zu erhalten, das dann in Ihre API-Anfragen aufgenommen werden sollte, indem Sie Genehmigung Kopfzeile.

Die Client-ID und das Client-Geheimnis sind in Ihrem Dashboard verfügbar und können nach der Installation der App und der Erstellung eines Kontos auf Ihrem Mobilgerät aufgerufen werden.
Laden Sie jetzt die mobile App herunter oder Greifen Sie auf Ihr Dashboard zu.

Abrufen eines Zugriffstokens

Um ein Zugriffstoken zu erhalten, senden Sie eine POST-Anfrage mit Ihrer Client-ID und Ihrem Client-Geheimnis an den Token-Endpunkt.


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"

Verwenden des Zugriffstokens:

Sobald Sie den Zugriffstoken haben, fügen Sie ihn in die Genehmigung Header Ihrer API-Anfragen:


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

-H "Autorisierung: Inhaber abc123xyz456" \

-H "Inhaltstyp: Anwendung/x-www-form-urlencoded" \

-d "Empfänger=+1234567890" \

-d "message=Hallo"

Welche Methode sollten Sie verwenden?

- Verwenden API-Schlüsselauthentifizierung für schnelle und unkomplizierte Integrationen.

- Verwenden OAuth2-Authentifizierung für verbesserte Sicherheit und Skalierbarkeit Ihrer Integrationen.

Weitere Einzelheiten finden Sie in der vollständigen Dokumentation.

Resend an unsent SMS

This API endpoint is used to resend an unsent SMS (only if the message has an error status)

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

Parameter:

- guid: (required) GUID of the message to be resent.

Protokoll der von der API gesendeten SMS

Dieser API-Endpunkt wird verwendet, um das Protokoll der über die API gesendeten SMS-Nachrichten abzurufen.

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

Parameter:

- apikey: (erforderlich) Ihr API-Schlüssel.

- guid_message: kurz gesagt durch die eindeutige Kennung für die Nachricht, die zum Sortieren und Filtern verwendet wird.

- before: Rufen Sie Nachrichten ab, die vor diesem bestimmten Zeitstempel oder dieser GUID gesendet wurden.

- error_api: Geben Sie „1“ („&error_api=1“) ein, um alle SMS aufzulisten, bei denen während der API-Anforderung ein Fehler aufgetreten ist.

- error_mobile: Geben Sie „1“ („&error_mobile=1“) ein, um alle SMS aufzulisten, bei deren mobiler Verarbeitung ein Fehler aufgetreten ist.

- keyword: Ein Schlüsselwort zum Filtern von Nachrichten basierend auf der Empfängernummer oder dem SMS-Inhalt.

Erhalten Sie SMS über die mobile API

Dieser API-Endpunkt dient zum Abrufen von auf dem Smartphone empfangenen SMS-Nachrichten.

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

Parameter:

- apikey: Der API-Schlüssel, den Sie haben oder erhalten werden.

.

Webhook – SMS empfangen

Dieses Webhook-System sendet bei jedem SMS-Empfang eine POST-Anfrage an die konfigurierte URL. Das System stellt Echtzeit-Updates sicher, indem es die SMS-Details an die angegebene Webhook-URL sendet.

So konfigurieren Sie den Webhook im Dashboard

Befolgen Sie diese Schritte, um Ihre Webhook-URL im Dashboard einzurichten:

Melden Sie sich bei Ihrem Konto an auf der Dashboard der SMS Mobile API.
Navigieren Sie zum Webhook-Einstellungen Abschnitt.
Geben Sie Ihre Webhook-URL ein (z. B. https://example.com/webhook-endpoint
Klicken Sie auf das Webhook speichern Taste.
Nach dem Speichern beginnt das System, SMS-Details an die konfigurierte URL zu senden.

Webhook-Nutzlast

Wenn eine SMS empfangen wird, sendet das System die folgende JSON-Nutzlast an Ihre Webhook-URL:

{

    "Datum": "20.01.2025",

    "Stunde": "10:15:00",

    "time_received": "20.01.2025 10:14:50",

    "message": "Hallo, dies ist ein Test.",

    "Nummer": "+123456789",

    "guid": "abcde12345"

}

Nutzlastfelder:

Datum: Datum, an dem die SMS hinzugefügt wurde (JJJJ-MM-TT).
Stunde: Stunde, wann die SMS hinzugefügt wurde (HH:mm:ss).
Empfangszeit: Uhrzeit des SMS-Empfangs.
Nachricht: Inhalt der SMS.
Nummer: Telefonnummer des Absenders.
Anleitung: Eindeutige Kennung der SMS.

Beispiel für einen Webhook-Endpunkt

Ihr Server sollte bereit sein, eingehende POST-Anfragen zu verarbeiten. Unten finden Sie ein Beispiel-PHP-Skript zur Verarbeitung der Webhook-Nutzlast:

<?php

// Lesen Sie die eingehende Nutzlast

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

$data = json_decode($payload, true);




// Verarbeiten der SMS-Daten

wenn ($data) {

    // Beispiel: SMS Daten in eine Datei protokollieren

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




    // Mit HTTP 200-Status antworten

    http_Antwortcode(200);

    echo "Webhook erfolgreich empfangen.";

} anders {

    // Bei ungültigen Anfragen mit HTTP-Status 400 antworten

    http_Antwortcode(400);


    echo "Ungültige Nutzlast.";

}

?>

Testen des Webhooks

Verwenden Sie zum Testen Ihrer Webhook-Konfiguration Tools wie:

Mit diesen Tools können Sie die vom System gesendete Nutzlast prüfen und etwaige Probleme mit Ihrem Webhook-Setup beheben.

Fehlerbehebung

Stellen Sie sicher, dass die Webhook-URL korrekt und öffentlich zugänglich ist.
Überprüfen Sie, ob Ihr Server bei erfolgreichen Anfragen den HTTP-Statuscode 200 zurückgibt.
Überprüfen Sie Ihre Serverprotokolle auf Fehler bei der Verarbeitung der Nutzlast.

SMS-API löschen

Dieser API-Endpunkt wird zum Löschen von SMS-Nachrichten aus dem Serverprotokoll der SMS Mobile API verwendet

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

Parameter:

- apikey: Der API-Schlüssel, den Sie haben.

- guid_message: Die eindeutige ID der zu löschenden Nachricht.

- date_start: Bei alleiniger Verwendung werden alle Nachrichten des angegebenen Tages gelöscht.

- date_start and date_end: Kombiniert, um Nachrichten innerhalb eines bestimmten Zeitraums zu löschen.

Hinweis: Gelöscht werden nur die SMS, die in den Protokollen Ihres Mobile-App-Kontos gespeichert sind. SMS auf dem Mobilgerät selbst werden nicht gelöscht, da wir darauf keinen Zugriff haben.

SMS senden

WSDL-URL
https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl

Parameter:

- recipients: Die Handynummer des Empfängers.

- message: Die zu sendende Nachricht. (Die Nachrichtenlänge ist nicht auf 160 Zeichen begrenzt; Sie können längere Nachrichten senden.)

- apikey: Der API-Schlüssel, den Sie haben oder erhalten werden.

Beispiel


                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);

Senden Sie SMS und WhatsApp

Grundlegender cURL-Befehl

Um eine SMS über die SMSmobileAPI zu versenden, können Sie folgenden cURL-Befehl verwenden:


        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"

cURL-Beispiel in PHP

Wenn Sie PHP verwenden, können Sie mit cURL wie folgt eine SMS senden:


        <?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;

        

        ?>

Dieses PHP-Beispiel zeigt, wie mit cURL eine POST-Anfrage an die SMSmobileAPI gesendet wird und dabei die erforderlichen Parameter als assoziatives Array übergeben werden.

Senden Sie SMS und WhatsApp

Nutzen Sie unser offizielles Python-Modul: https://smsmobileapi.com/python/
oder verwenden Sie die manuelle Methode ...

Verwenden der `requests`-Bibliothek

Die Bibliothek `requests` ist eine beliebte und einfache HTTP-Bibliothek für Python. So können Sie sie verwenden, um eine SMS über die SMSmobileAPI zu versenden:


        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)

Dieses Beispiel zeigt eine einfache POST-Anfrage an die SMSmobileAPI, die eine Nachricht an eine bestimmte Telefonnummer sendet.

Verwenden der `http.client`-Bibliothek

Die Bibliothek „http.client“ ist in der Standardbibliothek von Python enthalten und kann auch zur Interaktion mit Ihrer API verwendet werden:


        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()

Dieses Beispiel zeigt, wie man mit der Bibliothek `http.client` eine POST-Anfrage an die API sendet. Die Parameter werden URL-codiert und mit den entsprechenden Headern gesendet.

Senden Sie SMS und WhatsApp

Verwenden der „Fetch“-API

Die `fetch`-API ist eine moderne und vielseitige Möglichkeit, HTTP-Anfragen in JavaScript zu stellen. So können Sie damit eine SMS über die SMSmobileAPI versenden:


        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));

Dieses Beispiel zeigt, wie eine POST-Anfrage mit der „fetch“-API gesendet wird, die von den meisten modernen Browsern unterstützt wird.

Verwenden von „XMLHttpRequest“

Wenn Sie ältere Browser unterstützen müssen, können Sie das Objekt „XMLHttpRequest“ verwenden:


        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);

Dieses Beispiel zeigt, wie man „XMLHttpRequest“ zum Senden einer POST-Anfrage verwendet und so Kompatibilität mit älteren Browsern gewährleistet, die „fetch“ möglicherweise nicht unterstützen.

Senden Sie SMS und WhatsApp

Verwenden der `axios`-Bibliothek

Die `axios`-Bibliothek ist ein beliebter HTTP-Client für Node.js. So können Sie damit eine SMS über die SMSmobileAPI versenden:


        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);

        });

Dieses Beispiel zeigt, wie Sie mit „axios“ in Node.js eine POST-Anfrage senden, um mit der SMSmobileAPI zu interagieren.

Senden Sie SMS und WhatsApp

Verwenden der `Net::HTTP`-Bibliothek

Sie können die Bibliothek „Net::HTTP“ in Ruby verwenden, um eine SMS über die SMSmobileAPI zu senden:


        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

Dieses Beispiel zeigt, wie eine POST-Anfrage mit „Net::HTTP“ in Ruby an die SMSmobileAPI gesendet wird.

Klicken Sie hier, um den API-Schlüssel und den Dienst mit dem einfachen Formular zu testen

Abhängig von der auf einem Mobiltelefon installierten Android-Version kann das Betriebssystem das ordnungsgemäße Funktionieren des automatischen Sendens und Empfangens von SMS-Nachrichten behindern, wenn die Anwendung SmsMobileApi nicht im Vordergrund steht.
Dieses Problem entsteht durch einen Prozess, der versucht, im Hintergrund zu laufen, wenn die Anwendung nicht aktiv gestartet wird. Aufgrund der Akkuoptimierungsmaßnahmen von Android, die je nach Version unterschiedlich sind, wird dieser Hintergrundprozess jedoch möglicherweise nicht richtig gestartet. Die Akkuoptimierung von Android ist darauf ausgelegt, die Hintergrundaktivität von Apps zu begrenzen, um die Akkulaufzeit zu verlängern. Dies kann unbeabsichtigt Apps beeinträchtigen, die Hintergrundprozesse benötigen, um ordnungsgemäß zu funktionieren.

Um dieses Problem zu beheben, können Benutzer ihre Android-Einstellungen manuell konfigurieren, um der SmsMobileApi die uneingeschränkte Nutzung von Ressourcen zu ermöglichen.
Dabei werden die Einstellungen zur Akkuoptimierung für die jeweilige App angepasst. Android wird also angewiesen, dass die SmsMobileApi im Hintergrund ausgeführt werden darf und Ressourcen nach Bedarf nutzt. Auf diese Weise sollte die Anwendung automatisch SMS-Nachrichten senden und empfangen können, auch wenn sie nicht die aktive Anwendung im Vordergrund ist. Diese Anpassung stellt sicher, dass der erforderliche Hintergrundprozess ohne Unterbrechung ausgeführt werden kann und die Akkuoptimierungsfunktionen umgangen werden, die andernfalls seine ordnungsgemäße Ausführung verhindern könnten.

FAQ für Entwickler

Wie generiere ich einen API-Schlüssel?

Akkordeon-Beispielbeschreibung: Um einen API-Schlüssel zu generieren, laden Sie unsere Anwendung auf Ihr Mobiltelefon herunter und erstellen Sie kostenlos ein Konto. Ein API-Schlüssel wird automatisch generiert und mit Ihrem Mobiltelefon verknüpft. Sie erhalten außerdem eine E-Mail mit allen erforderlichen Informationen. Dieser Vorgang stellt sicher, dass Sie unsere Dienste schnell und einfach mit minimalem Einrichtungsaufwand nutzen können.

Wo finde ich immer meinen API-Schlüssel?

Navigieren Sie in Ihrer mobilen Anwendung zum Menü EINSTELLUNGEN oder HILFE, wo Ihr API-Schlüssel jederzeit sichtbar ist. So können Sie problemlos auf Ihren API-Schlüssel zugreifen, wenn Sie ihn für die Integration oder Nutzung unserer Dienste benötigen.

Kann die Erstellung eines API-Schlüssels anonym erfolgen?

Ja, wir verlangen keinen Identitätsnachweis für die Erstellung eines API-Schlüssels. Die Kommunikation zwischen unserer API und Ihrem Mobiltelefon ist daher 100% anonym. Dieser Ansatz ermöglicht es den Benutzern, ihre Privatsphäre bei der Nutzung unserer Dienste zu wahren.

Beginnen Sie noch heute mit SMSmobileAPI!

Erleben Sie die Freiheit und Flexibilität, Ihre SMS-Dienste auch unterwegs zu verwalten. Laden Sie jetzt unsere mobile App herunter und machen Sie den ersten Schritt zur nahtlosen SMS-Integration.

Laden Sie die App herunter

SMS senden & WhatsApp API

1. API-Schlüsselauthentifizierung zum Senden von SMS

Parameter:

Beispiel:

2. OAuth2-Authentifizierung zum Senden von SMS

Abrufen eines Zugriffstokens

Verwenden des Zugriffstokens:

Welche Methode sollten Sie verwenden?

Resend an unsent SMS

Parameter:

Protokoll der von der API gesendeten SMS

Parameter:

Erhalten Sie SMS über die mobile API

Parameter:

Webhook – SMS empfangen

So konfigurieren Sie den Webhook im Dashboard

Webhook-Nutzlast

Nutzlastfelder:

Beispiel für einen Webhook-Endpunkt

Testen des Webhooks

Fehlerbehebung

SMS-API löschen

Parameter:

SMS senden

WSDL-URL https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl

Parameter:

Beispiel

Senden Sie SMS und WhatsApp

Grundlegender cURL-Befehl

cURL-Beispiel in PHP

Senden Sie SMS und WhatsApp

Verwenden der `requests`-Bibliothek

Verwenden der `http.client`-Bibliothek

Senden Sie SMS und WhatsApp

Verwenden der „Fetch“-API

Verwenden von „XMLHttpRequest“

Senden Sie SMS und WhatsApp

Verwenden der `axios`-Bibliothek

Senden Sie SMS und WhatsApp

Verwenden der `Net::HTTP`-Bibliothek

FAQ für Entwickler

Wie generiere ich einen API-Schlüssel?

Wo finde ich immer meinen API-Schlüssel?

Kann die Erstellung eines API-Schlüssels anonym erfolgen?

Beginnen Sie noch heute mit SMSmobileAPI!

WSDL-URL
https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl