Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

https://api.directcallsoft.com/extrato/list-sms

Este método lista SMS enviado ou recebido com dados de tarifação.

Veja também: Envio de SMS, Callback para receber status automaticoRecebimento de SMS, Callback para receber mensagens automaticoRecebimento de SMS, histórico de SMS Recebido x Enviado no estilo Chat

...

 

DESCRIÇÃO

Este método lista SMS enviado ou recebido, com dados de tarifação.

ESTRUTURA DA URL

https://api.directcallsoft.com/extrato/list-sms

VERSÃO

1

MÉTODO

POST

PARÂMETROS

dataInicial obrigatório Data de

inicio

início de pesquisa no formato "YmdHis"

dataFinal obrigatório Data final de pesquisa no formato "YmdHis"

numeroOrigem opcional Opção de filtro com o

numero

número de origem

numeroDestino 

opcional 

opcional Opção de filtro com o

numero

número de destino

access_token obrigatório Chave de acesso ao método

, para

. Para saber como obter, clique aqui

formato opcional Opção de retorno da API, podendo ser JSON ou XML

,

(se não informado, JSON será o padrão)

paginaopcional Número da página (se omitido, será mostrada a primeira página)

msgEstornadas opcional Este parâmetro é útil

somente

para

a modalidade de SMS com short number.

casos de falha no envio do sms para rede publica, Se este parâmetro for utilizado (ex. msgEstornadas = s), a API listará

inclusive

os SMS que

tiver sido estornado e o motivo da não entrega

foram estornados. O estorno de cada SMS

depende de diversas variáveis

ocorre caso algum servidor ou aplicação Directcall falhe no envio do SMS para rede publica, o que

inclui a espera de resposta nas operadoras móveis, o que

pode levar até

72h

48h. Por default, caso essa opção não seja enviada, a API entenderá o parâmetro como msgEstornadas=n.

tipo opcional Tipo do SMS utilizar tipo = r para mensagens recebidas, tipo = v para Mensagens de Voz e tipo = e para mensagens enviadas, por padrão retornará as mensagens enviadas e mensagens recebidas.

RETORNO

api Origem API que

esta

está sendo usada

modulo Módulo que está sendo chamado

status Mensagem de status

codigo Código de retorno - Clique aqui para listar os códigos e suas descrições

msg Array de resposta da API

paginas Quantidade de páginas

Bloco de códigotitle

Exemplo de resposta em JSON
Bloco de código
{
   "api":"extrato",
   "modulo":"extrato",
   "status":"ok",
   "codigo":"000",
   "msg":[
      {
         "callerid":"xxxxxxxxxxxx",
         "cliente":"SIGNALLINK INFORMATICA LTDA",
         "servico":"Directcall Software Web",
         "login":"XXXXX",
         "password":"XXXXX",
         "tipo":"SMS",
         "origem_numero":"554130175726",
         "origem_localidade":"CURITIBA",
         "destino_numero":"554199504077",
         "destino_localidade":"CELULAR - VC1 - REGIAO 41",
         "data_inicio":"2013-02-20 17:53:54",
         "data_fim":"2013-02-20 17:53:54",
         "duracao":"60",
         "status_sms": "XXXXX - Message XXXXX",
         "custo":"0.1700",
         "gravacao_link":null,
         "text_sms":"TEXTO DO SMS ENVIADO",
         "uuid_origem":"xxxxxxxxxxxx"
      }
   ]
   "paginas":"2"
}
 

 

Informações

...

Validade dos tokens: Os tokens de acesso têm uma validade limitada, por isso convém que o sistema criado tenha em conta estes timings para que possa desenvolver rotinas de requisação de novos tokens.

...