Аутентификация клиента
Производит аутентификацию клиента для доступа к некоторому функционалу системы. Все методы API для клиента могут быть использованы только после аутентификации клиента.
В ответ на запрос, при удачном входе, кроме тела ответа возвращается уникальный ключ для текущей сессии клиента. При дальнейших запросах к API-методам клиента нужно обратно передавать полученный ключ.
| Метод | POST |
| URI | https://prefix.delaidut.ru/api/v1/client/auth |
Параметры
| Параметр | Описание |
| login | электронный ящик клиента |
| password | md5 хэш пароля клиента |
Массив возвращаемых данных
| Параметр | Описание |
| status | HTTP код выполнения API. Подробнее |
| auth | флаг прохождения аутентификации(0-не пройдена, 1- успешно пройдена) |
| apikey | уникальный ключ для текущей сессии клиента. При вызове всех последующих API необходимо передавать этот ключ в параметре 'apikey' |
| msg | информационное сообщение |
Пример PHP:
$data='login=example@example.ru&password='.md5("12345");#Параметры, которые нужно передать API
$link="https://PREFIX.delaidut.ru/api/v1/client/auth";#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,'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
Пример AJAX
$.post('https://PREFIX.delaidut.ru/api/v1/client/auth', //Изменить PREFIX на необходимый поддомен
{
login: user@delaidut.ru, //email клиента(подставить нужный)
password: 25f9e794323b453885f5181f1b624d0b //MD5 хэш пароля клиента(подставить нужный)
},
function (msg) //Получаем ответ
{
var obj = jQuery.parseJSON(msg); //Парсим JSON ответ
LoginAuth=obj.auth; //флаг прохождения аутентификации(0-не пройдена, 1- успешно пройдена)
LoginStatus=obj.status; //код выполнения API
});