Metoda getLeads¶
getLeads¶
Metoda pozwala pobrać listę transakcji, 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}}/getLeads Parametry: Tabela 1 Tabela 1
| Parametr | Typ | Wymagany | Opis |
| id | string | Nie | Unikalny identyfikator transakcji w CRM. Przy użyciu tego parametru odpowiedź będzie zawierać transakcję o podanym identyfikatorze (jeśli taka istnieje). |
| lastModified | string | Nie | Data ostatniej zmiany transakcji. Format: - RRRR-MM-DD GG:MM:SS - RRRR-MM-DD. Jeśli ten parametr zostanie podany, w odpowiedzi zwrócone zostaną tylko te transakcje, 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 transakcji - r7k12id - identyfikator „wizyty” - name - nazwa transakcji - status - status transakcji - type - typ zapytania - dateCreate - data utworzenia (UNIX) - lastModified - data zmiany - price - kwota transakcji - cost - koszt własny transakcji - clientId - identyfikator klienta CRM - manager - identyfikator menedżera odpowiedzialnego za transakcję - products - tablica produktów - fields - dodatkowe pola transakcji |
| 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.'/getLeads?'.
http_build_query(
[
'lastModified' => '2017-11-11',
'fields' => [
'id',
'status',
'price',
'cost',
'fields'
],
'limit'=> 1
]
)
);
Odpowiedź:
{
"page" : 1,
"totalResult": 156,
"data": [
{
"id" : "1",
"status" : "587",
"price" : 0,
"cost" : 0,
"fields" : {
"source1" : "yandex",
"source2" : "organic",
"source3" : "(not set)"
}
}
]
}