API Relatório de Chamadas – CDR (Chamadas Realizadas e Recebidas)

Relatório de Chamadas DID – CDR

✅ 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:

❕ Quer saber como pegar a API TOKEN e API KEY?.
✦ Saiba mais »

Endereço da API exemplo

❕ Lembre-se de verificar se o seu PABX é vono.me ou vono3.me.
✦ Veja como saber o domínio »

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: Limitar de registros a ser retornados pela chamada
  ◆ id_record: Opcional: Id do Assinante ou ID do registro, quando aplicável

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:

Exemplo de chamada a API utilizando cURL

$ curl -X GET 'https://vono.me/api/cdrDid/7cb40d54-4ebf-55a6-875a-5f57234e97cc-9990/b12c87a7-6dd6-5f99-9b47-c7c3be66fe73-8629'

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": "2018-03-14 11:41:12",
			"clid": "DID: 2199000000 => 3090007 <2199000000>",
			"source": "552199000000",
			"destination": "55212199000000",
			"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": "Plataforma IP",
			"disposition": "1"
		}
	]
}

0 – Cancelado
1 – Atendido
2 – Ocupado
3 – Não Atendido
4 – Indisponível
5 – Congestionado
X – Desconhecido |

Relatório de Chamadas DID – CDR

✅ Endereço de Chamada da API

/api/cdr/API_TOKEN/API_KEY(/id_assinante)

Este Ponto de Acesso irá fornecer uma listagem do CDR (Relatório de Ligações). 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 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:

❕ Quer saber como pegar a API TOKEN e API KEY?.
✦ Saiba mais »

Endereço da API exemplo

❕ Lembre-se de verificar se o seu PABX é vono.me ou vono3.me.
✦ Veja como saber o domínio »

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_assinante: Opcional: Id do Assinante quando aplicável
  ◆ id_device: Opcional: Filtrar CDR pelo ID específico de uma linha

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/cdr/7cb40d54-4ebf-55a6-875a-5f57234e97cc-9990/b12c87a7-6dd6-5f99-9b47-c7c3be66fe73-8629?date_ini=2018-01-01&date_end=2018-02-01&time_ini=&time_end='

Utilizando essa chamada, você obteria o retorno em JSON semelhante a saída a seguir:
**Retorno JSON:**

{
	"error": 0,
	"reason": "OK",
	"total_records": 1,
	"total_time": 540,
	"total_time_text": "9 min 00 seg",
	"total_value": "2,10000",
	"total_reseller_time": 540,
	"total_reseller_time_text": "9 min 00 seg",
	"total_reseller_value": "4,40000",
	"total_cost_time": 540,
	"total_cost_time_text": "9 min 00 seg",
	"total_cost_value": "0,00000",
	"total_profit_on_rev": "4,40000",
	"total_profit_on_ass": "2,10000",
	"limit": 100,
	"offset": 0,
	"records": 1,
	"data": [
		{
			"customer_id": 4,
			"calldate": "2018-01-31 18:03:52",
			"clid": "teste10next <teste10next>",
			"source": "teste10next",
			"destination": "5521985699899",
			"region": "Brasil M\u00f3vel - RJ 02",
			"type": "c",
			"type2": "movel_ldn",
			"real_duration": "10",
			"duration": "30",
			"duration2": "0 min 30 seg",
			"total_price": "0,30000",
			"price_per_minute": "0,60000",
			"reseller_duration": "30",
			"reseller_duration2": "0 min 30 seg",
			"reseller_total_price": "0,25000",
			"reseller_price_per_minute": "0,50000",
			"cost_duration": "30",
			"cost_duration2": "0 min 30 seg",
			"cost_total_price": "0,00000",
			"cost_price_per_minute": "0,00000",
			"profit_on_customer": "0,30000",
			"profit_on_reseller": "0,25000",
			"codec": "g729->g729",
			"prefix": "55219",
			"source_ip": "179.236.34.165",
			"useragent": "PolycomSoundPointIP-SPIP_550-UA\/4.0.13.1445"
		}
	]
}