SMSMobileAPI – Documentazione API per la gestione delle chiamate

Documentazione API di gestione delle chiamate

Questi endpoint ti consentono di recuperare il tuo Chiamate perse, Chiamate in arrivo risposte, E Chiamate in uscita sincronizzato dall'app mobile SMSMobileAPI nella tua dashboard + API.

Importante: se l'app mobile è in esecuzione in background, il sistema telefonico potrebbe imporre un ritardo (spesso fino a circa 10 minuti) tra le sincronizzazioni. Puoi sempre aprire l'app per sincronizzare manualmente, se necessario.

Supporto: api@smsmobileapi.com

Ricerca

Avvio rapido

URL di base

OTTENEREhttps://api.smsmobileapi.com

Tutti gli endpoint sottostanti sono documentati come OTTENERE richieste. Sostituisci LA TUA_CHIAVE_API con la tua vera chiave (non condividerla pubblicamente).

Esempi


OTTIENI https://api.smsmobileapi.com/call/missed/list/?apikey=LA_TUA_CHIAVE_API


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


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

Autenticazione

Gli endpoint di gestione delle chiamate si autenticano utilizzando apikey parametro di query.

Validazione dell'abbonamento: Gli endpoint in entrata/uscita convalidano la tua chiave API e controllano la validità del tuo abbonamento (in base a dateLimit >= CURDATE()). Se scaduto, riceverai api_scadutoL'endpoint delle chiamate perse potrebbe restituire un errore generico "Missing apikey" / server a seconda delle condizioni.

Concetti comuni

Paginazione

Utilizzo limite E offset per impaginare i risultati.

Timestamp

data_di_chiamata_ms è un timestamp UNIX in millisecondi.
chiamata_data_ora_utc viene memorizzato come stringa data/ora UTC (campo del database).
Per le chiamate perse, l'API restituisce un formato data stringa (derivata da un valore in millisecondi).

Ricerca

Chiamate perse: ricerca corrisponde al numero o al nome.
In entrata/in uscita: Q corrisponde a phone_number o cached_name.

Ordinamento (solo in entrata/in uscita)

L'ordinamento è controllato da ordina_per + ordina_dir (solo campi nella whitelist). Le chiamate perse sono sempre ordinate dalla più recente alla più recente.

Errori

HTTP	Errore di esempio	Senso
400	`{"success":false,"error":"missing_apikey"}`	Mancante o vuoto `apikey`.
403	`{"success":false,"error":"invalid_apikey"}`	Chiave API non trovata/non riconosciuta.
403	`{"success":false,"error":"api_expired"}`	Il tuo abbonamento è scaduto (`datalimite` è prima di oggi).
500	`{"success":false,"error":"server_error","detail":"..."}`	Errore del server (database, SQL, eccezione).

Nota: l'endpoint Chiamate perse può anche restituire messaggi come APIKEY mancante o errori di preparazione SQL a seconda della situazione.

Chiamate perse – Elenco

Recupera le chiamate perse sincronizzate dal dispositivo mobile.

Punto finale

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

Parametri di query

Parametro	Tipo	Descrizione
Necessario`apikey`	corda	La tua chiave API collegata al telefono cellulare.
Opzionale`offset`	interno	Offset di paginazione (predefinito: `0`).
Opzionale`limite`	interno	Numero massimo di righe da restituire (predefinito: `100`, massimo: `500`).
Opzionale`ricerca`	corda	Cerca per numero o nome (SQL LIKE).
Opzionale`data_inizio`	AAAA-MM-GG	Filtro da questo giorno (00:00:00). Confrontato con il timestamp in millisecondi memorizzato.
Opzionale`data_fine`	AAAA-MM-GG	Filtra fino a questo giorno (23:59:59). Confrontato con il timestamp in millisecondi memorizzato.

Ordinamento

Corretto: prima il più recente (ORDINA PER data DESC).

Esempio di richiesta


OTTIENI https://api.smsmobileapi.com/call/missed/list/?apikey=TUA_CHIAVE_API&limit=100&offset=0&search=John&date_start=2026-02-01&date_end=2026-02-24

Esempio di risposta

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

Chiamate in arrivo – Elenco

Recupera le chiamate in arrivo e risposte sincronizzate dal dispositivo mobile.

Punto finale

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

Parametri di query

Parametro	Tipo	Descrizione
Necessario`apikey`	corda	La tua chiave API. Convalidata con l'abbonamento (`datalimite`).
Opzionale`limite`	interno	Righe per pagina (predefinito: `50`, minimo 1, massimo `200`).
Opzionale`offset`	interno	Offset di paginazione (predefinito: `0`).
Opzionale`ordina_per`	corda	Campo di ordinamento (predefinito: `data_di_chiamata_ms`). Consentito: `data_di_chiamata_ms`, `chiamata_data_ora_utc`, `durata_sec`, `numero_di_telefono`, `creato_a`, `nome memorizzato nella cache`, `geo_localizzazione`.
Opzionale`ordina_dir`	asc\|desc	Direzione di ordinamento (predefinita: `descrizione`).
Opzionale`data_da_ms`	intero (ms)	Filtra dove `data_chiamata_ms >= data_da_ms`.
Opzionale`data_a_ms`	intero (ms)	Filtra dove `data_chiamata_ms <= data_a_ms`.
Opzionale`Q`	corda	Cerca (MI PIACE) su `numero_di_telefono` O `nome memorizzato nella cache`.

