Описание тега api-design
Дизайн API - это процесс определения и предоставления набора согласованных сигнатур методов, возвращаемых значений и документации, предназначенных для использования другими разработчиками для обеспечения программного доступа к данным.
API (интерфейс прикладного программирования) - это то, что разработчики используют для работы с определенным программным обеспечением или платформой. Дизайн API относится к тем практикам, которые приводят к разработке хорошего API. Хороший дизайн API помогает разработчикам использовать всю мощь вашей платформы при простоте использования. Плохой дизайн API может помешать разработчикам использовать всю мощь вашей платформы, а в худшем случае может оттолкнуть разработчиков от вашей платформы из-за ее сложности.
Дизайн API имеет много общих концепций с лучшими практиками нормального программирования. Некоторые из них - разделение проблем и предотвращение утечки абстракции.
Ссылки