Chamada para desenvolvedores de documentos - SMSMobileAPI
SMSMobileAPI – Documentação da API de Gerenciamento de Chamadas

Início rápido

URL base

PEGAR https://api.smsmobileapi.com
Todos os endpoints abaixo estão documentados como PEGAR solicitações. Substituir SUA_CHAVE_API Com sua chave verdadeira (não a compartilhe publicamente).

Exemplos

GET https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY
GET https://api.smsmobileapi.com/call/incoming/list/?apikey=YOUR_API_KEY&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=1555&date_from_ms=1700000000000&date_to_ms=1700864000000

Autenticação

Os endpoints de gerenciamento de chamadas autenticam-se usando o apikey parâmetro de consulta.

Validação da assinatura: Os endpoints de entrada/saída validam sua chave de API e verificam a validade da sua assinatura (dateLimit >= CURDATE()Se expirado, você receberá api_expirado.

Conceitos comuns

Paginação

Usar limite e desvio Para paginar os resultados.

Carimbos de data/hora

  • data_da_chamada_ms é um timestamp UNIX em milissegundos.
  • call_datetime_utc é armazenado como uma string de data e hora UTC (campo do banco de dados).
  • Para chamadas perdidas, a API retorna um valor formatado. data string (derivada de um valor em milissegundos).

Procurar

  • Chamadas perdidas: procurar Corresponde ao número ou nome.
  • Entrada/Saída: q partidas número_de_telefone ou nome_em_cache.

Triagem (somente entrada/saída)

A classificação é controlada por ordenar por + diretório_de_ordenar (Apenas campos permitidos). As chamadas perdidas são sempre ordenadas da mais recente para a mais antiga.

Todos os exemplos de resposta nesta documentação são anonimizadoAs chaves de API, números de telefone e nomes de contato mostrados abaixo são apenas exemplos.

Erros

HTTP Exemplo de erro Significado
400 {"success":false,"error":"missing_apikey"} Ausente ou vazio apikey.
403 {"success":false,"error":"invalid_apikey"} Chave de API não encontrada/não reconhecida.
403 {"success":false,"error":"api_expired"} Sua assinatura expirou (limite de data é anterior a hoje).
500 {"success":false,"error":"server_error","detail":"..."} Erro do servidor (banco de dados, SQL, exceção).

Observação: o endpoint de Chamadas Perdidas também pode retornar mensagens como Chave de API ausente ou erros de preparação de SQL, dependendo da situação.

Lista de chamadas perdidas

Recuperar chamadas perdidas sincronizadas do dispositivo móvel.

Ponto final

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

Parâmetros de consulta

ParâmetroTipoDescrição
apikeycordaObrigatório Sua chave de API está vinculada ao celular.
desviointeiroOpcional Deslocamento de paginação (padrão: 0).
limiteinteiroOpcional Número máximo de linhas (padrão: 100, máximo: 500).
procurarcordaOpcional Pesquisa por número ou nome (SQL LIKE).
data_inícioAAAA-MM-DDOpcional Filtrar a partir deste dia (00:00:00).
data_fimAAAA-MM-DDOpcional Filtrar até este dia (23:59:59).

Exemplo de solicitação

GET https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY&offset=0&limit=100

Exemplo de resposta JSON

{ "success": true, "offset": 0, "limit": 100, "count": 3, "data": [ { "number": "+15551230001", "name": "", "date": "2026-03-20 16:12:28" }, { "number": "+15551230002", "name": "Alex Carter", "date": "2026-03-20 16:12:00" }, { "number": "+447700900123", "name": "Taylor Reed", "date": "2026-03-20 15:48:41" } ] }

Explicação da resposta

CampoDescrição
sucessoverdadeiro Significa que a solicitação foi processada com sucesso.
desvioDeslocamento de paginação retornado pela API.
limiteLimite de paginação aplicado à solicitação.
contarNúmero de linhas retornadas em dados.
dadosMatriz contendo registros de chamadas perdidas.
dados[].númeroNúmero de telefone do chamador.
data[].nameNome de contato armazenado em cache. Pode estar vazio se nenhum nome de contato estiver disponível.
data[].dataData e hora da chamada formatadas.
Os valores de exemplo acima foram anonimizados. Respostas reais podem conter números de telefone e rótulos de contato diferentes.

Lista de chamadas recebidas

Recuperar chamadas recebidas e atendidas, sincronizadas a partir do dispositivo móvel.

Ponto final

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

Parâmetros de consulta

ParâmetroTipoDescrição
apikeycordaObrigatório Sua chave de API (validada em relação à assinatura).
limiteinteiroOpcional Linhas por página (padrão: 50, máximo: 200).
desviointeiroOpcional Deslocamento de paginação (padrão: 0).
ordenar porcorda Opcional Permitido: data_da_chamada_ms call_datetime_utc duração_segundos número_de_telefone criado_em nome_em_cache geolocalização
diretório_de_ordenarasc|descOpcional Padrão: descrição.
data_de_msint (ms)Opcional Filtrar onde data_de_chamada_ms >= data_de_origem_ms.
data_para_msint (ms)Opcional Filtrar onde data_da_chamada_ms <= data_para_ms.
qcordaOpcional Pesquisar em número_de_telefone ou nome_em_cache (COMO).

Exemplo de solicitação

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

Exemplo de resposta JSON

{ "success": true, "apikey": "YOUR_API_KEY_HASH", "limit": 50, "offset": 0, "sort_by": "call_date_ms", "sort_dir": "desc", "filters": { "date_from_ms": null, "date_to_ms": null, "q": null }, "count": 3, "rows": [ { "phone_number": "+15551230010", "cached_name": "Jordan Blake", "call_date_ms": 1774027779390, "call_datetime_utc": "2026-03-20 17:29:39", "duration_sec": 23, "geo_location": "Canada", "created_at": "2026-03-20 17:46:45" }, { "phone_number": "+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" } ] }

Explicação da resposta

CampoDescrição
sucessoverdadeiro Significa que a solicitação foi processada com sucesso.
apikeyValor da chave da API reproduzido. Nos exemplos da documentação, esse valor deve sempre ser ocultado.
limiteNúmero de linhas solicitadas por página.
desvioDeslocamento de paginação retornado pela API.
ordenar porCampo de ordenação aplicado pela API.
diretório_de_ordenarDireção de ordenação aplicada pela API.
filtrosObjeto contendo os filtros ativos usados na solicitação.
contarNúmero de linhas retornadas em linhas.
linhasMatriz contendo registros de chamadas recebidas e atendidas.
linhas[].número_de_telefoneNúmero de telefone associado à chamada.
linhas[].nome_em_cacheNome do contato armazenado em cache. Pode ser nulo ou vazio, dependendo dos dados disponíveis.
linhas[].call_date_msRegistro de data e hora da chamada em milissegundos.
linhas[].call_datetime_utcData e hora UTC da chamada.
linhas[].duração_segDuração da chamada em segundos.
linhas[].geo_localizaçãoEtiqueta geográfica associada ao número, se disponível.
linhas[].criadas_emData e hora em que a linha foi inserida no servidor.
A API pode reproduzir o seu apikey na resposta. Em documentação pública, capturas de tela e exemplos, sempre oculte-o.

Lista de chamadas efetuadas

Recuperar chamadas efetuadas e sincronizadas do dispositivo móvel.

Ponto final

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

Parâmetros de consulta

Os parâmetros e o comportamento são os mesmos das chamadas recebidas.

ParâmetroTipoDescrição
apikeycordaObrigatório Sua chave de API (validada em relação à assinatura).
limiteinteiroOpcional Linhas por página (padrão: 50, máximo: 200).
desviointeiroOpcional Deslocamento de paginação (padrão: 0).
ordenar porcorda Opcional Permitido: data_da_chamada_ms call_datetime_utc duração_segundos número_de_telefone criado_em nome_em_cache geolocalização
diretório_de_ordenarasc|descOpcional Padrão: descrição.
data_de_msint (ms)Opcional Filtrar onde data_de_chamada_ms >= data_de_origem_ms.
data_para_msint (ms)Opcional Filtrar onde data_da_chamada_ms <= data_para_ms.
qcordaOpcional Pesquisar em número_de_telefone ou nome_em_cache (COMO).

Exemplo de solicitação

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

Exemplo de resposta JSON

{ "success": true, "apikey": "YOUR_API_KEY_HASH", "limit": 50, "offset": 0, "sort_by": "call_date_ms", "sort_dir": "desc", "filters": { "date_from_ms": null, "date_to_ms": null, "q": null }, "count": 3, "rows": [ { "phone_number": "+15551230020", "cached_name": "Casey Morgan", "call_date_ms": 1774025965645, "call_datetime_utc": "2026-03-20 16:59:25", "duration_sec": 15, "geo_location": "Canada", "created_at": "2026-03-20 17:17:58" }, { "phone_number": "+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" } ] }

Explicação da resposta

CampoDescrição
sucessoverdadeiro Significa que a solicitação foi processada com sucesso.
apikeyValor da chave da API reproduzido. Nos exemplos da documentação, esse valor deve sempre ser ocultado.
limiteNúmero de linhas solicitadas por página.
desvioDeslocamento de paginação retornado pela API.
ordenar porCampo de ordenação aplicado pela API.
diretório_de_ordenarDireção de ordenação aplicada pela API.
filtrosObjeto contendo os filtros ativos usados na solicitação.
contarNúmero de linhas retornadas em linhas.
linhasMatriz contendo entradas de chamadas efetuadas.
linhas[].número_de_telefoneNúmero de telefone associado à chamada.
linhas[].nome_em_cacheNome do contato armazenado em cache. Pode ser nulo ou vazio, dependendo dos dados disponíveis.
linhas[].call_date_msRegistro de data e hora da chamada em milissegundos.
linhas[].call_datetime_utcData e hora UTC da chamada.
linhas[].duração_segDuração da chamada em segundos.
linhas[].geo_localizaçãoEtiqueta geográfica associada ao número, se disponível.
linhas[].criadas_emData e hora em que a linha foi inserida no servidor.
Os valores de exemplo acima foram anonimizados. Substitua-os por seus próprios dados reais somente em ferramentas privadas/internas, nunca em documentação pública.

campos de chamadas perdidas

CampoTipoDescrição
sucessobooleanoStatus da solicitação.
desviointeiroDeslocamento de paginação retornado.
limiteinteiroLimite de paginação retornado.
contarinteiroNúmero de linhas retornadas em dados.
dadosvariedadeLista de chamadas perdidas.
dados[].númerocordaNúmero de telefone do chamador.
data[].namecordaNome do contato em cache (pode estar vazio).
data[].datacordaCadeia de data e hora formatada derivada de um registro de data e hora em milissegundos.

Campos de entrada/saída

CampoTipoDescrição
sucessobooleanoStatus da solicitação.
apikeycordaRetorno fornecido pela API (sua chave). Em documentação pública, sempre oculte-a.
limiteinteiroNúmero de linhas retornadas por página.
desviointeiroDeslocamento de paginação retornado.
ordenar porcordaCampo de classificação aplicado.
diretório_de_ordenarcordaDireção de classificação aplicada.
filtrosobjetoFiltros com eco (data_de_ms, data_para_ms, q).
contarinteiroNúmero de linhas retornadas em linhas.
linhasvariedadeLista de chamadas.
linhas[].número_de_telefonecordaNúmero de telefone.
linhas[].nome_em_cachestring|nuloNome do contato em cache (pode ser nulo).
linhas[].call_date_msinteiroRegistro de data e hora da chamada em milissegundos.
linhas[].call_datetime_utccordaCampo de data e hora UTC (banco de dados).
linhas[].duração_seginteiroDuração em segundos.
linhas[].geo_localizaçãostring|nuloRótulo de geolocalização (pode ser nulo/vazio).
linhas[].criadas_emcordaCarimbo de data/hora de inserção do servidor.
💬 Bate-papo ao vivo
💬 Chat ao vivo disponível
Tem alguma dúvida ou precisa de ajuda?
Nossa equipe está aqui para ajudar você!

Digite seu endereço de e-mail
para nos ajudar a dar seguimento à sua solicitação:
Painel