SMSMobileAPI – Dokumentation af API til opkaldsstyring

Dokumentation af API til opkaldsstyring

Disse slutpunkter giver dig mulighed for at hente dine Ubesvarede opkald, Indgående besvarede opkald, og Udgående opkald synkroniseret fra SMSMobileAPI-mobilappen til dit dashboard + API.

Vigtigt: Hvis mobilappen kører i baggrunden, kan telefonsystemet muligvis pålægge en forsinkelse (ofte op til ~10 minutter) mellem synkroniseringer. Du kan altid åbne appen for at synkronisere manuelt, hvis det er nødvendigt.

Støtte: api@smsmobileapi.com

Søge

Hurtigstart

Basis-URL

FÅhttps://api.smsmobileapi.com

Alle nedenstående slutpunkter er dokumenteret som FÅ anmodninger. Erstat DIN_API_NØGLE med din rigtige nøgle (del den ikke offentligt).

Eksempler


HENT https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY


HENT https://api.smsmobileapi.com/call/incoming/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=call_date_ms&sort_dir=desc


HENT https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&q=3247&date_from_ms=1700000000000&date_to_ms=1700864000000

Autentificering

Opkaldsstyringsslutpunkter godkendes ved hjælp af apikey forespørgselsparameter.

Validering af abonnement: Indgående/udgående slutpunkter validerer din API-nøgle og kontrollerer gyldigheden af dit abonnement (baseret på datoGrænse >= CUREDATE()Hvis den er udløbet, modtager du api_udløbetSlutpunktet for mistede opkald kan returnere en generisk "Manglende apikey" / serverfejl afhængigt af forholdene.

Almindelige begreber

Paginering

Bruge begrænse og forskydning at paginere resultater.

Tidsstempler

opkaldsdato_ms er et UNIX-tidsstempel i millisekunder.
opkaldsdato_tidspunkt_utc gemmes som en UTC-dato- og klokkeslætsstreng (databasefelt).
For ubesvarede opkald returnerer API'en et formateret dato streng (afledt af en millisekundværdi).

Søge

Ubesvarede opkald: søge matcher nummer eller navn.
Indgående/Udgående: q matcher telefonnummer eller cachelagret navn.

Sortering (kun indgående/udgående)

Sortering styres af sorter_efter + sorteringsmappe (kun hvidlistede felter). Ubesvarede opkald sorteres altid efter nyeste først.

Fejl

HTTP	Eksempelfejl	Mening
400	`{"succes":false,"error":"missing_apikey"}`	Mangler eller er tom `apikey`.
403	`{"succes":false,"error":"invalid_apikey"}`	API-nøgle ikke fundet / ikke genkendt.
403	`{"succes":false,"error":"api_expired"}`	Dit abonnement er udløbet (`datogrænse` er før i dag).
500	`{"succes":false,"error":"server_error","detail":"..."}`	Serverfejl (database, SQL, undtagelse).

Bemærk: Slutpunktet for ubesvarede opkald kan også returnere beskeder som Manglende apikey eller SQL-forberedelsesfejl afhængigt af situationen.

Ubesvarede opkald – Liste

Hent ubesvarede opkald synkroniseret fra mobilenheden.

Slutpunkt

FÅhttps://api.smsmobileapi.com/call/missed/list/

Forespørgselsparametre

Parameter	Type	Beskrivelse
Påkrævet`apikey`	snor	Din API-nøgle er knyttet til mobiltelefonen.
Valgfri`forskydning`	int	Pagineringsforskydning (standard: `0`).
Valgfri`begrænse`	int	Maks. antal rækker, der skal returneres (standard: `100`, maks: `500`).
Valgfri`søge`	snor	Søg efter nummer eller navn (SQL LIKE).
Valgfri`startdato`	ÅÅÅÅ-MM-DD	Filtrer fra denne dag (00:00:00). Sammenlignet med det gemte tidsstempel for millisekunder.
Valgfri`dato_slut`	ÅÅÅÅ-MM-DD	Filtrer frem til i dag (23:59:59). Sammenlignet med det gemte tidsstempel for millisekunder.

Sortering

Rettet: nyeste først (ORDER EFTER dato BESKRIVELSE).

Eksempel på anmodning


HENT 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

Eksempel på svar

{ "succes": sand, "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" } ] }

Indgående opkald – Liste

Hent indgående besvarede opkald synkroniseret fra den mobile enhed.

Slutpunkt

FÅhttps://api.smsmobileapi.com/call/incoming/list/

Forespørgselsparametre

