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

Аутентификация

Описание

Производит аутентификацию пользователя в системе. Все методы API могут быть использованы только после аутентификации.

В ответ на запрос, при удачном входе, кроме тела ответа возвращается уникальный ключ для текущей сессии пользователя. При дальнейших запросах к API-методам нужно передавать полученный ключ. В целях безопасности, ключ действителен в течении 15 минут. Время действия продляется автоматически при обращение к любому методу API. Поэтому в случае получения ошибки 403.3 необходимо выполнить аутентификацию заново.

Метод POST
URI https://prefix.delaidut.ru/api/v1/auth

Параметры

Параметр Описание
login электронный ящик пользователя
password md5 хэш пароля пользователя

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

Параметр Описание
status HTTP код выполнения API. Подробнее
auth флаг прохождения аутентификации(0-не пройдена, 1- успешно пройдена)
apikey уникальный ключ для текущей сессии пользователя. При вызове всех последующих API необходимо передавать этот ключ в параметре 'apikey'
msg информационное сообщение

Пример PHP:

$link = "https://PREFIX.delaidut.ru/api/v1/auth"; #URI API изменить PREFIX на необходимый поддомен
$data='login=example@example.ru&password='.md5("12345");#Параметры, которые нужно передать API

$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,'POST');#метод запроса
curl_setopt($curl,CURLOPT_POSTFIELDS,$data);#Все данные, передаваемые в HTTP POST-запросе
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