Ответ на пост «Плохой API»
Так... В общем, насколько моего понимания хватает, вкратце это разница между REST и JSON RPC.
Первый по-максимуму использует методы и коды ответа протокола HTTP в том числе для передачи информации логики API.
Второй чётко отделяет слой HTTP и слой логики API. HTTP только чтобы передать запрос-ответ. Инфа про запрос, в том числе тип операции - только в теле запроса. Инфа про ответ, в том числе код результата выполнения операции - только в теле ответа.
И то, и другое - валидные протоколы API, более или менее подходящие под разные задачи. Главное не натягивать мухи на котлеты.
Всё, зануда мод пошёл отдыхать.