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

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

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

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

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

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

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

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

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

Параметр Описание
status HTTP код выполнения API. Подробнее
msg Сообщение
files Массив данных о файлах
files → file_creator - Флаг создателя файла(может принимать 2 значения:manager-файл был загружен менеджер; client-файл был загружен клиентом, который прошел аутентификацию клиента)
files → file_name - Имя файла
files → all_name - Полное имя файла
files → file_add_date - дата загрузки файла

Пример 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/file?".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