RESTful API и реали Безгражданства?

Question

[Алексей Волегов]

Одним из ограничений RESTful API является Безгражданство. Во всех мной прочитанных примерах это выглядит как "Не запоминайте состояние девайса". Так ли это? И как тогда хранить информацию об девайсе?

Приведу пример из своей практики. Мне необходимо авторизовать девайс, выдать ему token и сохранить о девайсе какие-то данные (device id, push token).

Сейчас я произвожу авторизацию и сохраняю в session информацию о девайсе. По сути token у меня это session_id. B этой сессии я храню user_id + device_id.

Правильно ли я поступаю в рамках RESTful API или есть более красивый и правильный подход?

Answer 1

[Егор Казанцев]

"Безгражданство" - Веселый перевод =) Смысл такой: отсутствие состояния (stateless). То есть запросы - это получение информации в зависимости от ПЕРЕДАННЫХ параметров , сервер между запросами не хранит ничего и не знает о предыдущих запросах нечего. Серверу в должно быть пофиг на все кроме того откуда брать параметры. Но так стали REST стали использовать для получения информации конкретными пользователями , пришлось добавить access_token. Это как бы служит для авторизации - но я бы назвал это "установление переменных среды". Получили токен - нашли "среду" конкретно пользователя развернули , а у пользователя там свои переменные и права - и все довольны. А вообще раз работает то не трогайте . Думаете от хорошей жизни появился REST - мне кажется что SOAP просто тяжко.

Comments

[Алексей Волегов]

Я перекраиваю реализованную мной API, которую будем в будущем отдавать на сторону. У меня все замечательно с одними POST запросами работает. Но это типо не красиво как минимум.

Кстати, а как лучше реализовать отдачу прав сторонним клиентам, мол что может пользователь, а что нет?

[Егор Казанцев]

Алексей Волегов: Ну все правильно POST не кешируются =) POST и GET вполне хватает - можно конечно поиграться со всекими PUT и DELETE - но это лучше не делать потому что не понятно что с поддержкой HTTP методов в PHP , ну и такой редкий зверь как прокси. Есть практика эмуляции этих методов через GET параметр method.

Права: можете просто допустим выдавать список прав - чтоб клиент знал что ему делать, что отрисовывать.
Ну и конечно обрабатывать проверку прав при обращение к ресурсу. Тут модно выдавать HTTP код - типа 403.

[Алексей Волегов]

Про "установку окружения" конечно хорошо сказано =)

Сейчас штудирую про REST & SOAP материал. В SOAP есть язык описания протокола (для описания как такового, так и для генерации классов под структуру данных). Есть ли какой-то стандарт описания протокола для REST и автогенерация wiki на его основе? Или как кто захочет, так тот и запилит?

[Егор Казанцев]

Я могу конечно ошибаться но ИХМО так: SOAP это ПРОТОКОЛ который разработали в 90х годах прошлого века , а REST это концепция (как Ajax - но вроде есть а RFC на него нет =) . SOAP это конечно круто - но там используется XML и WDSL и вообще больше думать, надо информации больше передавать ( это я к тому что можно отдавать хоть json хоть csv )

Автогенерация тут мне думается что надо подумать и писать так чтоб каждому конкретному ресурсу соответствовал кусок кода: класс или функция . И их уже документировать - а затем уже пользоваться тулзами аналогичным phpdocumentor и прочие