API: под каким углом на них смотреть

Зачастую на аналитиков ложится задача разработки или ревью публичного API компании. Качество этого API является критичным для привлечения интеграции. Как сделать его не избыточным, как сделать его логичным и понятным? Могут ли быть формальные критерии, чтобы построить целостный процесс, менее завязанный на людей и их квалификацию? 

Комментарии ({{Comments.length}})
  • {{comment.AuthorFullName}}
    {{comment.AuthorInfo}}
    {{ comment.DateCreated | date: 'dd.MM.yyyy' }}

Для того чтобы оставить комментарий необходимо

или
Напишите нам, мы онлайн!