Caricare numeri in un elenco di contatti da un file CSV
/v1/accounts/{accountId}/contactLists/{contactListId}/numbers/uploadAggiunge a un elenco di contatti i numeri di un file CSV (valori separati da virgola), con i valori delle loro variabili. È il modo più efficiente per aggiungere una grande quantità di numeri.
Ogni riga del file contiene un numero nella prima colonna, seguito dai valori delle sue variabili. Ad esempio, un file con 2 variabili:
5550001,John,199
5550002,Mary,299
5550003,Susan,149
La prima colonna può contenere più numeri per lo stesso contatto, separati da punto e virgola. I numeri non validi vengono saltati, e riportati nella risposta. Viene saltato anche un numero con gli stessi valori delle variabili di uno esistente. Una riga con un numero errato di colonne fa fallire l'intera richiesta con 400 Bad Request, indicando la riga con il problema.
I primi numeri aggiunti all'elenco di contatti ne definiscono le variabili. I caricamenti successivi devono avere lo stesso numero di colonne di variabili, e se varNames è incluso, i nomi devono corrispondere a quelli esistenti.
Parametri di percorso
ID del tuo account SIP Caller. Consulta ID dell'account.
ID dell'elenco di contatti.
Parametri di query
Indica se la prima riga del file contiene i nomi delle colonne, e deve essere saltata.
Numero di colonne di variabili dopo la colonna del numero, tra 0 e 20.
Nomi delle colonne di variabili, in ordine, ad esempio ["Customer Name","Due Balance"]. Se incluso, deve contenere varCount nomi.
Codifica dei caratteri del file. Il valore predefinito è UTF8. Altri valori comuni sono LATIN1 e windows-1252.
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/contactLists/CONTACT_LIST_ID/numbers/upload
curl -X POST 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/contactLists/CONTACT_LIST_ID/numbers/upload?firstRowIsHeader=true&varCount=2&varNames=%5B%22Customer%20Name%22%2C%22Due%20Balance%22%5D' \
-H 'Authorization: Bearer API_KEY_TOKEN' \
-F 'file=@contact-list-numbers.csv;type=text/csv'Risposta
200 OK
[
{
"fileName": "contact-list-numbers.csv",
"totalNumbers": 1255,
"numbersAdded": 1254,
"numbersSkipped": 1,
"firstInvalidNumbers": [
"55A0012"
]
}
]
