Как лучше возвращать успешные запросы и ошибки в REST API?

Question

[alex maslakoff]

Как сейчас последние веяния моды насчет того, какой формат ответа должен быть в REST API? Знаю, что стандарта нет. Например, стоит ли возращать "code: 422 / http code 200", или лучше возвращать его только как http 422 и в json'e возвращать массиов ошибок? И вообще в целом, как вообще лучше возращать успешные запросы и ошибки? Как вы делаете?

Answer 1

[Сергей Горностаев]

Как это нет стандарта? Есть. В случае успеха возвращаете код 200 в заголовке и в теле данные в том формате, которого ожидает клиент. В случае ошибки код ошибки и текст сообщения ошибки.

Comments

[alex maslakoff]

где там rest api?

[alex maslakoff]

вы вообще вопрос не поняли

[Сергей Горностаев]

teke teke: вы точно знакомы с понятием REST? REST - это принцип построения web-сервисов поверх протокола HTTP. Чем больше API сервиса соответствует стандарту HTTP, тем более RESTful сервис.

[Станислав Макаров]

teke teke ну если б автор хотел REST НЕ поверх HTTP, он бы явно об этом сказал. Это раз. Во-вторых автор сам упоминает про " http code 200", поэтому Сергею остаётся только удивляться, как человек описывает фрагмент стандарта, но говорит что его нет.

Единственное о чём тут можно порассуждать - это формат тела ответа с ошибкой.

[alex maslakoff]

Станислав Макаров: наконец-то мы дошли до моего вопроса.

[alex maslakoff]

Сергей Горностаев: да? а я думал, что это принцип построения web-сервисов поверх протокола HTTP. А оказывается, что это - это принцип построения web-сервисов поверх протокола HTTP. Надо же. Перечитайте вопрос.

[al_gon]

teke teke: Вам стоит перечитать ответ. Всё предельно однозначно.

[alex maslakoff]

al_gon: а вы откуда тут взялись? нет там однозначности.

[alex maslakoff]

к тому же, некоторые компании предоставляющие rest api не следуют этому стандарту. например, facebook.

[al_gon]

teke teke: Я пришёл с выше, с тега REST API.