Visão Geral

Este endpoint permite o envio (upload), processamento e cadastro automático de arquivos de áudio e música de espera (MOH) na plataforma NextBilling. O sistema realiza automaticamente a conversão dos arquivos para os formatos exigidos pela telefonia (WAV/RAW).

Recursos Disponíveis

Upload de arquivos de áudio via API (Multipart/Form-Data).
Conversão automática de MP3 para RAW (8kHz, Mono, Signed-Integer).
Classificação entre Áudio Padrão (URA/Mensagens) e Música de Espera (MOH).
Recarregamento automático do serviço de MOH no Asterisk (se aplicável).

Endpoints Principais

Enviar Arquivo de Áudio (POST)

POST /api/audio/upload/{API_TOKEN}/{API_KEY}

Nota: Este endpoint requer o envio de dados como multipart/form-data.

Parâmetros do Corpo (Body Parameters):

Parâmetro	Tipo	Obrigatório	Descrição
`client_id`	integer	Sim	ID do cliente (assinante) vinculado ao áudio.
`file`	file	Sim	O arquivo de áudio. Apenas formato .mp3.
`description`	string	Não	Descrição/Nome amigável para o arquivo. Se omitido, será gerado automaticamente.
`is_moh`	integer	Não	Define o tipo de arquivo. `0` = Áudio Padrão (Mensagem/URA) - Default `1` = Música de Espera (MOH).
`status`	integer	Não	Define o status inicial. `1` = Ativo - Default `0` = Inativo.

Exemplo de Requisição (cURL):

Bash

curl -X POST \
'https://sip.nextrouter.com.br/api/audio/upload/TOKEN/KEY' \
-H 'Content-Type: multipart/form-data' \
-F 'client_id=100' \
-F 'description=Audio Promocional Natal' \
-F 'is_moh=0' \
-F 'status=1' \
-F 'file=@/caminho/para/meuarquivo.mp3'

Resposta de Sucesso (200 OK):

JSON

{
  "error": false,
  "success": true,
  "msg": "Arquivo enviado e processado com sucesso.",
  "data": {
    "id": 542,
    "file_name": "AUDIO_100-aB3dE9fG2h1",
    "duration": 45
  }
}

Resposta de Erro de Validação (200 OK com flag de erro):