SMSMobileAPI – API-documentatie voor gespreksbeheer

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.

Steun: api@smsmobileapi.com

Zoekopdracht

Snelstart

Basis-URL

KRIJGENhttps://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=3247&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 (op basis van dateLimit >= CURDATE()). Indien verlopen, ontvangt u api_expiredHet eindpunt voor gemiste oproepen kan, afhankelijk van de omstandigheden, een algemene foutmelding "API-sleutel ontbreekt" of serverfouten retourneren.

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 komt overeen met het telefoonnummer of de opgeslagen naam.

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.

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

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

Queryparameters

Parameter	Type	Beschrijving
Vereist`apikey`	snaar	Je API-sleutel is gekoppeld aan de mobiele telefoon.
Optioneel`verschuiving`	int	Paginatie-offset (standaard: `0`).
Optioneel`beperken`	int	Maximaal aantal rijen dat moet worden geretourneerd (standaard: `100`, max: `500`).
Optioneel`zoekopdracht`	snaar	Zoeken op nummer of naam (SQL LIKE).
Optioneel`datum_start`	JJJJ-MM-DD	Filter vanaf deze dag (00:00:00). Vergeleken met de opgeslagen tijdstempel in milliseconden.
Optioneel`datum_einde`	JJJJ-MM-DD	Filteren tot en met vandaag (23:59:59). Vergeleken met de opgeslagen tijdstempel in milliseconden.

Sorteren

Vast: nieuwste eerst (SORTEREN OP datum OMSCHRIJVING).

Voorbeeldverzoek


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

Voorbeeldantwoord

{ "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" } ] }

Inkomende oproepen – Lijst

Ontvang inkomende, beantwoordde oproepen die vanaf het mobiele apparaat zijn gesynchroniseerd.

Eindpunt

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

Queryparameters

Parameter	Type	Beschrijving
Vereist`apikey`	snaar	Uw API-sleutel. Geverifieerd aan de hand van uw abonnement (`datumlimiet`).
Optioneel`beperken`	int	Rijen per pagina (standaard: `50`, min 1, max `200`).
Optioneel`verschuiving`	int	Paginatie-offset (standaard: `0`).
Optioneel`sorteren_op`	snaar	Sorteerveld (standaard: `oproepdatum_ms`). Toegestaan: `oproepdatum_ms`, `call_datetime_utc`, `duur_sec`, `telefoonnummer`, `gemaakt_op`, `cached_name`, `geo_location`.
Optioneel`sorteer_map`	oplopend\|aflopend	Sorteerrichting (standaard: `beschrijving`).
Optioneel`datum_van_ms`	int (ms)	Filter waar `call_date_ms >= date_from_ms`.
Optioneel`datum_naar_ms`	int (ms)	Filter waar `call_date_ms <= date_to_ms`.
Optioneel`Q`	snaar	Zoeken (Vinden) op `telefoonnummer` of `cached_name`.

Voorbeeldverzoek


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

Voorbeeldantwoord

{ "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" } ] }

Uitgaande oproepen – Lijst

Uitgaande oproepen ophalen die vanaf het mobiele apparaat zijn gesynchroniseerd.

Eindpunt

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

Queryparameters

Dezelfde parameters en hetzelfde gedrag als inkomende oproepen.

Parameter	Type	Beschrijving
Vereist`apikey`	snaar	Uw API-sleutel. Geverifieerd aan de hand van uw abonnement (`datumlimiet`).
Optioneel`beperken`	int	Rijen per pagina (standaard: `50`max `200`).
Optioneel`verschuiving`	int	Paginatie-offset (standaard: `0`).
Optioneel`sorteren_op`	snaar	Standaard `oproepdatum_ms`. Toegestaan: `oproepdatum_ms`, `call_datetime_utc`, `duur_sec`, `telefoonnummer`, `gemaakt_op`, `cached_name`, `geo_location`.
Optioneel`sorteer_map`	oplopend\|aflopend	Standaard `beschrijving`.
Optioneel`datum_van_ms`	int (ms)	Filteren op basis van dit tijdstempel (ms).
Optioneel`datum_naar_ms`	int (ms)	Filter tot en met dit tijdstempel (ms).
Optioneel`Q`	snaar	Zoeken op `telefoonnummer` of `cached_name`.

Voorbeeldverzoek


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

Voorbeeldantwoord

{ "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": "België", "aangemaakt op": "2026-02-24 04:14:37" } ] }

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	Teruggezonden door de API (uw sleutel).
`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.

API- en ontwikkelaarsdocumentatie

Logboek met hulpmiddelen en wijzigingen

API-documentatie voor gespreksbeheer

Snelstart

Basis-URL

Voorbeelden

Authenticatie

Gemeenschappelijke concepten

Paginering

Tijdstempels

Zoekopdracht

Sorteren (alleen inkomend/uitgaand)

Fouten

Gemiste oproepen - Lijst

Eindpunt

Queryparameters

Sorteren

Voorbeeldverzoek

Voorbeeldantwoord

Inkomende oproepen – Lijst

Eindpunt

Queryparameters

Voorbeeldverzoek

Voorbeeldantwoord

Uitgaande oproepen – Lijst

Eindpunt

Queryparameters

Voorbeeldverzoek

Voorbeeldantwoord

Gemiste oproepvelden

Inkomende/uitgaande velden

💬 Livechat beschikbaar