SMSMobileAPI – Puhelunhallinta-API:n dokumentaatio

Puhelunhallinta-API:n dokumentaatio

Näiden päätepisteiden avulla voit hakea Vastaamattomat puhelut, Saapuvat vastatut puhelut, ja Lähtevät puhelut synkronoitu SMSMobileAPI-mobiilisovelluksesta kojelautaasi + API:in.

Tärkeää: jos mobiilisovellus toimii taustalla, puhelinjärjestelmä saattaa aiheuttaa viiveen (usein jopa noin 10 minuuttia) synkronointien välillä. Voit aina avata sovelluksen synkronointia varten manuaalisesti tarvittaessa.

Tukea: api@smsmobileapi.com

Haku

Pika-aloitus

Perus-URL

SAADAhttps://api.smsmobileapi.com

Kaikki alla olevat päätepisteet on dokumentoitu seuraavasti: SAADA pyyntöjä. Korvaa YOUR_API_AVAIN oikealla avaimellasi (älä jaa sitä julkisesti).

Esimerkkejä


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


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


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

Todennus

Puheluidenhallinnan päätepisteet todennetaan käyttämällä apikey kyselyparametri.

Tilauksen vahvistus: Saapuvat/lähtevät päätepisteet vahvistavat API-avaimesi ja tarkistavat tilauksesi voimassaolon (perustuen päivämääräraja >= CURDATE()). Jos voimassaoloaika on umpeutunut, saat api_vanhentunutVastaamattomien puheluiden päätepiste saattaa palauttaa yleisen ”Puuttuva apikey” -virheen / palvelinvirheen olosuhteista riippuen.

Yleisiä käsitteitä

Sivunumerointi

Käyttää rajoittaa ja offset sivuttaaksesi tulokset.

Aikaleimat

puhelupäivämäärä_ms on UNIX-aikaleima millisekuntia.
puhelupäivämäärä_aika_UTC tallennetaan UTC-päivämäärä- ja aikamerkkijonona (tietokantakenttä).
Vastaamattomien puheluiden osalta API palauttaa muotoillun päivämäärä merkkijono (johdettu millisekuntiarvosta).

Haku

Vastaamattomat puhelut: haku vastaa numeroa tai nimeä.
Saapuva/Lähtevä: q vastaa phone_number- tai cached_name-arvoa.

Lajittelu (vain saapuvat/lähtevät)

Lajittelua ohjaa lajitteluperuste + lajitteluhakemisto (vain valkoisen listan kentät). Vastaamattomat puhelut järjestetään aina uusimmasta alkaen.

Virheet

HTTP	Esimerkkivirhe	Merkitys
400	`{"success":false,"error":"puuttuva_apiavain"}`	Puuttuu tai on tyhjä `apikey`.
403	`{"onnistui":false,"virhe":"virheellinen_apiavain"}`	API-avainta ei löydy / sitä ei tunnistettu.
403	`{"onnistui":false,"virhe":"api_vanhentunut"}`	Tilauksesi on vanhentunut (`päivämääräraja` on ennen tätä päivää).
500	`{"success":false,"error":"server_error","detail":"..."}`	Palvelinvirhe (tietokanta, SQL, poikkeus).

Huomautus: Vastaamattomien puheluiden päätepiste voi myös palauttaa viestejä, kuten Puuttuva apikey tai SQL-valmisteluvirheitä tilanteesta riippuen.

Vastaamattomat puhelut – Luettelo

Hae mobiililaitteesta synkronoidut vastaamattomat puhelut.

Päätepiste

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

Kyselyparametrit

