Начинайте проектирование API с потребностей клиента и модели ресурсов. Зафиксируйте схемы запросов и ответов, правила ошибок, пагинацию и совместимость. Проверяйте контракт автоматическими тестами и документируйте изменения до их выпуска.
Техническая заметка
Как проектировать API-контракт
Практические основы ясных и устойчивых API-контрактов.