Caricare numeri in una lista nera da un file CSV
/v1/accounts/{accountId}/blackLists/{blackListId}/numbers/uploadAggiunge a una lista nera i numeri di un file CSV (valori separati da virgola), codificato in UTF-8. È il modo più efficiente per aggiungere una grande quantità di numeri, ad esempio quando si importa un registro delle opposizioni.
Ogni riga del file deve avere esattamente due colonne: il numero e una descrizione facoltativa, che può essere vuota. Ad esempio:
+18005550101,Customer request
+18005550102,
+18005550103,Asked not to be called again
I numeri non validi vengono saltati, e riportati nella risposta. Vengono saltati anche i numeri già presenti nella lista nera. Una riga con un numero errato di colonne fa fallire l'intera richiesta con 400 Bad Request, indicando la riga con il problema.
Parametri di percorso
ID del tuo account SIP Caller. Consulta ID dell'account.
ID della lista nera.
Parametri di query
Indica se la prima riga del file contiene i nomi delle colonne, e deve essere saltata. Il valore predefinito è false.
Corpo della richiesta
Un corpo multipart/form-data con il file. È possibile caricare più file nella stessa richiesta.
Restituisce
Restituisce un array con un risultato per ogni file caricato:
Nome del file caricato.
Numero di righe lette dal file.
Quantità di numeri aggiunti.
Numero di righe saltate, perché il numero non era valido o era duplicato.
Fino a 10 dei numeri non validi trovati nel file, per aiutarti a individuare il 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'Risposta
200 OK
[
{
"fileName": "black-list-numbers.csv",
"totalNumbers": 18452,
"numbersAdded": 18449,
"numbersSkipped": 3,
"firstInvalidNumbers": [
"N/A",
"12"
]
}
]