Parametri	Tyyppi	Kuvaus
Pakollinen`apikey`	jono	Matkapuhelimeen linkitetty API-avaimesi.
Valinnainen`offset`	int	Sivutuksen siirtymä (oletus: `0`).
Valinnainen`rajoittaa`	int	Palautettavien rivien enimmäismäärä (oletus: `100`, maks.: `500`).
Valinnainen`haku`	jono	Hae numeron tai nimen perusteella (SQL LIKE).
Valinnainen`päivämäärän_aloitus`	VVVV-KK-PP	Suodata tästä päivästä (00:00:00). Verrattuna tallennettuun millisekuntiaikaleimaan.
Valinnainen`päivämäärän_loppu`	VVVV-KK-PP	Suodata tähän päivään asti (23:59:59). Verrattuna tallennettuun millisekuntiaikaleimaan.

Lajittelu

Korjattu: uusin ensin (JÄRJESTÄ päivämäärän MUKAAN LASKEVA).

Esimerkkipyyntö


HANKI 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

Esimerkkivastaus

{ "onnistuminen": true, "offset": 0, "limit": 100, "count": 2, "data": [ { "number": "+123470000000", "name": "Matti Meikäläinen", "date": "2026-02-24 12:49:39" }, { "number": "+123471111111", "name": "", "date": "2026-02-24 11:12:09" } ] }

Saapuvat puhelut – Luettelo

Hae saapuvat ja vastatut puhelut synkronoituna mobiililaitteesta.

Päätepiste

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

Kyselyparametrit

Parametri	Tyyppi	Kuvaus
Pakollinen`apikey`	jono	API-avaimesi. Vahvistettu tilausta vastaan (`päivämääräraja`).
Valinnainen`rajoittaa`	int	Riviä sivulla (oletus: `50`, min 1, max `200`).
Valinnainen`offset`	int	Sivutuksen siirtymä (oletus: `0`).
Valinnainen`lajitteluperuste`	jono	Lajittelukenttä (oletus: `puhelupäivämäärä_ms`). Sallittu: `puhelupäivämäärä_ms`, `puhelupäivämäärä_aika_UTC`, `kesto_sekuntia`, `puhelinnumero`, `luotu_paikalla`, `välimuistissa_ oleva_nimi`, `maantieteellinen_sijainti`.
Valinnainen`lajitteluhakemisto`	nouseva\|laskeva	Lajittelusuunta (oletus: `kuvaus`).
Valinnainen`päivämäärä_alkaen_ms`	kokonaisluku (ms)	Suodata missä `puhelupäivämäärä_ms >= soittopäivämäärä_ms`.
Valinnainen`päivämäärä_loppuun_ms`	kokonaisluku (ms)	Suodata missä `kutsupäivämäärä_ms <= päättymispäivämäärä_ms`.
Valinnainen`q`	jono	Hae (TYKKÄÄ) sivustolta `puhelinnumero` tai `välimuistissa_ oleva_nimi`.

Esimerkkipyyntö


HANKI 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

Esimerkkivastaus

{ "success": true, "apikey": "OMA_API_AVAIMESI", "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": "Belgia", "created_at": "2026-02-24 04:14:38" } } ] }

Lähtevät puhelut – Luettelo

Hae mobiililaitteesta synkronoidut lähtevät puhelut.

Päätepiste

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

Kyselyparametrit

Samat parametrit ja toiminta kuin Saapuvat puhelut -kohdassa.

Parametri	Tyyppi	Kuvaus
Pakollinen`apikey`	jono	API-avaimesi. Vahvistettu tilausta vastaan (`päivämääräraja`).
Valinnainen`rajoittaa`	int	Riviä sivulla (oletus: `50`, maks. `200`).
Valinnainen`offset`	int	Sivutuksen siirtymä (oletus: `0`).
Valinnainen`lajitteluperuste`	jono	Oletus `puhelupäivämäärä_ms`Sallittu: `puhelupäivämäärä_ms`, `puhelupäivämäärä_aika_UTC`, `kesto_sekuntia`, `puhelinnumero`, `luotu_paikalla`, `välimuistissa_ oleva_nimi`, `maantieteellinen_sijainti`.
Valinnainen`lajitteluhakemisto`	nouseva\|laskeva	Oletus `kuvaus`.
Valinnainen`päivämäärä_alkaen_ms`	kokonaisluku (ms)	Suodata tästä aikaleimasta (ms).
Valinnainen`päivämäärä_loppuun_ms`	kokonaisluku (ms)	Suodata tähän aikaleimaan (ms) asti.
Valinnainen`q`	jono	Hae sivustolta `puhelinnumero` tai `välimuistissa_ oleva_nimi`.