Parameter	Type	Beskrivelse
Påkrævet`apikey`	snor	Din API-nøgle. Valideret mod abonnement (`datogrænse`).
Valgfri`begrænse`	int	Rækker pr. side (standard: `50`, min. 1, maks. `200`).
Valgfri`forskydning`	int	Pagineringsforskydning (standard: `0`).
Valgfri`sorter_efter`	snor	Sorteringsfelt (standard: `opkaldsdato_ms`Tilladt: `opkaldsdato_ms`, `opkaldsdato_tidspunkt_utc`, `varighed_sek`, `telefonnummer`, `oprettet_på`, `cachelagret_navn`, `geoplacering`.
Valgfri`sorteringsmappe`	stigende\|nedgående	Sorteringsretning (standard: `beskrivelse`).
Valgfri`dato_fra_ms`	int (ms)	Filtrer hvor `opkaldsdato_ms >= dato_fra_ms`.
Valgfri`dato_til_ms`	int (ms)	Filtrer hvor `opkaldsdato_ms <= dato_til_ms`.
Valgfri`q`	snor	Søg (SYNES GODT OM) på `telefonnummer` eller `cachelagret_navn`.

Eksempel på anmodning


HENT 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

Eksempel på svar

{ "success": sand, "apikey": "DIN_API_NØGLE", "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": "Belgien", "created_at": "2026-02-24 04:14:38" } ] }

Udgående opkald – Liste

Hent udgående opkald synkroniseret fra mobilenheden.

Slutpunkt

FÅhttps://api.smsmobileapi.com/call/outgoing/list/

Forespørgselsparametre

Samme parametre og funktionsmåde som indgående opkald.

Parameter	Type	Beskrivelse
Påkrævet`apikey`	snor	Din API-nøgle. Valideret mod abonnement (`datogrænse`).
Valgfri`begrænse`	int	Rækker pr. side (standard: `50`, maks. `200`).
Valgfri`forskydning`	int	Pagineringsforskydning (standard: `0`).
Valgfri`sorter_efter`	snor	Misligholdelse `opkaldsdato_ms`Tilladt: `opkaldsdato_ms`, `opkaldsdato_tidspunkt_utc`, `varighed_sek`, `telefonnummer`, `oprettet_på`, `cachelagret_navn`, `geoplacering`.
Valgfri`sorteringsmappe`	stigende\|nedgående	Misligholdelse `beskrivelse`.
Valgfri`dato_fra_ms`	int (ms)	Filtrer fra dette tidsstempel (ms).
Valgfri`dato_til_ms`	int (ms)	Filtrer op til dette tidsstempel (ms).
Valgfri`q`	snor	Søg på `telefonnummer` eller `cachelagret_navn`.

Eksempel på anmodning


HENT 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

Eksempel på svar

{ "success": true, "apikey": "YOUR_API_NØGLE", "limit": 50, "offset": 0, "sort_by": "duration_sec", "sort_dir": "desc", "filters": { "date_from_ms": "170000000000", "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": "Belgien", "created_at": "2026-02-24 04:14:37" } ] }

Felter for mistede opkald

Felt	Type	Beskrivelse
`succes`	bool	Anmodningsstatus.
`forskydning`	int	Pagineringsforskydning returneret.
`begrænse`	int	Pagineringsgrænse returneret.
`tælle`	int	Antal rækker returneret i `data`.
`data`	array	Liste over ubesvarede opkald.
`data[].nummer`	snor	Opkalderens telefonnummer.
`data[].navn`	snor	Navn på kontaktperson i cachelagret tilstand (kan være tomt).
`data[].dato`	snor	Formateret dato- og klokkeslætsstreng afledt af et tidsstempel i millisekunder.

Indgående/udgående felter

Felt	Type	Beskrivelse
`succes`	bool	Anmodningsstatus.
`apikey`	snor	Sendes tilbage af API (din nøgle).
`begrænse`	int	Rækker pr. side returneret.
`forskydning`	int	Pagineringsforskydning returneret.
`sorter_efter`	snor	Anvendt sorteringsfelt.
`sorteringsmappe`	snor	Anvendt sorteringsretning.
`filtre`	objekt	Ekkofiltre (`dato_fra_ms`, `dato_til_ms`, `q`).
`tælle`	int	Antal rækker returneret i `rækker`.
`rækker`	array	Liste over opkald.
`rækker[].telefonnummer`	snor	Telefonnummer.
`rækker[].cachelagret_navn`	streng\|nul	Cachelagret kontaktnavn (kan være null).
`rækker[].call_date_ms`	int	Opkaldstidsstempel i millisekunder.
`rækker[].call_datetime_utc`	snor	UTC-dato- og klokkeslætsfelt (database).
`rækker[].varighed_sek`	int	Varighed i sekunder.
`rækker[].geo_placering`	streng\|nul	Geografisk placeringsetiket (kan være tom/null).
`rækker[].oprettet_ved`	snor	Tidsstempel for serverindsættelse.

API og udviklerdokumenter

Værktøjer og ændringer log

Dokumentation af API til opkaldsstyring

Hurtigstart

Basis-URL

Eksempler

Autentificering

Almindelige begreber

Paginering

Tidsstempler

Søge

Sortering (kun indgående/udgående)

Fejl

Ubesvarede opkald – Liste

Slutpunkt

Forespørgselsparametre

Sortering

Eksempel på anmodning

Eksempel på svar

Indgående opkald – Liste

Slutpunkt

Forespørgselsparametre

Eksempel på anmodning

Eksempel på svar

Udgående opkald – Liste

Slutpunkt

Forespørgselsparametre

Eksempel på anmodning

Eksempel på svar

Felter for mistede opkald

Indgående/udgående felter

💬 Livechat tilgængelig