Dodawanie numerów do listy kontaktów
/v1/accounts/{accountId}/contactLists/{contactListId}/numbersDodaje jeden lub więcej numerów do listy kontaktów, wraz z wartościami ich zmiennych. Numer z takimi samymi wartościami zmiennych jak istniejący jest pomijany.
Parametry ścieżki
ID Twojego konta SIP Caller. Zobacz ID konta.
ID listy kontaktów.
Parametry zapytania
Nazwy zmiennych, których wartości są wysyłane w varValues, w tej samej kolejności, na przykład ["Customer Name","Due Balance"]. Każda nazwa musi zaczynać się od litery i zawierać wyłącznie litery, cyfry, spacje i podkreślenia, maksymalnie 255 znaków.
Pierwsze numery dodane do listy kontaktów definiują nazwy jej zmiennych: jeśli w tym momencie varNames zostanie pominięte, otrzymują one nazwy Var1, Var2 i tak dalej. Kolejne żądania muszą wysyłać tę samą liczbę wartości zmiennych, a jeśli zawierają varNames, nazwy muszą być zgodne z istniejącymi.
Treść żądania
Tablica JSON z obiektami, po jednym dla każdego dodawanego numeru. Akceptowany jest również pojedynczy obiekt.
Numer telefonu do wybrania. Separatory, takie jak spacje, myślniki, kropki i nawiasy, są dozwolone i usuwane, na przykład +1 (555) 123-9000. Numer musi zawierać od 3 do 50 cyfr i może kończyć się znakiem p, po którym następują cyfry DTMF wybierane po odebraniu połączenia, na przykład +15551239000p123. Dla tego samego kontaktu można podać do 15 numerów, oddzielonych średnikami (;).
Wartości zmiennych dla tego numeru. Wszystkie numery w żądaniu muszą mieć tę samą liczbę wartości, zgodną ze zmiennymi listy kontaktów. Domyślnie pusta tablica.
Zwraca
Zwraca tablicę z dodanymi obiektami numeru listy kontaktów. Pominięte duplikaty nie są uwzględniane, więc tablica jest pusta, jeśli wszystkie numery były duplikatami.
/v1/accounts/ACCOUNT_ID/contactLists/CONTACT_LIST_ID/numbers
curl -X POST 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/contactLists/CONTACT_LIST_ID/numbers?varNames=%5B%22Customer%20Name%22%2C%22Due%20Balance%22%5D' \
-H 'Authorization: Bearer API_KEY_TOKEN' \
-H 'Content-Type: application/json' \
-d '[
{
"number": "+18005551239",
"varValues": [
"Peter Jackson",
"$367.75"
]
}
]'Odpowiedź
200 OK
[
{
"id": 10,
"number": "+18005551239",
"varValues": [
"Peter Jackson",
"$367.75"
]
}
]
