Что такое RESTful API и как правильно проектировать endpoints?

RESTful API — это HTTP API, спроектированный в соответствии с принципами REST: ресурсы идентифицированы через URI, манипуляция выполняется HTTP-методами, ответы содержат правильные коды статуса. Правильное проектирование: URI описывают существительные (ресурсы), HTTP-методы — глаголы (действия), коды ответов — результат операции.