Методът getLeads¶
getLeads¶
Методът позволява да получите списък със сделки. Включително такива, които са създадени чрез услугата R7K12. Методът връща не повече от 10000 записа при едно извикване, като в отговора на всяка заявка се добавя параметърът „totalResult“ - с общия брой резултати. Метод: GET Линк: https://api.r7k12.com/{{TOKEN}}/getLeads Параметри: Таблица 1 Таблица 1
| Параметър | Тип | Задължителен | Описание |
| id | string | Не | Уникален идентификатор на сделката в CRM. При използване на този параметър в отговора ще бъде сделката с посочения идентификатор (ако има такава). |
| lastModified | string | Не | Дата на последната промяна на сделката. Формат: - ГГГГ-ММ-ДД ЧЧ:ММ:СС - ГГГГ-ММ-ДД. Ако е посочен този параметър, в отговора ще бъдат изведени само онези сделки, които са били променени/създадени след посочената дата. |
| fields | array [string] | Не | Списък с полетата, които трябва да бъдат изведени в отговора. Ако параметърът не е зададен, се извеждат само идентификаторите. Налични полета: - id - идентификатор на сделката - r7k12id - идентификатор на „посещението“ - name - име на сделката - status - статус на сделката - type - тип на запитването - dateCreate - дата на създаване (UNIX) - lastModified - дата на промяна - price - сума на сделката - cost - себестойност на сделката - clientId - идентификатор на клиента в CRM - manager - идентификатор на мениджъра, отговорен за сделката - products - масив с продукти - fields - доп. полета на сделката |
| limit | integer | Не | Брой записи, извеждани в резултата (по подразбиране „10000“) |
| page | integer | Не | Номер на извежданата страница (по подразбиране „1“) |
Пример за заявка:
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
]
)
);
Отговор:
{
"page" : 1,
"totalResult": 156,
"data": [
{
"id" : "1",
"status" : "587",
"price" : 0,
"cost" : 0,
"fields" : {
"source1" : "yandex",
"source2" : "organic",
"source3" : "(not set)"
}
}
]
}