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

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.

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

- Nachricht: Die zu sendende Nachricht.

Beispiel:

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

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.

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