Дела Идут для разработчиков

Просмотр контакта(ов)

Вывод основных полей для контактов.

Метод GET
URI https://prefix.delaidut.ru/api/v1/contact

Обязательные параметры

Параметр Описание
apikey уникальный ключ для текущей сессии пользователя. Возвращается при прохождении аутентификации

Необязательные параметры

Параметр Описание
contact_id массив id контактов. Указываем id контактов, которые хотим вывести
contact_type массив id типов контактов.Фильтр для контактов по типам. Список типов контактов можно получить, используя API Настройки системы
contact_status массив id статусов контактов. Фильтр для контактов по статусам. Список статусов контактов можно получить, используя API Настройки системы
contact_respons массив id пользователей. Фильтр для контактов по пользователям, которые являются ответственными. Список пользователей можно получить, используя API Настройки системы
date_from дата создания контакта. Начальная дата интервала. Формат dd.mm.yyyy hh:mm
date_to дата создания контакта. конечная дата интервала Формат dd.mm.yyyy hh:mm
date_update дата последнего изменения контакта. Возвращаются все контакты у которых дата изменения равна или больше указанной. Формат dd.mm.yyyy hh:mm
search_text текст для поиска. Поиск по текстовым значениям полей(название контакта, тип контакта, статус контакта, должность, название компании, телефон, email, фамилия, имя и отчество ответственного пользователя)
item_start номер строки, с которой начинается вывод. По умолчанию равна 0. Если передан без указания параметра limit, то счиатется равным 0
limit количество выводимых строк. По умолчанию лимит не указан

Массив возвращаемых данных

Параметр Описание
status HTTP код выполнения API. Подробнее
msg Сообщение
contacts Массив контактов
contacts → contact_id - Уникальный id контактов
contacts → contact_name - Название контакта
contacts → contact_company - Название компании
contacts → contact_position- Должность контакта
contacts → contact_tel - Телефон контакта
contacts → contact_mail - Email контакта
contacts → contact_type - Id типа контакта
contacts → contact_status - Id статуса контакта
contacts → contact_respons - Id пользователя, назначенного ответственным
contacts → contact_creator - Id пользователя, являющегося создателем
contacts → contact_editor - Id пользователя, который последним вносил изменения в контакт
contacts → contact_date - Дата создания контакта
contacts → contact_edit_date - Дата последнего изменения контакта
contacts → contact_balance - баланс контакта

Пример PHP

$data = array('apikey'=>TOKEN,
		'contact_id'=>array(),
             	'contact_type'=>array(),
              	'contact_status'=>array(),
              	'contact_respons'=>array(),
              	'date_from'=>"20.01.2024 12:00",
              	'date_to'=>"20.01.2025 12:00",
              	'item_start'=>0,
              	'limit'=>20,
              	'search_text'=>'');
$link="https://PREFIX.delaidut.ru/api/v1/contact?".http_build_query($data);
 
 
$curl=curl_init(); #Сохраняем дескриптор сеанса cURL
#Устанавливаем необходимые опции для сеанса cURL
curl_setopt($curl,CURLOPT_RETURNTRANSFER,true);#TRUE для возврата результата в качестве строки из curl_exec() вместо прямого вывода в браузер.
curl_setopt($curl,CURLOPT_URL,$link);#Загружаемый URL.
curl_setopt($curl,CURLOPT_CUSTOMREQUEST,'GET');#метод запроса
curl_setopt($curl,CURLOPT_SSL_VERIFYPEER,0);#FALSE для остановки cURL от проверки сертификата узла сети. 
curl_setopt($curl,CURLOPT_SSL_VERIFYHOST,0);#проверка существования общего имени в сертификате SSL

$out=curl_exec($curl); #Инициируем запрос к API и сохраняем ответ в переменную
$out_data=json_decode($out);
print_r($out_data);
 
curl_close($curl); #Завершаем сеанс cURL