Esimerkkipyyntö


HANKI 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=17000000000000&date_to_ms=1700864000000

Esimerkkivastaus

{ "success": true, "apikey": "OMA_API_AVAIMESI", "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": "Belgia", "created_at": "2026-02-24 04:14:37" } ] }

Vastaamattomien puheluiden kentät

Ala	Tyyppi	Kuvaus
`menestys`	totuusarvo	Pyynnön tila.
`offset`	int	Sivutuksen siirtymä palautettu.
`rajoittaa`	int	Sivutusrajoitus palautettu.
`laskea`	int	Palautettujen rivien määrä `data`.
`data`	taulukko	Vastaamattomien puheluiden luettelo.
`data[].numero`	jono	Soittajan puhelinnumero.
`data[].nimi`	jono	Välimuistissa oleva yhteyshenkilön nimi (voi olla tyhjä).
`data[].päivämäärä`	jono	Muotoiltu päivämäärä ja kellonaika -merkkijono, joka on johdettu millisekuntien aikaleimasta.

Saapuvat/Lähtevät kentät

Ala	Tyyppi	Kuvaus
`menestys`	totuusarvo	Pyynnön tila.
`apikey`	jono	API (avaimesi) toistaa sen.
`rajoittaa`	int	Palautettujen rivien määrä sivua kohden.
`offset`	int	Sivutuksen siirtymä palautettu.
`lajitteluperuste`	jono	Lajittelukenttä käytössä.
`lajitteluhakemisto`	jono	Lajittelusuunta käytössä.
`suodattimet`	esine	Kaikusuodattimet (`päivämäärä_alkaen_ms`, `päivämäärä_loppuun_ms`, `q`).
`laskea`	int	Palautettujen rivien määrä `rivit`.
`rivit`	taulukko	Puheluluettelo.
`rivit[].puhelinnumero`	jono	Puhelinnumero.
`rivit[].välimuistissa_oleva_nimi`	merkkijono\|null	Välimuistissa oleva yhteyshenkilön nimi (voi olla tyhjä).
`rivit[].puhelupäivämäärä_ms`	int	Kutsun aikaleima millisekunteina.
`rivit[].kutsupäivämäärä_aika_utc`	jono	UTC-päivämäärä- ja aikakenttä (tietokanta).
`rivit[].kesto_sekuntia`	int	Kesto sekunteina.
`rivit[].geo_location`	merkkijono\|null	Maantieteellisen sijainnin tunniste (voi olla tyhjä/null).
`rivit[].luodtu_kohdassa`	jono	Palvelimen lisäyksen aikaleima.

API & Developer Docs

Työkalu- ja muutosloki

Puhelunhallinta-API:n dokumentaatio

Pika-aloitus

Perus-URL

Esimerkkejä

Todennus

Yleisiä käsitteitä

Sivunumerointi

Aikaleimat

Haku

Lajittelu (vain saapuvat/lähtevät)

Virheet

Vastaamattomat puhelut – Luettelo

Päätepiste

Kyselyparametrit

Lajittelu

Esimerkkipyyntö

Esimerkkivastaus

Saapuvat puhelut – Luettelo

Päätepiste

Kyselyparametrit

Esimerkkipyyntö

Esimerkkivastaus

Lähtevät puhelut – Luettelo

Päätepiste

Kyselyparametrit

Esimerkkipyyntö

Esimerkkivastaus

Vastaamattomien puheluiden kentät

Saapuvat/Lähtevät kentät

💬 Live-chat saatavilla