Subir números de lista negra desde un archivo CSV
/v1/accounts/{accountId}/blackLists/{blackListId}/numbers/uploadAgrega a una lista negra los números de un archivo CSV (valores separados por comas), codificado en UTF-8. Es la forma más eficiente de agregar una gran cantidad de números, por ejemplo al importar un registro de No Llamar.
Cada fila del archivo debe tener exactamente dos columnas: el número, y una descripción opcional, que puede estar vacía. Por ejemplo:
+18005550101,Customer request
+18005550102,
+18005550103,Asked not to be called again
Los números no válidos se omiten, y se informan en la respuesta. Los números que ya están en la lista negra también se omiten. Una fila con una cantidad incorrecta de columnas hace que toda la solicitud falle con 400 Bad Request, indicando la línea con el problema.
Parámetros de ruta
ID de tu cuenta de SIP Caller. Consulta ID de la cuenta.
ID de la lista negra.
Parámetros de consulta
Indica si la primera fila del archivo contiene nombres de columnas, y debe omitirse. El valor predeterminado es false.
Cuerpo de la solicitud
Un cuerpo multipart/form-data con el archivo. Se pueden subir varios archivos en la misma solicitud.
Devuelve
Devuelve un array con un resultado por cada archivo subido:
Nombre del archivo subido.
Cantidad de filas leídas del archivo.
Cantidad de números agregados.
Cantidad de filas omitidas, porque el número no era válido o estaba duplicado.
Hasta 10 de los números no válidos encontrados en el archivo, para ayudarte a encontrar el 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'Respuesta
200 OK
[
{
"fileName": "black-list-numbers.csv",
"totalNumbers": 18452,
"numbersAdded": 18449,
"numbersSkipped": 3,
"firstInvalidNumbers": [
"N/A",
"12"
]
}
]
