Doc Dev Call - SMSMobileAPI
SMSMobileAPI – Dokumentation der Anrufverwaltungs-API

Dokumentation der Call Management API

Über diese Endpunkte können Sie Ihre Daten abrufen Verpasste Anrufe, Eingehende Anrufe (angenommen), Und Ausgehende Anrufe Synchronisiert von der SMSMobileAPI-Mobil-App in Ihr Dashboard + API.

Wichtig: Wenn die mobile App im Hintergrund läuft, kann das Telefonsystem die Synchronisierung verzögern (oft bis zu ca. 10 Minuten). Sie können die App bei Bedarf jederzeit öffnen und manuell synchronisieren.

Unterstützung: api@smsmobileapi.com

Schnellstart

Basis-URL

ERHALTENhttps://api.smsmobileapi.com
Alle unten aufgeführten Endpunkte sind dokumentiert als ERHALTEN Anfragen ersetzen. IHR_API_SCHLÜSSEL mit Ihrem echten Schlüssel (geben Sie ihn nicht öffentlich weiter).

Beispiele

GET https://api.smsmobileapi.com/call/missed/list/?apikey=IHR_API-SCHLÜSSEL GET https://api.smsmobileapi.com/call/incoming/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=call_date_ms&sort_dir=desc GET https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&q=3247&date_from_ms=1700000000000&date_to_ms=1700864000000

Authentifizierung

Anrufverwaltungs-Endpunkte authentifizieren sich mithilfe von apikey Abfrageparameter.

