Utilize HTTPS e autenticação HTTP Basic com credenciais de API aprovadas. Mantenha as credenciais no servidor da sua aplicação. Estes endpoints do Hosted PBX utilizam /hpbx/ em api.multitel.net; não insira /v3. Verifique tanto o resultado HTTP como o estado da aplicação na resposta JSON.
Solicitar um intervalo de datas limitado
curl --request POST --user "USERNAME:PASSWORD" \
--data-urlencode "date_from=2026-10-01" \
--data-urlencode "date_to=2026-10-02" \
--data-urlencode "disposition=ANSWERED" \
"https://api.multitel.net/hpbx/cdrs/YOUR_BILLING_CODE?start=0&length=50"Substitua o código de faturamento e as datas. Os filtros de data incluem os dias indicados. Para este endpoint, os filtros do corpo são codificados como formulário e a paginação está na string de consulta.
Filtros e resposta
| Parâmetro | Significado |
|---|---|
| date_from / date_to | Datas de início/fim no formato YYYY-MM-DD. |
| wherelanded | Filtro de destino, quando necessário. |
| disposition | Filtro do resultado da chamada, por exemplo ANSWERED. |
| callerid | Filtro do número de origem. |
| timezone | O identificador de fuso horário suportado, quando utilizado; não presuma que aceita um nome IANA. |
| start / length | Parâmetros de consulta que controlam a página retornada. |
Os registos de chamadas contêm hora de início, identidade do chamador, origem, primeiro destino, segundos faturáveis, resultado da chamada e identificadores da chamada. Utilize a estrutura de resultado devolvida para este endpoint; pode diferir da paginação da API do portal. Um pedido HTTP bem-sucedido não é prova de que o resultado contém chamadas correspondentes.
Utilize a referência atual do histórico de chamadas para integrações REST do portal, incluindo o respetivo esquema de resposta e permissões de conta.