Многие API в современном мире никогда не потребляются браузером или приложением на внешнем интерфейсе, так что он может облегчить жизнь, зная, почему вы его создаете.
Но в конце концов, хороший API прост и понятен. Это просто позволяет разработчику извлекать данные из системы, но обычно с некоторым представлением о каждом типе запроса.
Например, если у вас есть API для университета, конечные точки могут быть следующими:
/pupils => Get/Sets pupil data.
/teachers => Get/Sets teacher data.
/classes => Get/Sets class subjects and references ID's of both Pupils and Teachers.
Таким образом, если вы хотите, чтобы все ученики в данном классе вы запрашивали конечную точку /classes
, а затем для каждого идентификатора ученика вы запрашивали бы конечную точку /pupil
.
Иногда не имея внешнего интерфейса делает API еще более универсальным c, потому что вы можете думать иначе, когда у вас нет внешнего интерфейса.