Relatorio Rentabilidade por Assinante

Endereço de Chamada da API

/api/profitCustomers/API_TOKEN/API_KEY(/id_assinante)

Este Ponto de Acesso irá fornecer uma listagem do Relatório de Rentabilidade por Assinantes.

Para nosso exemplo, iremos deduzir que o endereço do servidor será sip.nextbilling.com.br.
Nesse caso, o endereço da API seria:

Endereço da API exemplo

https://sip.nextbilling.com.br/api/profitCustomers/API_TOKEN/API_KEY
ou
https://sip.nextbilling.com.br/api/profitCustomers/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
src: Filtrar por número de Origem
dst: Filtrar por número de Destino
call_type: Tipo de Ligação. (f - FIXO | c - MOVEL | i - DDI | if - DDI FIXO | ic - DDI MOVEL)
gateways: Array de IDs de Fornecedores. Ex [1,69,44,369]
customers: Array de IDs de Assinantes. Ex [10,19,144,1369]

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://sip.nextbilling.com.br/api/profitCustomers/7cb40d54-4ebf-55a6-875a-5f57234e97cc-9990/b12c87a7-6dd6-5f99-9b47-c7c3be66fe73-8629?gateways[]=1&gateways[]=19'

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

Retorno JSON

{
    "error": 0,
    "reason": "OK",
    "total_records": 2,
    "records": 2,
    "data": [
        {
            "customer_id": "25",
            "customer_name": "Aragão e Urias",
            "calls_count": "239443",
            "duration": "217944169",
            "avg_duration": 910,
            "total_cost": "417242.12354",
            "total_value": "1162289.83589",
            "total_profit": "745047.71235",
            "margin": "64.101714507",
            "markup": "178.564835695"
        },
        {
            "customer_id": "39",
            "customer_name": "Aranda Comercial Ltda.",
            "calls_count": "239000",
            "duration": "218169324",
            "avg_duration": 912,
            "total_cost": "417593.82103",
            "total_value": "1163329.88993",
            "total_profit": "745736.06890",
            "margin": "64.103576755",
            "markup": "178.579287179"
        }
    ]
}

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
records	Total de registrados retornados nessa chamada