Chiamata di sviluppo documenti - SMSMobileAPI
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.

Hai bisogno di aiuto? api@smsmobileapi.com

Avvio rapido

URL di base

OTTENERE https://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
GET https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&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 (dateLimit >= CURDATE()). Se scaduto, riceverai api_scaduto.

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 fiammiferi numero_di_telefono O nome memorizzato nella cache.

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

OTTENERE https://api.smsmobileapi.com/call/missed/list/

Parametri di query

ParametroTipoDescrizione
apikeycordaNecessario La tua chiave API collegata al telefono cellulare.
offsetinternoOpzionale Offset di paginazione (predefinito: 0).
limiteinternoOpzionale Numero massimo di righe (predefinito: 100, massimo: 500).
ricercacordaOpzionale Cerca per numero o nome (SQL LIKE).
data_inizioAAAA-MM-GGOpzionale Filtra da questo giorno (00:00:00).
data_fineAAAA-MM-GGOpzionale Filtra fino a questo giorno (23:59:59).

Chiamate in arrivo – Elenco

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

Punto finale

OTTENERE https://api.smsmobileapi.com/call/incoming/list/

Parametri di query

ParametroTipoDescrizione
apikeycordaNecessario La tua chiave API (convalidata tramite abbonamento).
limiteinternoOpzionale Righe per pagina (predefinito: 50, massimo: 200).
offsetinternoOpzionale Offset di paginazione (predefinito: 0).
ordina_percorda Opzionale Consentito: data_di_chiamata_ms chiamata_data_ora_utc durata_sec numero_di_telefono creato_a nome memorizzato nella cache geo_localizzazione
ordina_dirasc|descOpzionale Predefinito: descrizione.
data_da_msintero (ms)Opzionale Filtra dove data_chiamata_ms >= data_da_ms.
data_a_msintero (ms)Opzionale Filtra dove data_chiamata_ms <= data_a_ms.
QcordaOpzionale Cerca su numero_di_telefono O nome memorizzato nella cache (COME).

Chiamate in uscita – Elenco

Recupera le chiamate in uscita sincronizzate dal dispositivo mobile.

Punto finale

OTTENERE https://api.smsmobileapi.com/call/outgoing/list/

Parametri di query

Stessi parametri e comportamento delle chiamate in arrivo.

ParametroTipoDescrizione
apikeycordaNecessario La tua chiave API (convalidata tramite abbonamento).
limiteinternoOpzionale Righe per pagina (predefinito: 50, massimo: 200).
offsetinternoOpzionale Offset di paginazione (predefinito: 0).
ordina_percorda Opzionale Consentito: data_di_chiamata_ms chiamata_data_ora_utc durata_sec numero_di_telefono creato_a nome memorizzato nella cache geo_localizzazione
ordina_dirasc|descOpzionale Predefinito: descrizione.
data_da_msintero (ms)Opzionale Filtra dove data_chiamata_ms >= data_da_ms.
data_a_msintero (ms)Opzionale Filtra dove data_chiamata_ms <= data_a_ms.
QcordaOpzionale Cerca su numero_di_telefono O nome memorizzato nella cache (COME).

Campi delle chiamate perse

CampoTipoDescrizione
successoboolStato della richiesta.
offsetinternoOffset di paginazione restituito.
limiteinternoLimite di paginazione restituito.
contareinternoNumero di righe restituite in dati.
dativettoreElenco delle chiamate perse.
dati[].numerocordaNumero di telefono del chiamante.
dati[].nomecordaNome del contatto memorizzato nella cache (potrebbe essere vuoto).
data[].datacordaStringa datetime formattata derivata da un timestamp in millisecondi.

Campi in entrata/in uscita

CampoTipoDescrizione
successoboolStato della richiesta.
apikeycordaRiportato indietro dall'API (la tua chiave).
limiteinternoRighe per pagina restituite.
offsetinternoOffset di paginazione restituito.
ordina_percordaCampo di ordinamento applicato.
ordina_dircordaDirezione di ordinamento applicata.
filtrioggettoFiltri eco (data_da_ms, data_a_ms, Q).
contareinternoNumero di righe restituite in righe.
righevettoreElenco delle chiamate.
righe[].numero_di_telefonocordaNumero di telefono.
righe[].nome_cachedstringa|nulloNome del contatto memorizzato nella cache (può essere nullo).
righe[].data_chiamata_msinternoTimestamp della chiamata in millisecondi.
righe[].call_datetime_utccordaCampo data/ora UTC (database).
righe[].durata_secinternoDurata in secondi.
righe[].geo_locationstringa|nulloEtichetta di geolocalizzazione (può essere nulla/vuota).
righe[].create_acordaTimestamp di inserimento del server.
Hai bisogno di aiuto? Contatto api@smsmobileapi.com
Suggerimento: non pubblicare mai la tua chiave API in screenshot, ticket o repository pubblici.
💬 Chat dal vivo
💬 Chat dal vivo disponibile
Hai domande o hai bisogno di assistenza?
Il nostro team è qui per aiutarti!
Inserisci il tuo indirizzo email
per aiutarci a dare seguito alla tua richiesta:
Pannello di controllo