June 16, 2018

Настойки SmarCrib

http://40.115.125.30/api/documentation - документация на Swagger. Она связана с Laravel и генерируется в полуавтоматическом режиме))

http://40.115.125.30/api/ — адрес API. Позже будет https, но пока так)

Авторизация

Таблица заполнена тестовыми данным. У всех пользователей одинаковый пароль iloveguns

[email protected] — нет детей еще
[email protected] — один ребенок
[email protected]
[email protected]
[email protected]

Это первые 5 пользователей.

Важно отметить, что все данные случайны, поэтому ребенок не просто Антон, а Dr. Bill Schuster V 1975 года рождения)

Для авторизации используется токен JWT

Первый раз звучит страшно, но на самом деле это тупо большая строка, которая передает как обычный токен в заголовке API.

Чтобы получить токен нужно сделать запрос к /login в ответе придет токен

В самом запросе отправляем email и пароль

Потом этот токен для других запросов нужно вставлять в заголовок запроса.

Тип Bearer Token.

Если хотите делать запросы тут http://40.115.125.30/api/documentation, то в Authorization нужно вставить еще слово Bearer

Инструмент для теста

Лучше всего использовать Postman, чтобы тестировать запросы. Документация содержит Swagger-UI, но он больше подходит как документация.

Типичные ответы

Апи написано на Laravel. По-факту используется два вида запроса: POST и GET.

401 - нет авторизации или токен неверный

200 - успех

204 - успешное удаление)