Entwicklungsdokument – SMSMobileAPI
✨ Hurry! Enjoy an exclusive discount of 30%! Available until 01 April —don’t miss out! ✨

SMS-Dokumentation

SMSmobileAPI Entwicklerdokumentation

Bei SMSmobileAPI sind wir bestrebt, unsere API so kompatibel wie möglich mit jeder Architektur oder Plattform zu machen.
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.

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

.
API REST
cURL
Composer
JavaScript JavaScript
Python Python
Node.js Node.js
Rubin Rubin
WSDL
SMS senden
Nicht gesendete SMS erneut senden
LOG SMS gesendet
SMS erhalten
SMS löschen
SMS empfangen - Webhook
Authentifizierung
 

SMS senden

Dieser Endpunkt ermöglicht Ihnen, eine SMS von Ihrem Mobiltelefon zu senden.

Endpunkt: 

ERHALTEN POST https://api.smsmobileapi.com/sendsms/

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=IHR_API_SCHLÜSSEL&recipients=+1234567890&message=HelloWorld
Hinweis: Im Falle eines von Ihrem Betreiber verursachten Zustellungsfehlers versucht eine Standardfunktion, dieselbe SMS innerhalb eines festgelegten Intervalls bis zu dreimal erneut zu versenden.



Eine nicht gesendete SMS erneut senden

 Dieser API-Endpunkt wird verwendet, um eine nicht gesendete SMS erneut zu senden (nur, wenn die Nachricht einen Fehlerstatus aufweist).

Endpunkt:

ERHALTEN   POST https://api.smsmobileapi.com/resend/

Parameter: 

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

ERHALTEN https://api.smsmobileapi.com/log/sent/sms/

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.  

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:

ERHALTEN https://api.smsmobileapi.com/getsms/

Parameter: 

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

Beispiel:

GET https://api.smsmobileapi.com/getsms/?apikey=IHR_API_SCHLÜSSEL

 

SMS löschen

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

Endpunkt:  

ERHALTEN https://api.smsmobileapi.com/deletesms/

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.  

Beispiel:

Holen Sie sich https://api.smsmobileapi.com/deletesms/?apikey=IHR_API_SCHLÜSSEL

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.

 


Webhook – SMS Received

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:

  1. Melden Sie sich bei Ihrem Konto an auf der Dashboard der SMS Mobile API.
  2. Navigieren Sie zum Webhook-Einstellungen Abschnitt.
  3. Geben Sie Ihre Webhook-URL ein (z. B. https://example.com/webhook-endpoint
  4. Klicken Sie auf das Webhook speichern Taste. 
  5. 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.



Authentifizierung

 

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 einer GET- oder POST-Anfrage enthalten sein kann. Dies ist eine unkomplizierte Möglichkeit, Ihre API-Anfragen zu authentifizieren.

2. OAuth2-Authentifizierung

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.


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

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

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

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.
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.
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
Mein Mobiltelefon verbinden