Documentación de la API de gestión de llamadas de SMSMobileAPI

Documentación de la API de gestión de llamadas

Estos puntos finales le permiten recuperar sus Llamadas perdidas, Llamadas entrantes contestadas, y Llamadas salientes sincronizado desde la aplicación móvil SMSMobileAPI a su panel de control + API.

Importante: Si la aplicación móvil se ejecuta en segundo plano, el sistema del teléfono puede tener un retraso (normalmente de hasta 10 minutos) entre sincronizaciones. Siempre puedes abrir la aplicación para sincronizar manualmente si es necesario.

Apoyo: api@smsmobileapi.com

Buscar

Inicio rápido

URL base

CONSEGUIRhttps://api.smsmobileapi.com

Todos los puntos finales a continuación están documentados como CONSEGUIR solicitudes. Reemplazar SU CLAVE DE API con tu clave real (no la compartas públicamente).

Ejemplos


OBTENER https://api.smsmobileapi.com/call/missed/list/?apikey=SU_CLAVE_API


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


OBTENER https://api.smsmobileapi.com/call/outgoing/list/?apikey=SU_CLAVE_API&q=3247&fecha_desde_ms=1700000000000&fecha_hasta_ms=1700864000000

Autenticación

Los puntos finales de gestión de llamadas se autentican mediante el clave de api parámetro de consulta.

Validación de suscripción: Los puntos finales entrantes y salientes validan su clave API y verifican la validez de su suscripción (según Fecha límite >= CURDATE()). Si está vencido, recibirás api_expiradaEl punto final de llamadas perdidas puede devolver un error genérico de “APIkey faltante” o de servidor según las condiciones.

Conceptos comunes

Paginación

Usar límite y compensar para paginar resultados.

Marcas de tiempo

fecha_de_llamada_ms es una marca de tiempo UNIX en milisegundos.
fecha_hora_utc_de_llamada se almacena como una cadena de fecha y hora UTC (campo de base de datos).
Para las llamadas perdidas, la API devuelve un formato fecha cadena (derivada de un valor de milisegundos).

Buscar

Llamadas perdidas: buscar coincide con el número o nombre.
Entrante/Saliente: q coincide con phone_number o cached_name.

Clasificación (solo entrante/saliente)

La clasificación está controlada por Ordenar por + directorio_de_ordenación (Solo campos permitidos). Las llamadas perdidas se ordenan de más recientes a más recientes.

Errores

HTTP	Ejemplo de error	Significado
400	`{"éxito":falso,"error":"falta_clave_de_api"}`	Falta o vacío `clave de api`.
403	`{"éxito":falso,"error":"clave_de_api_inválida"}`	Clave API no encontrada/no reconocida.
403	`{"éxito":falso,"error":"api_expired"}`	Su suscripción ha expirado (`límite de fecha` es anterior a hoy).
500	`{"éxito":falso,"error":"error_del_servidor","detalle":"..."}`	Error del servidor (base de datos, SQL, excepción).

Nota: el punto final de llamadas perdidas también puede devolver mensajes como Falta la clave API o errores de preparación de SQL según la situación.

Llamadas perdidas – Lista

Recuperar llamadas perdidas sincronizadas desde el dispositivo móvil.

Punto final

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

Parámetros de consulta

Parámetro	Tipo	Descripción
Requerido`clave de api`	cadena	Su clave API vinculada al teléfono móvil.
Opcional`compensar`	entero	Desplazamiento de paginación (predeterminado: `0`).
Opcional`límite`	entero	Máximo de filas a devolver (predeterminado: `100`, máximo: `500`).
Opcional`buscar`	cadena	Buscar por número o nombre (LIKE SQL).
Opcional`fecha_de_inicio`	AAAA-MM-DD	Filtro de este día (00:00:00). Comparado con la marca de tiempo en milisegundos almacenada.
Opcional`fecha_fin`	AAAA-MM-DD	Filtrado hasta el día de hoy (23:59:59). Comparado con la marca de tiempo de milisegundos almacenada.

Clasificación

Corregido: lo más nuevo primero (ORDENAR POR fecha DESC).

Ejemplo de solicitud


OBTENER 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

Ejemplo de respuesta

{ "éxito": verdadero, "desplazamiento": 0, "límite": 100, "conteo": 2, "datos": [ { "número": "+123470000000", "nombre": "John Doe", "fecha": "2026-02-24 12:49:39" }, { "número": "+123471111111", "nombre": "", "fecha": "2026-02-24 11:12:09" } ] }

Llamadas entrantes – Lista

Recuperar llamadas entrantes contestadas sincronizadas desde el dispositivo móvil.

Punto final

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

Parámetros de consulta

Parámetro	Tipo	Descripción
Requerido`clave de api`	cadena	Tu clave API. Validada con suscripción (`límite de fecha`).
Opcional`límite`	entero	Filas por página (predeterminado: `50`, mín. 1, máx. `200`).
Opcional`compensar`	entero	Desplazamiento de paginación (predeterminado: `0`).
Opcional`Ordenar por`	cadena	Campo de ordenamiento (predeterminado: `fecha_de_llamada_ms`). Permitido: `fecha_de_llamada_ms`, `fecha_hora_utc_de_llamada`, `duración_seg`, `número de teléfono`, `creado_en`, `nombre_en_caché`, `geo_ubicación`.
Opcional`directorio_de_ordenación`	ascendente\|descendente	Dirección de clasificación (predeterminada: `descripción`).
Opcional`fecha_desde_ms`	entero (ms)	Filtrar donde `fecha_de_llamada_ms >= fecha_desde_ms`.
Opcional`fecha_a_ms`	entero (ms)	Filtrar donde `fecha_de_llamada_ms <= fecha_a_ms`.
Opcional`q`	cadena	Buscar (ME GUSTA) en `número de teléfono` o `nombre_en_caché`.

