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.
¿Necesitar ayuda? api@smsmobileapi.com
Inicio rápido
URL base
CONSEGUIR https://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=YOUR_API_KEY&q=1555&date_from_ms=1700000000000&date_to_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 (Fecha límite >= CURDATE()). Si está vencido, recibirás api_expirada.
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 partidos número de teléfono o nombre_en_caché.
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 siempre de más reciente a más reciente.
Todos los ejemplos de respuesta en esta documentación son anónimoLas claves API, los números de teléfono y los nombres de contacto que se muestran a continuación son solo ejemplos.
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
CONSEGUIR https://api.smsmobileapi.com/call/missed/list/
Parámetros de consulta
| Parámetro | Tipo | Descripción |
|---|---|---|
| clave de api | cadena | Requerido Su clave API vinculada al teléfono móvil. |
| compensar | entero | Opcional Desplazamiento de paginación (predeterminado: 0). |
| límite | entero | Opcional Máximo de filas (predeterminado: 100, máximo: 500). |
| buscar | cadena | Opcional Buscar por número o nombre (LIKE SQL). |
| fecha_de_inicio | AAAA-MM-DD | Opcional Filtro de este día (00:00:00). |
| fecha_fin | AAAA-MM-DD | Opcional Filtrar hasta el día de hoy (23:59:59). |
Ejemplo de solicitud
OBTENER https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY&offset=0&limit=100
Ejemplo de respuesta JSON
{ "éxito": verdadero, "desplazamiento": 0, "límite": 100, "contador": 3, "datos": [ { "número": "+15551230001", "nombre": "", "fecha": "2026-03-20 16:12:28" }, { "número": "+15551230002", "nombre": "Alex Carter", "fecha": "2026-03-20 16:12:00" }, { "número": "+447700900123", "nombre": "Taylor Reed", "fecha": "2026-03-20 15:48:41" } ] }
Explicación de la respuesta
| Campo | Descripción |
|---|---|
| éxito | verdadero significa que la solicitud se procesó correctamente. |
| compensar | Desplazamiento de paginación devuelto por la API. |
| límite | Se ha aplicado un límite de paginación a la solicitud. |
| contar | Número de filas devueltas en datos. |
| datos | Matriz que contiene entradas de llamadas perdidas. |
| datos[].número | Número de teléfono de la persona que llama. |
| datos[].nombre | Nombre de contacto almacenado en caché. Puede estar vacío si no hay ningún nombre de contacto disponible. |
| datos[].fecha | Fecha y hora de la llamada formateadas. |
Los valores de ejemplo mostrados arriba están anonimizados. Las respuestas reales pueden contener números de teléfono y etiquetas de contacto diferentes.
Llamadas entrantes – Lista
Recuperar llamadas entrantes contestadas sincronizadas desde el dispositivo móvil.
Punto final
CONSEGUIR https://api.smsmobileapi.com/call/incoming/list/
Parámetros de consulta
| Parámetro | Tipo | Descripción |
|---|---|---|
| clave de api | cadena | Requerido Su clave API (validada contra suscripción). |
| límite | entero | Opcional Filas por página (predeterminado: 50, máximo: 200). |
| compensar | entero | Opcional Desplazamiento de paginación (predeterminado: 0). |
| Ordenar por | cadena | Opcional 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 |
| directorio_de_ordenación | ascendente|descendente | Opcional Por defecto: descripción. |
| fecha_desde_ms | entero (ms) | Opcional Filtrar donde fecha_de_llamada_ms >= fecha_desde_ms. |
| fecha_a_ms | entero (ms) | Opcional Filtrar donde fecha_de_llamada_ms <= fecha_a_ms. |
| q | cadena | Opcional Buscar en número de teléfono o nombre_en_caché (COMO). |
Ejemplo de solicitud
OBTENER https://api.smsmobileapi.com/call/incoming/list/?apikey=SU_CLAVE_API&limit=50&offset=0&sort_by=call_date_ms&sort_dir=desc
Ejemplo de respuesta JSON
{ "éxito": verdadero, "clave_api": "TU_HASH_DE_CLAVE_API", "límite": 50, "desplazamiento": 0, "ordenar_por": "fecha_llamada_ms", "ordenar_dir": "desc", "filtros": { "fecha_desde_ms": nulo, "fecha_hasta_ms": nulo, "q": nulo }, "conteo": 3, "filas": [ { "número_de_teléfono": "+15551230010", "nombre_en_caché": "Jordan Blake", "fecha_llamada_ms": 1774027779390, "fecha_hora_llamada_utc": "2026-03-20 17:29:39", "duración_seg": 23, "ubicación_geográfica": "Canadá", "creado_en": "2026-03-20 17:46:45" }, { "número_de_teléfono": "+15551230011", "cached_name": "Morgan Lee", "call_date_ms": 1774018268663, "call_datetime_utc": "2026-03-20 14:51:08", "duration_sec": 50, "geo_location": "Canada", "created_at": "2026-03-20 14:58:37" }, { "phone_number": "+447700900124", "cached_name": "Sam Parker", "call_date_ms": 1774011205123, "call_datetime_utc": "2026-03-20 12:53:25", "duration_sec": 92, "geo_location": "Canada", "created_at": "2026-03-20 12:59:01" } ] }
Explicación de la respuesta
| Campo | Descripción |
|---|---|
| éxito | verdadero significa que la solicitud se procesó correctamente. |
| clave de api | Valor de la clave API reflejado. En los ejemplos de la documentación, esto siempre debe estar enmascarado. |
| límite | Número de filas solicitadas por página. |
| compensar | Desplazamiento de paginación devuelto por la API. |
| Ordenar por | Campo de ordenación aplicado por la API. |
| directorio_de_ordenación | Dirección de ordenación aplicada por la API. |
| filtros | Objeto que contiene los filtros activos utilizados para la solicitud. |
| contar | Número de filas devueltas en filas. |
| filas | Matriz que contiene las entradas de llamadas respondidas entrantes. |
| filas[].número_de_teléfono | Número de teléfono vinculado a la llamada. |
| filas[].nombre_cached | Nombre de contacto almacenado en caché. Puede ser nulo o estar vacío según los datos disponibles. |
| filas[].call_date_ms | Marca de tiempo de llamada en milisegundos. |
| filas[].call_datetime_utc | Fecha y hora UTC de la llamada. |
| filas[].duración_seg | Duración de la llamada en segundos. |
| filas[].geo_ubicación | Etiqueta geográfica asociada al número, si está disponible. |
| filas[].creadas_en | Fecha y hora en que se insertó la fila en el servidor. |
La API puede reflejar su clave de api en la respuesta. En la documentación pública, capturas de pantalla y ejemplos, siempre ocúltelo.
Llamadas salientes – Lista
Recuperar llamadas salientes sincronizadas desde el dispositivo móvil.
Punto final
CONSEGUIR https://api.smsmobileapi.com/call/outgoing/list/
Parámetros de consulta
Mismos parámetros y comportamiento que las llamadas entrantes.
| Parámetro | Tipo | Descripción |
|---|---|---|
| clave de api | cadena | Requerido Su clave API (validada contra suscripción). |
| límite | entero | Opcional Filas por página (predeterminado: 50, máximo: 200). |
| compensar | entero | Opcional Desplazamiento de paginación (predeterminado: 0). |
| Ordenar por | cadena | Opcional 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 |
| directorio_de_ordenación | ascendente|descendente | Opcional Por defecto: descripción. |
| fecha_desde_ms | entero (ms) | Opcional Filtrar donde fecha_de_llamada_ms >= fecha_desde_ms. |
| fecha_a_ms | entero (ms) | Opcional Filtrar donde fecha_de_llamada_ms <= fecha_a_ms. |
| q | cadena | Opcional Buscar en número de teléfono o nombre_en_caché (COMO). |
Ejemplo de solicitud
OBTENER https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=call_date_ms&sort_dir=desc
Ejemplo de respuesta JSON
{ "éxito": verdadero, "clave_api": "TU_HASH_DE_CLAVE_API", "límite": 50, "desplazamiento": 0, "ordenar_por": "fecha_llamada_ms", "ordenar_dir": "desc", "filtros": { "fecha_desde_ms": nulo, "fecha_hasta_ms": nulo, "q": nulo }, "conteo": 3, "filas": [ { "número_de_teléfono": "+15551230020", "nombre_en_caché": "Casey Morgan", "fecha_llamada_ms": 1774025965645, "fecha_hora_llamada_utc": "2026-03-20 16:59:25", "duración_seg": 15, "ubicación_geográfica": "Canadá", "creado_en": "2026-03-20 17:17:58" }, { "número_de_teléfono": "+15551230021", "cached_name": "Taylor Brooks", "call_date_ms": 1774023172638, "call_datetime_utc": "2026-03-20 16:12:52", "duration_sec": 556, "geo_location": "Canada", "created_at": "2026-03-20 16:28:38" }, { "phone_number": "+33198765432", "cached_name": "Jamie Carter", "call_date_ms": 1774019040000, "call_datetime_utc": "2026-03-20 15:04:00", "duration_sec": 61, "geo_location": "Canada", "created_at": "2026-03-20 15:09:11" } ] }
Explicación de la respuesta
| Campo | Descripción |
|---|---|
| éxito | verdadero significa que la solicitud se procesó correctamente. |
| clave de api | Valor de la clave API reflejado. En los ejemplos de la documentación, esto siempre debe estar enmascarado. |
| límite | Número de filas solicitadas por página. |
| compensar | Desplazamiento de paginación devuelto por la API. |
| Ordenar por | Campo de ordenación aplicado por la API. |
| directorio_de_ordenación | Dirección de ordenación aplicada por la API. |
| filtros | Objeto que contiene los filtros activos utilizados para la solicitud. |
| contar | Número de filas devueltas en filas. |
| filas | Matriz que contiene las entradas de llamadas salientes. |
| filas[].número_de_teléfono | Número de teléfono vinculado a la llamada. |
| filas[].nombre_cached | Nombre de contacto almacenado en caché. Puede ser nulo o estar vacío según los datos disponibles. |
| filas[].call_date_ms | Marca de tiempo de llamada en milisegundos. |
| filas[].call_datetime_utc | Fecha y hora UTC de la llamada. |
| filas[].duración_seg | Duración de la llamada en segundos. |
| filas[].geo_ubicación | Etiqueta geográfica asociada al número, si está disponible. |
| filas[].creadas_en | Fecha y hora en que se insertó la fila en el servidor. |
Los valores de ejemplo anteriores están anonimizados. Reemplácelos con sus propios datos reales únicamente en herramientas privadas/internas, nunca en la documentación pública.
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 | Devuelto por la API (tu clave). En la documentación pública, enmascárala siempre. |
| 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. |
English 
French 
German 
Spanish 
Portuguese 
Russian 
Finnish 
Japanese 
Chinese 
Vietnamese 
Dutch 
Greek 
Arabic 
Danish 
Italian 
Ukrainian