/extrato/list-sms
Este método trata SMS enviado, faz a listagem e aplica filtros no extrato de uso da API que envia SMS.
NOTA: Para listar SMS recebido veja: Recebimento de SMS
| DESCRIÇÃO | Com este método lista-se SMS. |
| ESTRUTURA DA URL | https://api.directcallsoft.com/extrato/list-sms |
| VERSÃO | 1 |
| MÉTODO | POST |
| PARÂMETROS | dataInicial obrigatório Data de inicio de pesquisa no formato "YmdHis" dataFinal obrigatório Data final de pesquisa no formato "YmdHis" numeroOrigem opcional Opção de filtro com o numero de origem numeroDestino opcional Opção de filtro com o numero de destino access_token obrigatório Chave de acesso ao método, 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 pagina opcional 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. 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.O estorno de cada SMS depende de diversas variáveis, o que inclui a espera de resposta nas operadoras móveis, o que pode levar até 72h. Por default, caso essa opção não seja enviada, a API entenderá o parâmetro como msgEstornadas=n
|
| RETORNO | api Origem API que esta 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 Exemplo de resposta em JSON {
"api":"extrato",
"modulo":"extrato",
"status":"ok",
"codigo":"000",
"msg":[
{
"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
}
]
"paginas":"2"
}
|
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.