Przesyłanie numerów czarnej listy z pliku CSV
/v1/accounts/{accountId}/blackLists/{blackListId}/numbers/uploadDodaje do czarnej listy numery z pliku CSV (wartości oddzielone przecinkami) zakodowanego w UTF-8. Jest to najbardziej wydajny sposób dodawania dużej liczby numerów, na przykład podczas importu rejestru zastrzeżonych numerów (Do Not Call).
Każdy wiersz pliku musi mieć dokładnie dwie kolumny: numer i opcjonalny opis, który może być pusty. Na przykład:
+18005550101,Customer request
+18005550102,
+18005550103,Asked not to be called again
Nieprawidłowe numery są pomijane i zgłaszane w odpowiedzi. Numery, które już są na czarnej liście, również są pomijane. Wiersz z nieprawidłową liczbą kolumn powoduje, że całe żądanie kończy się błędem 400 Bad Request, ze wskazaniem wiersza, w którym wystąpił problem.
Parametry ścieżki
ID Twojego konta SIP Caller. Zobacz ID konta.
ID czarnej listy.
Parametry zapytania
Czy pierwszy wiersz pliku zawiera nazwy kolumn i należy go pominąć. Domyślnie false.
Treść żądania
Treść multipart/form-data z plikiem. W tym samym żądaniu można przesłać kilka plików.
Zwraca
Zwraca tablicę z jednym wynikiem dla każdego przesłanego pliku:
Nazwa przesłanego pliku.
Liczba wierszy odczytanych z pliku.
Liczba dodanych numerów.
Liczba pominiętych wierszy, ponieważ numer był nieprawidłowy lub zduplikowany.
Do 10 nieprawidłowych numerów znalezionych w pliku, aby ułatwić znalezienie problemu.
/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'Odpowiedź
200 OK
[
{
"fileName": "black-list-numbers.csv",
"totalNumbers": 18452,
"numbersAdded": 18449,
"numbersSkipped": 3,
"firstInvalidNumbers": [
"N/A",
"12"
]
}
]
