Przejdź do treści

Metoda getContacts

getContacts

Metoda pozwala pobrać listę kontaktów, w tym tych, które zostały utworzone za pośrednictwem serwisu R7K12. Metoda zwraca nie więcej niż 10000 rekordów w jednym wywołaniu; do odpowiedzi na każde żądanie dodawany jest parametr „totalResult” z łączną liczbą wyników. Metoda: GET Link: https://api.r7k12.com/{{TOKEN}}/getContacts Parametry: Tabela 1 Tabela 1

Parametr Typ Wymagany Opis
id string Nie Unikalny identyfikator kontaktu w CRM. Przy użyciu tego parametru odpowiedź będzie zawierać kontakt o podanym identyfikatorze (jeśli taki istnieje).
lastModified string Nie Data ostatniej zmiany kontaktu. Format: - RRRR-MM-DD GG:MM:SS - RRRR-MM-DD. Jeśli ten parametr zostanie podany, w odpowiedzi zwrócone zostaną tylko te kontakty, które zostały zmienione/utworzone po wskazanej dacie.
fields array [string] Nie Lista pól, które mają zostać zwrócone w odpowiedzi. Jeśli parametr nie jest ustawiony, zwracane są tylko identyfikatory. Dostępne pola: - id - identyfikator kontaktu - name - nazwa kontaktu - phone - tablica numerów telefonów - email - tablica adresów e-mail - leads - tablica identyfikatorów transakcji - dateCreate - data utworzenia (UNIX) - lastModified - data zmiany (UNIX)
limit integer Nie Liczba rekordów zwracanych w wyniku (domyślnie „10000”)
page integer Nie Numer zwracanej strony (domyślnie „1”)

Przykładowe żądanie:

define('TOKEN','XXXXXXXXX');
$data = @file_get_contents(
   'https://api.r7k12.com/'.TOKEN.'/getContacts?'.
   http_build_query(
       [
           'fields' => [
               'id',
               'phone',
               'leads'
           ],
           'limit' => 1
       ]
   )
);

Odpowiedź:

{
 "page" : 1,
 "totalResult": 100,
 "data": [
   {
     "id" : "43",
     "phone" : [
       "380441234567",
       "380503215476"
     ],
     "leads" : [
       "1"
     ]
   }
 ]
}