Ejemplo de solicitud


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

Ejemplo de respuesta

{ "éxito": verdadero, "clave_de_api": "SU_CLAVE_DE_API", "límite": 100, "desplazamiento": 0, "ordenar_por": "fecha_de_llamada_ms", "directorio_de_ordenación": "desc", "filtros": { "fecha_desde_ms": nulo, "fecha_hasta_ms": nulo, "q": "+12347" }, "conteo": 2, "filas": [ { "número_de_teléfono": "+123470000000", "nombre_en_caché": "Matteo CSS", "fecha_de_llamada_ms": 1761233379000, "fecha_de_llamada_utc": "2026-02-23 12:49:39", "duración_seg": 440, "ubicación_geográfica": "Bélgica", "creado_en": "2026-02-24 04:14:38" } ] }

Llamadas salientes – Lista

Recuperar llamadas salientes sincronizadas desde el dispositivo móvil.

Punto final

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

Parámetros de consulta

Mismos parámetros y comportamiento que las llamadas entrantes.

Parámetro	Tipo	Descripción
Requerido`clave de api`	cadena	Tu clave API. Validada con suscripción (`límite de fecha`).
Opcional`límite`	entero	Filas por página (predeterminado: `50`, máximo `200`).
Opcional`compensar`	entero	Desplazamiento de paginación (predeterminado: `0`).
Opcional`Ordenar por`	cadena	Por defecto `fecha_de_llamada_ms`. Permitido: `fecha_de_llamada_ms`, `fecha_hora_utc_de_llamada`, `duración_seg`, `número de teléfono`, `creado_en`, `nombre_en_caché`, `geo_ubicación`.
Opcional`directorio_de_ordenación`	ascendente\|descendente	Por defecto `descripción`.
Opcional`fecha_desde_ms`	entero (ms)	Filtrar desde esta marca de tiempo (ms).
Opcional`fecha_a_ms`	entero (ms)	Filtrar hasta esta marca de tiempo (ms).
Opcional`q`	cadena	Buscar en `número de teléfono` o `nombre_en_caché`.

Ejemplo de solicitud


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

Ejemplo de respuesta

{ "éxito": verdadero, "clave_de_api": "SU_CLAVE_DE_API", "límite": 50, "desplazamiento": 0, "ordenar_por": "duración_seg", "directorio_de_ordenación": "desc", "filtros": { "fecha_desde_ms": "1700000000000", "fecha_hasta_ms": "1700864000000", "q": nulo }, "conteo": 1, "filas": [ { "número_de_teléfono": "+123490000000", "nombre_en_caché": nulo, "fecha_de_llamada_ms": 1761231000000, "fecha_de_llamada_utc": "2026-02-23 12:10:00", "duración_seg": 120, "ubicación_geográfica": "Bélgica", "creado_en": "2026-02-24 04:14:37" } ] }

Campos de llamadas perdidas

Campo	Tipo	Descripción
`éxito`	bool	Estado de la solicitud.
`compensar`	entero	Se devolvió el desplazamiento de paginación.
`límite`	entero	Límite de paginación devuelto.
`contar`	entero	Número de filas devueltas en `datos`.
`datos`	formación	Lista de llamadas perdidas.
`datos[].número`	cadena	Número de teléfono de la persona que llama.
`datos[].nombre`	cadena	Nombre del contacto en caché (puede estar vacío).
`datos[].fecha`	cadena	Cadena de fecha y hora formateada derivada de una marca de tiempo en milisegundos.

Campos de entrada/salida

Campo	Tipo	Descripción
`éxito`	bool	Estado de la solicitud.
`clave de api`	cadena	Reproducido por API (su clave).
`límite`	entero	Filas por página devueltas.
`compensar`	entero	Se devolvió el desplazamiento de paginación.
`Ordenar por`	cadena	Campo de ordenación aplicado.
`directorio_de_ordenación`	cadena	Dirección de clasificación aplicada.
`filtros`	objeto	Filtros de eco (`fecha_desde_ms`, `fecha_a_ms`, `q`).
`contar`	entero	Número de filas devueltas en `filas`.
`filas`	formación	Lista de llamadas.
`filas[].número_de_teléfono`	cadena	Número de teléfono.
`filas[].nombre_cached`	cadena\|nulo	Nombre del contacto en caché (puede ser nulo).
`filas[].call_date_ms`	entero	Marca de tiempo de llamada en milisegundos.
`filas[].call_datetime_utc`	cadena	Campo de fecha y hora UTC (base de datos).
`filas[].duración_seg`	entero	Duración en segundos.
`filas[].geo_ubicación`	cadena\|nulo	Etiqueta de ubicación geográfica (puede ser nula/vacía).
`filas[].creadas_en`	cadena	Marca de tiempo de inserción del servidor.

Documentación de API y para desarrolladores

Herramientas y registro de cambios

Documentación de la API de gestión de llamadas

Inicio rápido

URL base

Ejemplos

Autenticación

Conceptos comunes

Paginación

Marcas de tiempo

Buscar

Clasificación (solo entrante/saliente)

Errores

Llamadas perdidas – Lista

Punto final

Parámetros de consulta

Clasificación

Ejemplo de solicitud

Ejemplo de respuesta

Llamadas entrantes – Lista

Punto final

Parámetros de consulta

Ejemplo de solicitud

Ejemplo de respuesta

Llamadas salientes – Lista

Punto final

Parámetros de consulta

Ejemplo de solicitud

Ejemplo de respuesta

Campos de llamadas perdidas

Campos de entrada/salida

💬 Chat en vivo disponible