Enviar números da lista negra a partir de um arquivo CSV
/v1/accounts/{accountId}/blackLists/{blackListId}/numbers/uploadAdiciona a uma lista negra os números de um arquivo CSV (valores separados por vírgula), codificado em UTF-8. Esta é a forma mais eficiente de adicionar uma grande quantidade de números, por exemplo ao importar um cadastro de bloqueio de chamadas (Do Not Call).
Cada linha do arquivo deve ter exatamente duas colunas: o número, e uma descrição opcional, que pode ficar vazia. Por exemplo:
+18005550101,Customer request
+18005550102,
+18005550103,Asked not to be called again
Os números inválidos são ignorados, e informados na resposta. Os números que já estão na lista negra também são ignorados. Uma linha com um número de colunas incorreto faz com que toda a solicitação falhe com 400 Bad Request, indicando a linha com o problema.
Parâmetros de caminho
ID da sua conta SIP Caller. Consulte ID da conta.
ID da lista negra.
Parâmetros de query string
Indica se a primeira linha do arquivo contém os nomes das colunas, e deve ser ignorada. O padrão é false.
Corpo da solicitação
Um corpo multipart/form-data com o arquivo. É possível enviar vários arquivos na mesma solicitação.
Retorna
Retorna um array com um resultado para cada arquivo enviado:
Nome do arquivo enviado.
Quantidade de linhas lidas do arquivo.
Quantidade de números adicionados.
Quantidade de linhas ignoradas, porque o número era inválido ou estava duplicado.
Até 10 dos números inválidos encontrados no arquivo, para ajudar você a encontrar o problema.
/v1/accounts/ACCOUNT_ID/blackLists/BLACK_LIST_ID/numbers/upload
curl -X POST 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/blackLists/BLACK_LIST_ID/numbers/upload?firstRowIsHeader=false' \
-H 'Authorization: Bearer API_KEY_TOKEN' \
-F 'file=@black-list-numbers.csv;type=text/csv'Resposta
200 OK
[
{
"fileName": "black-list-numbers.csv",
"totalNumbers": 18452,
"numbersAdded": 18449,
"numbersSkipped": 3,
"firstInvalidNumbers": [
"N/A",
"12"
]
}
]