Esempio di richiesta


OTTIENI https://api.smsmobileapi.com/call/incoming/list/?apikey=TUA_CHIAVE_API&limit=100&offset=0&sort_by=call_date_ms&sort_dir=desc&q=3247

Esempio di risposta

{ "success": true, "apikey": "TUA_CHIAVE_API", "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" } ] }

Chiamate in uscita – Elenco

Recupera le chiamate in uscita sincronizzate dal dispositivo mobile.

Punto finale

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

Parametri di query

Stessi parametri e comportamento delle chiamate in arrivo.

Parametro	Tipo	Descrizione
Necessario`apikey`	corda	La tua chiave API. Convalidata con l'abbonamento (`datalimite`).
Opzionale`limite`	interno	Righe per pagina (predefinito: `50`, massimo `200`).
Opzionale`offset`	interno	Offset di paginazione (predefinito: `0`).
Opzionale`ordina_per`	corda	Predefinito `data_di_chiamata_ms`. Consentito: `data_di_chiamata_ms`, `chiamata_data_ora_utc`, `durata_sec`, `numero_di_telefono`, `creato_a`, `nome memorizzato nella cache`, `geo_localizzazione`.
Opzionale`ordina_dir`	asc\|desc	Predefinito `descrizione`.
Opzionale`data_da_ms`	intero (ms)	Filtra da questo timestamp (ms).
Opzionale`data_a_ms`	intero (ms)	Filtra fino a questo timestamp (ms).
Opzionale`Q`	corda	Cerca su `numero_di_telefono` O `nome memorizzato nella cache`.

Esempio di richiesta


OTTIENI https://api.smsmobileapi.com/call/outgoing/list/?apikey=TUA_CHIAVE_API&limit=50&offset=0&sort_by=duration_sec&sort_dir=desc&date_from_ms=1700000000000&date_to_ms=1700864000000

Esempio di risposta

{ "success": true, "apikey": "TUA_CHIAVE_API", "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" } ] }

Campi delle chiamate perse

Campo	Tipo	Descrizione
`successo`	bool	Stato della richiesta.
`offset`	interno	Offset di paginazione restituito.
`limite`	interno	Limite di paginazione restituito.
`contare`	interno	Numero di righe restituite in `dati`.
`dati`	vettore	Elenco delle chiamate perse.
`dati[].numero`	corda	Numero di telefono del chiamante.
`dati[].nome`	corda	Nome del contatto memorizzato nella cache (potrebbe essere vuoto).
`data[].data`	corda	Stringa datetime formattata derivata da un timestamp in millisecondi.

Campi in entrata/in uscita

Campo	Tipo	Descrizione
`successo`	bool	Stato della richiesta.
`apikey`	corda	Riportato indietro dall'API (la tua chiave).
`limite`	interno	Righe per pagina restituite.
`offset`	interno	Offset di paginazione restituito.
`ordina_per`	corda	Campo di ordinamento applicato.
`ordina_dir`	corda	Direzione di ordinamento applicata.
`filtri`	oggetto	Filtri eco (`data_da_ms`, `data_a_ms`, `Q`).
`contare`	interno	Numero di righe restituite in `righe`.
`righe`	vettore	Elenco delle chiamate.
`righe[].numero_di_telefono`	corda	Numero di telefono.
`righe[].nome_cached`	stringa\|nullo	Nome del contatto memorizzato nella cache (può essere nullo).
`righe[].data_chiamata_ms`	interno	Timestamp della chiamata in millisecondi.
`righe[].call_datetime_utc`	corda	Campo data/ora UTC (database).
`righe[].durata_sec`	interno	Durata in secondi.
`righe[].geo_location`	stringa\|nullo	Etichetta di geolocalizzazione (può essere nulla/vuota).
`righe[].create_a`	corda	Timestamp di inserimento del server.

API e documentazione per sviluppatori

Registro strumenti e modifiche

Documentazione API di gestione delle chiamate

Avvio rapido

URL di base

Esempi

Autenticazione

Concetti comuni

Paginazione

Timestamp

Ricerca

Ordinamento (solo in entrata/in uscita)

Errori

Chiamate perse – Elenco

Punto finale

Parametri di query

Ordinamento

Esempio di richiesta

Esempio di risposta

Chiamate in arrivo – Elenco

Punto finale

Parametri di query

Esempio di richiesta

Esempio di risposta

Chiamate in uscita – Elenco

Punto finale

Parametri di query

Esempio di richiesta

Esempio di risposta

Campi delle chiamate perse

Campi in entrata/in uscita

💬 Chat dal vivo disponibile