API - Consultar Registro Detalhado de Chamada (CDR)

Owned by Lucas Castro
Last updated: Mar 09, 2017
2 min read

Para utilizar a API é necessário um Token de API.


API URL/api/v1/cdr/{uuid}
MethodGET

Esta API consulta o registro detalhado de uma chamada de acordo com seu UUID.

A API responde uma mensagem em formato JSON.

Parâmetros

tokenToken de autenticação da API

Retorno

uuidIdentificador na central telefônica
idIdentificador no Evolux
statusStatus de desligamento
callerid_numberNúmero de origem
callerid_nameNome de origem
did_numberNúmero DDR
destination_numberNúmero de destino
start_timeHorário de início (ISO-8601)
answer_timeHorário de atendimento (ISO-8601)
end_timeHorário término (ISO-8601)
durationDuração em segundos
recording hrefCaminho para a gravação
call_typeTipo da chamada
cityCidade
stateEstado
trunk_nameNome do tronco
codecCodec de áudio
callgroupGrupo de ramal
accountcodeCódigo de bilhetagem


Exemplos de requisição

GET

https://example.evolux.net.br/api/cdr/<UUID>?token=<API_TOKEN>

GET

https://example.evolux.net.br/api/v1/cdr/a640b288-ab0c-4c02-cc1d-ef1eb5fdfc42&token=23598db235ba7293572395d87c2a35

cURL

curl --get --data "token=23598db235ba7293572395d87c2a35" https://loggi.cloud.evolux.net.br/api/v1/cdr/a640b288-ab0c-4c02-cc1d-ef1eb5fdfc42

Exemplos de respostas

Sucesso

{
   "meta" : {
      "message" : "OK",
      "status" : 200
   },
   "data" : {
      "callgroup" : "administrativo",
      "uuid" : "a640b288-ab0c-4c02-cc1d-ef1eb5fdfc42",
      "did_number" : null,
      "destination_number" : "2122224444",
      "status" : "NORMAL_CLEARING(16)",
      "id" : 3335555,
      "callerid_name" : "Rodrigo Amorim",
      "trunk_name" : "Embratel",
      "end_time" : "2017-03-09T11:37:07",
      "recording" : {
         "href" : "https://example.evolux.net.br/api/v1/recording/a640b288-ab0c-4c02-cc1d-ef1eb5fdfc42"
      },
      "city" : "RIO DE JANEIRO",
      "codec" : "opus",
      "call_type" : "external_out",
      "state" : "RJ",
      "callerid_number" : "9000",
      "accountcode" : "administrativo",
      "answer_time" : "2017-03-09T11:30:52",
      "start_time" : "2017-03-09T11:30:16",
      "duration" : 375
   }
}

Falhas

{"meta": {"status": 400, "message": "Missing token."}}
{"meta": {"status": 404, "message": "CDR not found."}}

Pode ser que um CDR não seja encontrado caso a chamada ainda não tenha terminado ou seu processamento esteja pendente. Nesse caso, recomenda-se tentar novamente após um intervalo razoável em segundos.