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.
Schnellstart
Basis-URL
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.
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_msist 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.
DatumZeichenkette (abgeleitet von einem Millisekundenwert).
Suchen
- Verpasste Anrufe:
suchenEntspricht Nummer oder Name. - Eingehend/Ausgehend:
QEntspricht 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
Abfrageparameter
| Parameter | Typ | Beschreibung |
|---|---|---|
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
Abfrageparameter
| Parameter | Typ | Beschreibung |
|---|---|---|
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
Abfrageparameter
Gleiche Parameter und gleiches Verhalten wie bei eingehenden Anrufen.
| Parameter | Typ | Beschreibung |
|---|---|---|
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
| Feld | Typ | Beschreibung |
|---|---|---|
Erfolg | bool | Anfragestatus. |
Versatz | int | Seitenumbruch zurückgegeben. |
Limit | int | Seitenbegrenzung zurückgegeben. |
zählen | int | Anzahl der zurückgegebenen Zeilen in Daten. |
Daten | Array | Liste der verpassten Anrufe. |
Daten[].Zahl | Zeichenkette | Telefonnummer des Anrufers. |
data[].name | Zeichenkette | Zwischengespeicherter Kontaktname (kann leer sein). |
Daten[].Datum | Zeichenkette | Formatierte Datums-/Zeitzeichenfolge, abgeleitet aus einem Millisekunden-Zeitstempel. |
Eingehende/Ausgehende Felder
| Feld | Typ | Beschreibung |
|---|---|---|
Erfolg | bool | Anfragestatus. |
apikey | Zeichenkette | Wird von der API zurückgesendet (Ihr Schlüssel). |
Limit | int | Anzahl der zurückgegebenen Zeilen pro Seite. |
Versatz | int | Seitenumbruch zurückgegeben. |
sort_by | Zeichenkette | Sortierfeld angewendet. |
sort_dir | Zeichenkette | Sortierrichtung angewendet. |
Filter | Objekt | Echoed filters (Datum_von_Millisekunden, Datum in Millisekunden, Q). |
zählen | int | Anzahl der zurückgegebenen Zeilen in Zeilen. |
Zeilen | Array | Anrufliste. |
rows[].phone_number | Zeichenkette | Telefonnummer. |
rows[].cached_name | Zeichenkette|null | Zwischengespeicherter Kontaktname (kann null sein). |
rows[].call_date_ms | int | Zeitstempel des Aufrufs in Millisekunden. |
rows[].call_datetime_utc | Zeichenkette | UTC-Datums-/Zeitfeld (Datenbank). |
rows[].duration_sec | int | Dauer in Sekunden. |
rows[].geo_location | Zeichenkette|null | Geografische Standortbezeichnung (kann null/leer sein). |
rows[].created_at | Zeichenkette | Zeitstempel der Servereinfügung. |
