✅Endereço de Chamada da API
GET /api/manageAudio/API_TOKEN/API_KEY/0
Este Ponto de Acesso permite que você Gerenciar todos os Arquivos de Áudio utilizados em URAs e Filas de Atendimento.
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:
GET https://vono.me/api/manageAudio/API_TOKEN/API_KEY/0
Parâmetros:
-
id_record: Obter o cadastro de um registro em específico
-
is_download: (Opcional)
-
1 – Realiza o download do Arquivo utilizando o método HTTP GET
❕ 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://sip.nextbilling.com.br/api/manageAudio/7cb40d54-4ebf-55a6-875a-5f57234e97cc-9990/b12c87a7-6dd6-5f99-9b47-c7c3be66fe73-8629/0
Utilizando essa chamada, você obteria o retorno em JSON semelhante a saída a seguir:
{
"error": 0,
"reason":"OK",
"records":1,
"data":[
{
"id":1976,
"id_cliente":3,
"descricao":"Audio de Teste 1",
"size":"5405640",
"duration":"160"
"is_moh":0,
"status":1
}
]
}
| Campo | Descrição |
|---|---|
| error | 1 em caso de erro |
| reason | Descrição caso tenha ocorrido algum erro |
| records | Total de Registros encontrados na pesquisa sem a paginação solicitada |
| data.id_cliente | ID do Assinante |
| data.size | Tamanho do Arquivo de Audio em bytes |
| data.duration | Duração do Arquivo em Segundos |
| data.is_moh | 0 – Arquivos de Audio | 1 – Música de Espera |
Fazendo o Download de um Arquivo de Audio
✅Endereço de Chamada da API
GET /api/recording/API_TOKEN/API_KEY/?id_record=XX&is_download=1
Este Ponto de Acesso permite que você realize o download de um arquivo de audio do Sistema. Os arquivos baixados sempre são arquivos no formato MP3.
Uma vez que essa API é chamada, o sistema irá retornar o arquivo em modo RAW, portanto, após essa chamada você deve tratar o retorno como o arquivo de audio.
Caso ocorra um erro na tratativa e o sistema não consiga fornecer o arquivo, você receberá um erro HTTP 404.
Para realizar o download, basta utilizar o método GET enviando os parâmetros na query: id_record=XX e is_download=1
Exclusão de Arquivos de Audio
✅Endereço de Chamada da API
DELETE /api/manageAudio/API_TOKEN/API_KEY/0?id_record=23
Este Ponto de Acesso permite que você remova do Sistema um Arquivo de Audio.
❕Após essa operação, NÃO é possível recuperar os arquivos removidos. Antes de realizar essa chamada, tenha certeza da ação que está realizando!
Endereço da API exemplo:
DELETE https://vono.me/api/manageAudio/API_TOKEN/API_KEY/0?id_record=23
Parâmetros:
id_record: ID do registro que vc está removendo
