API-documentatie voor gespreksbeheer
Met deze eindpunten kunt u uw gegevens ophalen. Gemiste oproepen, Inkomende beantwoordde oproepen, En Uitgaande gesprekken Gesynchroniseerd vanuit de SMSMobileAPI mobiele app naar uw dashboard + API.
Belangrijk: als de mobiele app op de achtergrond draait, kan het telefoonsysteem een vertraging (vaak tot wel 10 minuten) tussen synchronisaties veroorzaken. Je kunt de app altijd openen om handmatig te synchroniseren als dat nodig is.
Hulp nodig? api@smsmobileapi.com
Snelstart
Basis-URL
KRIJGEN https://api.smsmobileapi.com
Alle onderstaande eindpunten zijn gedocumenteerd als KRIJGEN verzoeken. Vervangen UW_API_SLEUTEL met uw echte sleutel (deel deze niet openbaar).
Voorbeelden
GET https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY
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=1555&date_from_ms=1700000000000&date_to_ms=1700864000000
Authenticatie
Eindpunten voor gespreksbeheer authenticeren zich met behulp van de apikey queryparameter.
Abonnementsvalidatie: Inkomende/uitgaande eindpunten valideren uw API-sleutel en controleren de geldigheid van uw abonnement (dateLimit >= CURDATE()). Indien verlopen, ontvangt u api_expired.
Gemeenschappelijke concepten
Paginering
Gebruik beperken En verschuiving om de resultaten te pagineren.
Tijdstempels
- oproepdatum_ms is een UNIX-tijdstempel in milliseconden.
- call_datetime_utc wordt opgeslagen als een UTC-datum/tijd-string (databaseveld).
- Voor gemiste oproepen retourneert de API een geformatteerd bericht. datum tekenreeks (afgeleid van een millisecondenwaarde).
Zoekopdracht
- Gemiste oproepen: zoekopdracht komt overeen met het nummer of de naam.
- Inkomend/Uitgaand: Q wedstrijden telefoonnummer of cached_name.
Sorteren (alleen inkomend/uitgaand)
Sortering wordt aangestuurd door sorteren_op + sorteer_map (Alleen velden op de whitelist). Gemiste oproepen worden altijd gesorteerd op meest recente.
Alle antwoordvoorbeelden in deze documentatie zijn geanonimiseerdDe API-sleutels, telefoonnummers en contactnamen die hieronder worden weergegeven, zijn slechts voorbeelden.
Fouten
| HTTP | Voorbeeldfout | Betekenis |
|---|---|---|
| 400 | {"success":false,"errormissing_apikey"} | Ontbreekt of is leeg apikey. |
| 403 | {"success":false,"error:invalid_apikey"} | API-sleutel niet gevonden/niet herkend. |
| 403 | {"success":false,"error:api_expired"} | Je abonnement is verlopen (datumlimiet (voor vandaag). |
| 500 | {"success":false,"errorserver_errordetail..."} | Serverfout (database, SQL, uitzondering). |
Opmerking: het eindpunt voor gemiste oproepen kan ook berichten retourneren zoals API-sleutel ontbreekt of SQL-voorbereidingsfouten, afhankelijk van de situatie.
Gemiste oproepen - Lijst
Gemiste oproepen ophalen die vanaf het mobiele apparaat zijn gesynchroniseerd.
Eindpunt
KRIJGEN https://api.smsmobileapi.com/call/missed/list/
Queryparameters
| Parameter | Type | Beschrijving |
|---|---|---|
| apikey | snaar | Vereist Je API-sleutel is gekoppeld aan de mobiele telefoon. |
| verschuiving | int | Optioneel Paginatie-offset (standaard: 0). |
| beperken | int | Optioneel Maximaal aantal rijen (standaard: 100, max: 500). |
| zoekopdracht | snaar | Optioneel Zoeken op nummer of naam (SQL LIKE). |
| datum_start | JJJJ-MM-DD | Optioneel Filteren vanaf deze dag (00:00:00). |
| datum_einde | JJJJ-MM-DD | Optioneel Filter tot en met vandaag (23:59:59). |
Voorbeeldverzoek
GET https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY&offset=0&limit=100
Voorbeeld van een JSON-antwoord
{ "success": true, "offset": 0, "limit": 100, "count": 3, "data": [ { "number": "+15551230001", "name": "", "date": "2026-03-20 16:12:28" }, { "number": "+15551230002", "name": "Alex Carter", "date": "2026-03-20 16:12:00" }, { "number": "+447700900123", "name": "Taylor Reed", "date": "2026-03-20 15:48:41" } ] }
Toelichting op het antwoord
| Veld | Beschrijving |
|---|---|
| succes | WAAR Dit betekent dat het verzoek succesvol is verwerkt. |
| verschuiving | De pagineringsoffset die door de API wordt geretourneerd. |
| beperken | Er is een pagineringslimiet toegepast op het verzoek. |
| graaf | Aantal geretourneerde rijen in gegevens. |
| gegevens | Een array met gegevens over gemiste oproepen. |
| data[].nummer | Telefoonnummer van de beller. |
| data[].name | Opgeslagen contactnaam. Kan leeg zijn als er geen contactnaam beschikbaar is. |
| data[].date | Opgemaakte datum en tijd van het gesprek. |
Bovenstaande voorbeeldwaarden zijn geanonimiseerd. Werkelijke reacties kunnen andere telefoonnummers en contactlabels bevatten.
Inkomende oproepen – Lijst
Ontvang inkomende, beantwoordde oproepen die vanaf het mobiele apparaat zijn gesynchroniseerd.
Eindpunt
KRIJGEN https://api.smsmobileapi.com/call/incoming/list/
Queryparameters
| Parameter | Type | Beschrijving |
|---|---|---|
| apikey | snaar | Vereist Uw API-sleutel (gevalideerd aan de hand van uw abonnement). |
| beperken | int | Optioneel Rijen per pagina (standaard: 50, max: 200). |
| verschuiving | int | Optioneel Paginatie-offset (standaard: 0). |
| sorteren_op | snaar | Optioneel Toegestaan: oproepdatum_ms call_datetime_utc duur_sec telefoonnummer gemaakt_op cached_name geo_location |
| sorteer_map | oplopend|aflopend | Optioneel Standaard: beschrijving. |
| datum_van_ms | int (ms) | Optioneel Filter waar call_date_ms >= date_from_ms. |
| datum_naar_ms | int (ms) | Optioneel Filter waar call_date_ms <= date_to_ms. |
| Q | snaar | Optioneel Zoeken op telefoonnummer of cached_name (LEUK VINDEN). |
Voorbeeldverzoek
GET https://api.smsmobileapi.com/call/incoming/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=call_date_ms&sort_dir=desc
Voorbeeld van een JSON-antwoord
{ "success": true, "apikey": "YOUR_API_KEY_HASH", "limit": 50, "offset": 0, "sort_by": "call_date_ms", "sort_dir": "desc", "filters": { "date_from_ms": null, "date_to_ms": null, "q": null }, "count": 3, "rows": [ { "phone_number": "+15551230010", "cached_name": "Jordan Blake", "call_date_ms": 1774027779390, "call_datetime_utc": "2026-03-20 17:29:39", "duration_sec": 23, "geo_location": "Canada", "created_at": "2026-03-20 17:46:45" }, { "phone_number": "+15551230011", "cached_name": "Morgan Lee", "call_date_ms": 1774018268663, "call_datetime_utc": "2026-03-20 14:51:08", "duration_sec": 50, "geo_location": "Canada", "created_at": "2026-03-20 14:58:37" }, { "phone_number": "+447700900124", "cached_name": "Sam Parker", "call_date_ms": 1774011205123, "call_datetime_utc": "2026-03-20 12:53:25", "duration_sec": 92, "geo_location": "Canada", "created_at": "2026-03-20 12:59:01" } ] }
Toelichting op het antwoord
| Veld | Beschrijving |
|---|---|
| succes | WAAR Dit betekent dat het verzoek succesvol is verwerkt. |
| apikey | De weergegeven API-sleutelwaarde. In documentatievoorbeelden moet deze altijd gemaskeerd worden. |
| beperken | Aantal rijen per pagina. |
| verschuiving | De pagineringsoffset die door de API wordt geretourneerd. |
| sorteren_op | Sorteerveld toegepast door de API. |
| sorteer_map | Sorteerrichting toegepast door de API. |
| filters | Object dat de actieve filters bevat die voor het verzoek zijn gebruikt. |
| graaf | Aantal geretourneerde rijen in rijen. |
| rijen | Een array met inkomende, beantwoordde oproepgegevens. |
| rijen[].telefoonnummer | Telefoonnummer gekoppeld aan het gesprek. |
| rijen[].cached_name | Opgeslagen contactnaam. Kan null of leeg zijn, afhankelijk van de beschikbare gegevens. |
| rijen[].oproepdatum_ms | Tijdstempel van het gesprek in milliseconden. |
| rijen[].call_datetime_utc | UTC-datum en -tijd van het gesprek. |
| rijen[].duur_sec | Gespreksduur in seconden. |
| rijen[].geo_locatie | Geografisch label dat bij het nummer hoort, indien beschikbaar. |
| rijen[].gemaakt_op | Datum en tijd waarop de rij op de server is ingevoegd. |
De API kan uw gegevens weergeven. apikey In het antwoord. In openbare documentatie, schermafbeeldingen en voorbeelden moet je het altijd maskeren.
Uitgaande oproepen – Lijst
Uitgaande oproepen ophalen die vanaf het mobiele apparaat zijn gesynchroniseerd.
Eindpunt
KRIJGEN https://api.smsmobileapi.com/call/outgoing/list/
Queryparameters
Dezelfde parameters en hetzelfde gedrag als inkomende oproepen.
| Parameter | Type | Beschrijving |
|---|---|---|
| apikey | snaar | Vereist Uw API-sleutel (gevalideerd aan de hand van uw abonnement). |
| beperken | int | Optioneel Rijen per pagina (standaard: 50, max: 200). |
| verschuiving | int | Optioneel Paginatie-offset (standaard: 0). |
| sorteren_op | snaar | Optioneel Toegestaan: oproepdatum_ms call_datetime_utc duur_sec telefoonnummer gemaakt_op cached_name geo_location |
| sorteer_map | oplopend|aflopend | Optioneel Standaard: beschrijving. |
| datum_van_ms | int (ms) | Optioneel Filter waar call_date_ms >= date_from_ms. |
| datum_naar_ms | int (ms) | Optioneel Filter waar call_date_ms <= date_to_ms. |
| Q | snaar | Optioneel Zoeken op telefoonnummer of cached_name (LEUK VINDEN). |
Voorbeeldverzoek
GET https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=call_date_ms&sort_dir=desc
Voorbeeld van een JSON-antwoord
{ "success": true, "apikey": "YOUR_API_KEY_HASH", "limit": 50, "offset": 0, "sort_by": "call_date_ms", "sort_dir": "desc", "filters": { "date_from_ms": null, "date_to_ms": null, "q": null }, "count": 3, "rows": [ { "phone_number": "+15551230020", "cached_name": "Casey Morgan", "call_date_ms": 1774025965645, "call_datetime_utc": "2026-03-20 16:59:25", "duration_sec": 15, "geo_location": "Canada", "created_at": "2026-03-20 17:17:58" }, { "phone_number": "+15551230021", "cached_name": "Taylor Brooks", "call_date_ms": 1774023172638, "call_datetime_utc": "2026-03-20 16:12:52", "duration_sec": 556, "geo_location": "Canada", "created_at": "2026-03-20 16:28:38" }, { "phone_number": "+33198765432", "cached_name": "Jamie Carter", "call_date_ms": 1774019040000, "call_datetime_utc": "2026-03-20 15:04:00", "duration_sec": 61, "geo_location": "Canada", "created_at": "2026-03-20 15:09:11" } ] }
Toelichting op het antwoord
| Veld | Beschrijving |
|---|---|
| succes | WAAR Dit betekent dat het verzoek succesvol is verwerkt. |
| apikey | De weergegeven API-sleutelwaarde. In documentatievoorbeelden moet deze altijd gemaskeerd worden. |
| beperken | Aantal rijen per pagina. |
| verschuiving | De pagineringsoffset die door de API wordt geretourneerd. |
| sorteren_op | Sorteerveld toegepast door de API. |
| sorteer_map | Sorteerrichting toegepast door de API. |
| filters | Object dat de actieve filters bevat die voor het verzoek zijn gebruikt. |
| graaf | Aantal geretourneerde rijen in rijen. |
| rijen | Een array met gegevens over uitgaande gesprekken. |
| rijen[].telefoonnummer | Telefoonnummer gekoppeld aan het gesprek. |
| rijen[].cached_name | Opgeslagen contactnaam. Kan null of leeg zijn, afhankelijk van de beschikbare gegevens. |
| rijen[].oproepdatum_ms | Tijdstempel van het gesprek in milliseconden. |
| rijen[].call_datetime_utc | UTC-datum en -tijd van het gesprek. |
| rijen[].duur_sec | Gespreksduur in seconden. |
| rijen[].geo_locatie | Geografisch label dat bij het nummer hoort, indien beschikbaar. |
| rijen[].gemaakt_op | Datum en tijd waarop de rij op de server is ingevoegd. |
De bovenstaande voorbeeldwaarden zijn geanonimiseerd. Vervang ze alleen in interne tools door uw eigen actuele gegevens, nooit in openbare documentatie.
Gemiste oproepvelden
| Veld | Type | Beschrijving |
|---|---|---|
| succes | bool | Status van het verzoek. |
| verschuiving | int | De geretourneerde pagineringsoffset. |
| beperken | int | De pagineringslimiet is geretourneerd. |
| graaf | int | Aantal geretourneerde rijen in gegevens. |
| gegevens | array | Lijst met gemiste oproepen. |
| data[].nummer | snaar | Telefoonnummer van de beller. |
| data[].name | snaar | Opgeslagen contactnaam (kan leeg zijn). |
| data[].date | snaar | Geformatteerde datum- en tijdstring, afgeleid van een tijdstempel in milliseconden. |
Inkomende/uitgaande velden
| Veld | Type | Beschrijving |
|---|---|---|
| succes | bool | Status van het verzoek. |
| apikey | snaar | Wordt teruggestuurd door de API (uw sleutel). In openbare documentatie moet u deze altijd maskeren. |
| beperken | int | Aantal rijen per pagina. |
| verschuiving | int | De geretourneerde pagineringsoffset. |
| sorteren_op | snaar | Toegepast sorteerveld. |
| sorteer_map | snaar | Toegepaste sorteerrichting. |
| filters | voorwerp | Weerkaatste filters (datum_van_ms, datum_naar_ms, Q). |
| graaf | int | Aantal geretourneerde rijen in rijen. |
| rijen | array | Lijst met oproepen. |
| rijen[].telefoonnummer | snaar | Telefoonnummer. |
| rijen[].cached_name | string|null | Opgeslagen contactnaam (kan null zijn). |
| rijen[].oproepdatum_ms | int | Tijdstempel van het gesprek in milliseconden. |
| rijen[].call_datetime_utc | snaar | UTC-datum/tijdveld (database). |
| rijen[].duur_sec | int | Duur in seconden. |
| rijen[].geo_locatie | string|null | Label voor geografische locatie (kan null/leeg zijn). |
| rijen[].gemaakt_op | snaar | Tijdstempel van invoeging op de server. |
English 
French 
German 
Spanish 
Portuguese 
Russian 
Finnish 
Japanese 
Chinese 
Vietnamese 
Dutch 
Greek 
Arabic 
Danish 
Italian 
Ukrainian