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

Вывод примечаний для клиента

Вывод примечаний, доступных клиенту для указанного объекта.

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

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

Параметр Описание
apikey уникальный ключ для текущей сессии клиента. Возвращается при прохождении аутентификации клиента
object_type тип объекта. Может иметь следующие значения: deal-дело, contact-контакт, task-задача.
object_id id объекта. Id объекта(дела, контакта, задачи) в которое подгружаем файл

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

Параметр Описание
date_from дата создания примечания. Начальная дата интервала
date_to дата создания примечания. конечная дата интервала
item_start номер строки, с которой начинается вывод. По умолчанию равна 0. Если передан без указания параметра limit, то считается равным 0
limit количество выводимых строк. По умолчанию лимит не указан

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

Параметр Описание
status HTTP код выполнения API. Подробнее
msg Сообщение
coments Массив примечаний
coments → coment_id - Уникальный id примечания
coments → coment_creator - Флаг создателя примечания (может принимать 2 значения:manager-создателем является менеджер; client-создателем является текущий клиент, который прошел аутентификацию клиента)
coments → coment_text - Текст примечания
coments → coment_add_date - дата создания примечания
coments → coment_edit_date- дата редактирования примечания(если значение равно 0000-00-00 00:00:00, то редактирование не производилось)

Пример PHP:

$data = array('apikey'=>TOKEN,
		'object_type'=>"deal",
		'object_id'=>"1381",
              	'date_from'=>"20.01.2014 12:00",
              	'date_to'=>"20.01.2016 12:00",
              	'item_start'=>0,
              	'limit'=>20   );
$link="https://PREFIX.delaidut.ru/api/v1/client/coment?".http_build_query($data);#URI API изменить PREFIX на необходимый поддомен

$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);#Декодируем json
print_r($out_data); #Вывод данных

curl_close($curl); #Завершаем сеанс cURL