Dev DOC - SMSMobileAPI

SMSmobileAPI Developer Documentation

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

The SMSMobile API supports two authentication methods: using a simple API Key or the OAuth2 protocol with a client ID and client secret.

1. API Key Authentication for Send SMS

This method requires an API Key that can be included as a parameter in either a GET or POST request. It is a straightforward way to authenticate your API requests.

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

Parameter:

- apikey: Your unique API key.

- recipients: The recipient's phone number.

- message: The message to send.

Example:

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

2. OAuth2 Authentication for Send SMS

OAuth2 provides a more secure and scalable authentication method.
You will need to use a client ID and client secret to obtain an access token, which should then be included in your API requests using the Authorization header.

The client_id and client_secret are available in your dashboard, accessible after installing the app and creating an account on your mobile device.
Download the mobile app now oder access your dashboard.

Obtaining an Access Token

To get an access token, send a POST request to the token endpoint with your client ID and client secret.

 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"

Using the Access Token:

Once you have the access token, include it in the Authorization header of your API requests:

 curl -X POST https://api.smsmobileapi.com/sendsms \
 -H "Authorization: Bearer abc123xyz456" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -d "recipients=+1234567890" \
 -d "message=Hello"

Which Method Should You Use?

- Use API Key Authentication for quick and straightforward integrations.

- Use OAuth2 Authentication for enhanced security and scalability in your integrations.

For more details, please refer to the full documentation.

SMS-API abrufen

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

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

Parameter:

- Empfänger: Die Handynummer des Empfängers.

- Nachricht: Die zu sendende Nachricht.

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

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: Löscht bei alleiniger Verwendung alle Nachrichten vom angegebenen Tag.

- date_start und date_end: Kombiniert, um Nachrichten innerhalb eines angegebenen 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:

- Empfänger: Die Handynummer des Empfängers.

- Nachricht: Die zu sendende Nachricht.

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

SMS senden

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"

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'
 );
 
 $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.

SMS senden

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.

SMS senden

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.

SMS senden

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.

SMS senden

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