Abonnementvalidierung: Eingehende/ausgehende Endpunkte validieren Ihren API-Schlüssel und prüfen die Gültigkeit Ihres Abonnements (basierend auf dateLimit >= CURRADE()Falls abgelaufen, erhalten Sie api_expiredDer Endpunkt für verpasste Anrufe kann je nach den Umständen eine allgemeine Fehlermeldung wie „Fehlender API-Schlüssel“ oder Serverfehler zurückgeben.

Gemeinsame Konzepte

Pagination

Verwenden Limit Und Versatz Ergebnisse paginieren.

Zeitstempel

  • Anrufdatum_ms ist ein UNIX-Zeitstempel in Millisekunden.
  • Anrufdatum/Uhrzeit (UTC) wird als UTC-Datums-/Zeitzeichenfolge (Datenbankfeld) gespeichert.
  • Bei verpassten Anrufen gibt die API ein formatiertes Ergebnis zurück. Datum Zeichenkette (abgeleitet von einem Millisekundenwert).

Suchen

  • Verpasste Anrufe: suchen Entspricht Nummer oder Name.
  • Eingehend/Ausgehend: Q Entspricht Telefonnummer oder zwischengespeichertem Namen.

Sortierung (nur eingehende/ausgehende E-Mails)

Die Sortierung wird gesteuert durch sort_by + sort_dir (Nur Felder auf der Whitelist). Verpasste Anrufe werden immer nach dem neuesten Datum zuerst sortiert.

Fehler

HTTP Beispielfehler Bedeutung
400 {"success":false,"error":"missing_apikey"} Fehlend oder leer apikey.
403 {"success":false,"error":"invalid_apikey"} API-Schlüssel nicht gefunden / nicht erkannt.
403 {"success":false,"error":"api_expired"} Ihr Abonnement ist abgelaufen (Datumslimit (ist vor heute).
500 {"success":false,"error":"server_error","detail":"..."} Serverfehler (Datenbank, SQL, Ausnahme).

Hinweis: Der Endpunkt „Verpasste Anrufe“ kann auch Meldungen wie die folgenden zurückgeben: Fehlender API-Schlüssel oder SQL-Vorbereitungsfehler, je nach Situation.

Verpasste Anrufe – Liste

Verpasste Anrufe vom Mobilgerät abrufen.

Endpunkt

ERHALTENhttps://api.smsmobileapi.com/call/missed/list/

Abfrageparameter

ParameterTypBeschreibung
Erforderlichapikey Zeichenkette Ihr API-Schlüssel ist mit dem Mobiltelefon verknüpft.
OptionalVersatz int Seitenumbruch (Standardwert: 0).
OptionalLimit int Maximale Anzahl der zurückzugebenden Zeilen (Standardwert: 100, max: 500).
Optionalsuchen Zeichenkette Suche nach Nummer oder Name (SQL LIKE).
OptionalStartdatum JJJJ-MM-TT Filterung ab diesem Tag (00:00:00). Vergleich mit dem gespeicherten Millisekunden-Zeitstempel.
OptionalDatum_Ende JJJJ-MM-TT Filterung bis zum heutigen Tag (23:59:59). Vergleich mit dem gespeicherten Millisekunden-Zeitstempel.

Sortierung

Behoben: neueste zuerst (Sortieren nach Datum absteigend).

Beispielanfrage

GET https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY&limit=100&offset=0&search=John&date_start=2026-02-01&date_end=2026-02-24

Beispielantwort

{ "success": true, "offset": 0, "limit": 100, "count": 2, "data": [ { "number": "+123470000000", "name": "John Doe", "date": "2026-02-24 12:49:39" }, { "number": "+123471111111", "name": "", "date": "2026-02-24 11:12:09" } ] }

Eingehende Anrufe – Liste

Eingehende, angenommene Anrufe werden vom Mobilgerät synchronisiert.

Endpunkt

ERHALTENhttps://api.smsmobileapi.com/call/incoming/list/

Abfrageparameter

ParameterTypBeschreibung
Erforderlichapikey Zeichenkette Ihr API-Schlüssel. Gegenüber dem Abonnement validiert (Datumslimit).
OptionalLimit int Zeilen pro Seite (Standard: 50, min 1, max 200).
OptionalVersatz int Seitenumbruch (Standardwert: 0).
Optionalsort_by Zeichenkette Sortierfeld (Standard: Anrufdatum_ms). Erlaubt: Anrufdatum_ms, Anrufdatum/Uhrzeit (UTC), Dauer_Sekunden, Telefonnummer, erstellt am, zwischengespeicherter Name, Geolokalisierung.
Optionalsort_dir aufsteigend|absteigend Sortierrichtung (Standard: Beschreibung).
OptionalDatum_von_Millisekunden int (ms) Filter, wo call_date_ms >= date_from_ms.
OptionalDatum in Millisekunden int (ms) Filter, wo call_date_ms <= date_to_ms.
OptionalQ Zeichenkette Suche (LIKE) auf Telefonnummer oder zwischengespeicherter Name.

Beispielanfrage

GET https://api.smsmobileapi.com/call/incoming/list/?apikey=YOUR_API_KEY&limit=100&offset=0&sort_by=call_date_ms&sort_dir=desc&q=3247

Beispielantwort

{ "success": true, "apikey": "YOUR_API_KEY", "limit": 100, "offset": 0, "sort_by": "call_date_ms", "sort_dir": "desc", "filters": { "date_from_ms": null, "date_to_ms": null, "q": "+12347" }, "count": 2, "rows": [ { "phone_number": "+123470000000", "cached_name": "Matteo Css", "call_date_ms": 1761233379000, "call_datetime_utc": "2026-02-23 12:49:39", "duration_sec": 440, "geo_location": "Belgique", "created_at": "2026-02-24 04:14:38" } ] }

Ausgehende Anrufe – Liste

Ausgehende Anrufe abrufen, die vom Mobilgerät synchronisiert wurden.

Endpunkt

ERHALTENhttps://api.smsmobileapi.com/call/outgoing/list/

Abfrageparameter

Gleiche Parameter und gleiches Verhalten wie bei eingehenden Anrufen.

ParameterTypBeschreibung
Erforderlichapikey Zeichenkette Ihr API-Schlüssel. Gegenüber dem Abonnement validiert (Datumslimit).
OptionalLimit int Zeilen pro Seite (Standard: 50, max 200).
OptionalVersatz int Seitenumbruch (Standardwert: 0).
Optionalsort_by Zeichenkette Standard Anrufdatum_ms. Erlaubt: Anrufdatum_ms, Anrufdatum/Uhrzeit (UTC), Dauer_Sekunden, Telefonnummer, erstellt am, zwischengespeicherter Name, Geolokalisierung.
Optionalsort_dir aufsteigend|absteigend Standard Beschreibung.
OptionalDatum_von_Millisekunden int (ms) Filtern Sie ab diesem Zeitstempel (ms).
OptionalDatum in Millisekunden int (ms) Filtern Sie bis zu diesem Zeitstempel (ms).
OptionalQ Zeichenkette Suche auf Telefonnummer oder zwischengespeicherter Name.

Beispielanfrage

GET https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=duration_sec&sort_dir=desc&date_from_ms=1700000000000&date_to_ms=1700864000000

Beispielantwort

{ "success": true, "apikey": "YOUR_API_KEY", "limit": 50, "offset": 0, "sort_by": "duration_sec", "sort_dir": "desc", "filters": { "date_from_ms": "1700000000000", "date_to_ms": "1700864000000", "q": null }, "count": 1, "rows": [ { "phone_number": "+123490000000", "cached_name": null, "call_date_ms": 1761231000000, "call_datetime_utc": "2026-02-23 12:10:00", "duration_sec": 120, "geo_location": "Belgique", "created_at": "2026-02-24 04:14:37" } ] }

Felder für verpasste Anrufe

FeldTypBeschreibung
ErfolgboolAnfragestatus.
VersatzintSeitenumbruch zurückgegeben.
LimitintSeitenbegrenzung zurückgegeben.
zählenintAnzahl der zurückgegebenen Zeilen in Daten.
DatenArrayListe der verpassten Anrufe.
Daten[].ZahlZeichenketteTelefonnummer des Anrufers.
data[].nameZeichenketteZwischengespeicherter Kontaktname (kann leer sein).
Daten[].DatumZeichenketteFormatierte Datums-/Zeitzeichenfolge, abgeleitet aus einem Millisekunden-Zeitstempel.

Eingehende/Ausgehende Felder

FeldTypBeschreibung
ErfolgboolAnfragestatus.
apikeyZeichenketteWird von der API zurückgesendet (Ihr Schlüssel).
LimitintAnzahl der zurückgegebenen Zeilen pro Seite.
VersatzintSeitenumbruch zurückgegeben.
sort_byZeichenketteSortierfeld angewendet.
sort_dirZeichenketteSortierrichtung angewendet.
FilterObjektEchoed filters (Datum_von_Millisekunden, Datum in Millisekunden, Q).
zählenintAnzahl der zurückgegebenen Zeilen in Zeilen.
ZeilenArrayAnrufliste.
rows[].phone_numberZeichenketteTelefonnummer.
rows[].cached_nameZeichenkette|nullZwischengespeicherter Kontaktname (kann null sein).
rows[].call_date_msintZeitstempel des Aufrufs in Millisekunden.
rows[].call_datetime_utcZeichenketteUTC-Datums-/Zeitfeld (Datenbank).
rows[].duration_secintDauer in Sekunden.
rows[].geo_locationZeichenkette|nullGeografische Standortbezeichnung (kann null/leer sein).
rows[].created_atZeichenketteZeitstempel der Servereinfügung.
💬 Live-Chat
💬 Live-Chat verfügbar
Haben Sie Fragen oder benötigen Sie Hilfe?
Unser Team ist für Sie da!

Geben Sie Ihre E-Mail-Adresse ein
um uns bei der Bearbeitung Ihrer Anfrage zu helfen:
Armaturenbrett