Versões comparadas

Versão Versão antiga 20 Nova versão Atual
Alterações feitas por

Former user

Leanderson Correia

Gravado em

Chave

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

/extrato/list-calls

Método que faz a listagem e aplica filtros no extrato de uso das APIs.

...

 

 

DESCRIÇÃO

Este método lista chamadas e chamadas gravadas com detalhes de tarifação e com link para o áudio.

ESTRUTURA DA URL

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

VERSÃO

1

MÉTODO

POST

PARÂMETROS

dataInicial obrigatório Data de início de pesquisa no formato "YmdHis"

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

mostrarPlayer opcional Mostra código do player em flash (s = Sim | n = Não)

numeroOrigem opcional Opção de filtro com o número de origem

numeroDestino 

opcional 

opcional Opção de filtro com o número de destino

getAllPins opcional Opção para listar todos os Produtos do cliente, essa funcionalidade somente funcionará caso o usuário seja um administrador conta (true, false) por default o valor será false

login opcional Opção para listar APENAS 1 (UM) Login do cliente, essa funcionalidade somente funcionará caso o usuário seja um administrador conta

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)

callerid opcional Código fornecido ao realizar uma chamada, código único por chamada

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

RETORNO

api Origem API que 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": [
        {
            "id": "0",
            "name": "0",
            "origin": "0",
            "idObjectTwo": "0",
            "nameObjectTwo": "0",
            "callerid": "XXXXXXXXXX",
            "campos_personalizados": [
                {
                    "id": "0"
                },
                {
                    "name": "0"
                },
                {
                    "origin": "0"
                },
                {
                    "idObjectTwo": "0"
                },
                {
                    "nameObjectTwo": "0"
                }
            ],
            "cliente": "SIGNALLINK INFORMATICA LTDA",
            "servico": "Directcall Software Web",
            "servico_codigo": "61",
            "login": "XXXXX",
            "
password
ramal": "
XXXXX
554135067890",
            "tipo": "Ligacao
normal
Normal",
            "origem_numero": "
554130175726
Telefone IP",
            "origem_
localidade
descricao": "
CURITIBA
013",
            "origem_
descricao
localidade": "
CURITIBA
Intrarede",
            "destino_numero": "
554199504077
5541987025214",
            "destino_localidade": "CELULAR - VC1 - REGIAO 41",
            "destino_descricao": "
MÓVEL BR COM CLI
CELULAR - VC1 - REGIAO 41",
            "data_inicio": "
2013
2025-
02
07-
20
24
17
09:
53
31:
54
12",
            "data_fim": "
2013
2025-
02
07-
20
24
17:53:54",
09:31:33",
            "duracao_original": "9",
            "duracao_cobrada": "60",
            "duracao": "9",
            "custo": "0.
1700
2251",
            "gravacao_link": Mostrará "null" ou o "link para o áudio da chamada gravada",
            "motivo_desligamento": "Ligação atendida",
            "motivo_desligamento_id": null,
            "tipo_rota": "CEL",
            "uuid_origem": null
        }
    ],
    "chamadas": 1,
    "paginas": 1,
    "custo": 0.2251,
    "custo_total": 1.1256,
    "duracao_total":
"2"  }

 

 

...

 9,
    "duracao_total_cobrada": 100
}

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.

...

 

 


getAllPins opcional Opção para listar todos os Produtos do cliente, essa funcionalidade somente funcionará caso o usuário seja um administrador conta (true, false) por default o valor será false