SMS-Dokumentation
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 so konzipiert, dass sie sich nahtlos in Ihre Projekte integrieren lässt.
Wir haben auch gebrauchsfertige Plugins für E-Commerce-Lösungen und -Software.
Klicken Sie hier, um sie zu entdecken.
SMS senden
Dieser Endpunkt ermöglicht Ihnen, eine SMS von Ihrem Mobiltelefon zu senden.Endpunkt:
Parameter:
| Parameter | Beschreibung |
|---|---|
| apikey | Erforderlich Ihr einzigartiger API-Schlüssel. |
| recipients | Erforderlich Die Telefonnummer des Empfängers. |
| message | Erforderlich Die zu sendende Nachricht (keine Beschränkung auf 160 Zeichen). |
| shorturl | 1 = URLs in Kurzlinks umwandeln 0 oder leer = keine Konvertierung |
| sIdentifiant | Wählen Sie das verbundene Telefon aus, das die SMS sendet. Lassen Sie das Feld leer, um das erste verfügbare Gerät zu verwenden. App-Version 3.0.35.3 oder höher erforderlich. |
| sendwa | 1 = per WhatsApp senden. |
| sendsms | 1 = Versand per SMS (Standardeinstellung, falls leer). Auf 0 setzen, um SMS zu blockieren. |
| encrypt_message | Ja Der Empfänger benötigt einen Schlüssel zur Entschlüsselung. Mehr erfahren |
| schedule_timestamp | UNIX-Zeitstempel (GMT 0), ab dem die SMS gesendet werden soll. |
Beispiel:
GET https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&recipients=+1234567890&message=HelloWorld
Eine nicht gesendete SMS erneut senden
Dieser API-Endpunkt dient dazu, eine nicht gesendete SMS erneut zu senden (nur wenn die Nachricht einen Fehlerstatus aufweist).
Endpunkt:
Parameter:
| Parameter | Beschreibung |
|---|---|
| guid | Erforderlich GUID der erneut zu sendenden Nachricht. |
Beispiel:
GET https://api.smsmobileapi.com/resend/?apikey=IHR_API_SCHLÜSSEL&guid=GUID_DER_NACHRICHT
Protokoll der von der API gesendeten SMS
Dieser API-Endpunkt wird verwendet, um das Protokoll der über die API gesendeten SMS-Nachrichten abzurufen.
Endpunkt:
Parameter:
| Parameter | Beschreibung |
|---|---|
| apikey | Erforderlich Ihr API-Schlüssel. |
| guid_message | Filtern Sie nach der eindeutigen Kennung der Nachricht. |
| before | Ruft Nachrichten ab, die vor diesem Zeitstempel oder dieser GUID gesendet wurden. |
| error_api | 1 = SMS mit API-Anfragefehler auflisten. |
| error_mobile | 1 = Liste der SMS mit Fehlern bei der mobilen Verarbeitung. |
| keyword | Filtern nach Empfängernummer oder Nachrichteninhalt. |
Beispiel:
GET https://api.smsmobileapi.com/log/sent/sms?apikey=IHR_API_SCHLÜSSEL
Empfangene SMS
Dieser API-Endpunkt dient zum Abrufen von auf dem Smartphone empfangenen SMS-Nachrichten.
Endpunkt:
Parameter:
| Parameter | Beschreibung |
|---|---|
| apikey | Erforderlich Der API-Schlüssel, den Sie haben oder erhalten werden. |
| sIdentifiantPhone | Isolieren Sie ein Telefon, das mit empfangenen SMS in Verbindung steht. |
| after_timestamp_unix | Liste der nach einem UNIX-Zeitstempel empfangenen SMS. |
| onlyunread | "ja" = Liste nur SMS, die nicht als gelesen markiert sind (API-Status). |
Beispiel:
GET https://api.smsmobileapi.com/getsms/?apikey=IHR_API_SCHLÜSSEL
Empfangene SMS-Nachrichten als gelesen markieren
Dieser API-Endpunkt dient dazu, eine empfangene SMS als gelesen zu markieren. Nur API-Status.
Dies ändert nichts am Lesestatus des Smartphones.
Endpunkt:
Parameter:
| Parameter | Beschreibung |
|---|---|
| apikey | Erforderlich Der API-Schlüssel, den Sie haben oder erhalten werden. |
| guid_message | Erforderlich GUID der Nachricht, die als gelesen markiert werden soll. |
Beispiel:
GET https://api.smsmobileapi.com/getsms/set-read/?apikey=YOUR_APIKEY&guid_message=GUID_MESSAGE
SMS löschen
Dieser API-Endpunkt dient zum Löschen von SMS-Nachrichten aus dem Serverprotokoll der SMS Mobile API.
Endpunkt:
Parameter:
| Parameter | Beschreibung |
|---|---|
| apikey | Erforderlich 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. |
Beispiel:
Holen Sie sich https://api.smsmobileapi.com/deletesms/?apikey=IHR_API_SCHLÜSSEL
Hinweis: Gelöschte SMS sind nur solche, die in den Serverprotokollen gespeichert sind. SMS auf dem Gerät werden nicht gelöscht.
Gateway – Liste der verbundenen Mobilgeräte
Liste der mit Ihrem Gerät verbundenen Mobilgeräte auf SMS-Gateway.
Endpunkt:
Parameter:
| Parameter | Beschreibung |
|---|---|
| apikey | Erforderlich Ihr API-Schlüssel. |
| sid | Filtern nach exakter SID (sIdentifiant_pour_check). |
| search | Suche in Feldern (sid, date, battery, version, label...). |
Beispiel:
GET https://api.smsmobileapi.com/gateway/mobile/list/?apikey=YOUR_API_KEY
Gateway – Aktualisieren eines mobilen Labels
Aktualisiere die Bezeichnung (nom_reference) eines verbundenen Mobilgeräts.
Endpunkt:
Parameter:
| Parameter | Beschreibung |
|---|---|
| apikey | Erforderlich Ihr API-Schlüssel. |
| sid | Erforderlich Die Geräte-SID (sIdentifiant_pour_check). |
| label | Erforderlich Neues Etikett (kann leer sein). |
Beispiel:
GET https://api.smsmobileapi.com/gateway/mobile/update/?apikey=YOUR_API_KEY&sid=SID&label=OfficePhone
Wichtig: Ein Etikett ist erforderlich, kann aber leer sein. (label=).
Gateway – Ein verbundenes Mobilgerät löschen
Entfernen Sie ein verbundenes Mobilgerät von Ihrem Gateway (löscht alle Verlaufszeilen für diese SID).
Endpunkt:
Parameter:
| Parameter | Beschreibung |
|---|---|
| apikey | Erforderlich Ihr API-Schlüssel. |
| sid | Erforderlich Die Geräte-SID (sIdentifiant_pour_check). |
Beispiel:
GET https://api.smsmobileapi.com/gateway/mobile/delete/?apikey=YOUR_API_KEY&sid=SID
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:
{ "date": "2025-01-20", "hour": "10:15:00", "time_received": "2025-01-20 10:14:50", "message": "Hallo, dies ist ein Test.", "number": "+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:
Testen des Webhooks
Verwenden Sie zum Testen Ihrer Webhook-Konfiguration Tools wie:
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.
Erweiterte SMS
Demnächst verfügbarAuthentifizierung
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
Diese Methode erfordert einen API-Schlüssel, der als Parameter in eine GET- oder POST-Anfrage eingefügt werden kann.
2. OAuth2-Authentifizierung
OAuth2 bietet eine sicherere Authentifizierungsmethode.
Verwenden Sie eine Client-ID und ein Client-Geheimnis, um ein Zugriffstoken zu erhalten, und fügen Sie es dann in die folgende ein: Genehmigung Kopfzeile.
Die Client-ID und das Client-Geheimnis sind in Ihrem Dashboard verfügbar.
Laden Sie jetzt die mobile App herunter oder
Greifen Sie auf Ihr Dashboard zu.
Abrufen eines Zugriffstokens
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=YOUR_CLIENT_ID" \
-d "client_secret=YOUR_CLIENT_SECRET"
Verwenden des Zugriffstokens:
curl -X POST https://api.smsmobileapi.com/sendsms \
-H "Autorisierung: Träger IHR_ZUGRIFFSTOKEN" \
-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 mehr Sicherheit und Skalierbarkeit.
SMS senden
WSDL-URL
Parameter:
- message: 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);
Senden Sie SMS und WhatsApp
Grundlegender cURL-Befehl
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"
Senden Sie SMS und WhatsApp
Nutzen Sie unser offizielles Python-Modul: https://smsmobileapi.com/python/
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)
SMS Mobile API – PHP SDK (Composer)
Komponist erfordert SMSMobileaPi/SDK
GitHub: https://github.com/SmsMobileApi/smsmobileapi-php/tree/main
Senden Sie SMS und WhatsApp
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(r=>r.text()).then(console.log);
Senden Sie SMS und WhatsApp
const axios = require("axios");
axios.post("https://api.smsmobileapi.com/sendsms/", {recipients:"PHONE_NUMBER", message:"YOUR_MESSAGE", apikey:"YOUR_API_KEY"})
.then(r=>console.log(r.data));
Senden Sie SMS und WhatsApp
require "net/http"
require "uri"
uri = URI.parse("https://api.smsmobileapi.com/sendsms/")
req = Net::HTTP::Post.new(uri)
req.set_form_data({"recipients"=>"PHONE_NUMBER","message"=>"YOUR_MESSAGE","apikey"=>"YOUR_API_KEY"})
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true){|http| http.request(req)}
puts res.body
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
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
English 
French 
German 
Spanish 
Portuguese 
Russian 
Finnish 
Japanese 
Chinese 
Vietnamese 
Dutch 
Greek 
Arabic 
Danish 
Italian 
Ukrainian