✅Endereço de Chamada da API
/api/cdrDid/API_TOKEN/API_KEY(/id_cliente)
Este Ponto de Acesso irá fornecer uma listagem do CDR DID (Relatório de Ligações DID – Entrantes).
Se estiver utilizando Tokens de Acesso do Nível Master ou Nível Revenda, poderá especificar o ID DO CLIENTE como último parâmetro da URL para obter o CDR DID de um Cliente de ID especifico.
Caso essa API seja chamada utilizando os Tokens de Acesso do Nível Assinante, não é necessário informar o ID e será retornado o CDR do Assinante em questão.
Para nosso exemplo, iremos deduzir que o endereço do servidor será vono.me. Nesse caso, o endereço da API seria:
Endereço da API exemplo:
https://vono.me/api/cdrDid/API_TOKEN/API_KEY
OU
https://vono.me/api/cdrDid/API_TOKEN/API_KEY?date_ini=2015-03-01&date_end=2015-03-30&start=0&limit=100&time_ini=08:00:00&time_end=23:50:00
Parâmetros:
date_ini: Data Inicial
time_ini: Hora Inicial
date_end: Data Final
time_end: Hora Final
start: Exibir registros a partir dessa contagem
limit: Limite de registros a ser retornados pela chamada
id_record: Opcional: Id do Assinante ou ID do registro, quando aplicável
❕ Caso tenha duvidas de como pegar o domínio, APITOKEN e APIKEY para preencher clique abaixo.
✦ Como pegar o dominio »
✦ Como pegar APITOKEN e APIKEY »
A chamada para obter os dados da consulta, é realizado utilizando um HTTP GET para o endereço de consumo da API. Um exemplo de chamada a essa API seria:
$ curl -X GET 'https://vono.me/api/cdrDid/7cb40d54-4ebf-55a6-875a-5f53474e97cc-9990/b12c8
Utilizando essa chamada, você obteria o retorno em JSON semelhante a saída a seguir:
{
"error":0,
"reason":"OK",
"total_records":279,
"total_time":40898,
"total_time_text":"681 min 38 seg",
"total_value":"0,00000",
"total_value_connection":"0,00000",
"limit":1,
"offset":0,
"records":1,
"data":[
{
"calldate":"2024-03-14 11:41:12",
"clid":"DID: 2199000000 => 3090007 <2199000000>",
"source":"552199000000",
"destination":"5521299999990",
"region":"DID 552130900017: 2199000000 -> URA: Ura Principal",
"type":"c",
"duration":"479",
"duration2":"7 min 59 seg",
"total_price":"0,00000",
"connection_price":"0,00000",
"price_per_minute":"0,00000",
"prefix":"55219",
"source_ip":"177.126.XXX.0",
"useragent":"Fale Vono",
"disposition":"1"
}
]
}
| Campo | Descrição |
|---|---|
| error | 1 em caso de erro |
| reason | Descrição caso tenha ocorrido algum erro |
| total_records | Total de Registros encontrados na pesquisa sem a paginação solicitada |
| total_time | Tempo total das Ligações |
| total_value | Valor total das Ligações |
| records | Total de registrados retornados nessa chamada |
| data.type | Tipo da Ligação: f – fixo, c – móvel, i – ddi |
| data.duration | Tempo da Ligação com a Tarifação aplicada |
| data.total_price | Valor total da Ligação |
| data.connection_price | Valor cobrado na Conexão |
| data.price_per_minute | Valor cobrado por Minuto |
| data.disposition | Status da Chamada: 0 – Cancelado 1 – Atendido 2 – Ocupado 3 – Não Atendido 4 – Indisponível 5 – Congestionado X – Desconhecido |
