Дар куҷо дар сохтори системаи API, ки ба принсипҳои меъмории тоза мувофиқат мекунад, ҷойгир аст?

В соответствии с принципами чистой архитектуры документация по API должна располагаться на границе системы, то есть в слое интерфейсов (Interface Adapters) или на уровне внешних интерфейсов (например, HTTP handlers, gRPC сервисы).

Это связано с тем, что:

• Внутренние слои (бизнес-логика, домен) не должны зависеть от деталей реализации API.
• Документация API описывает контракты взаимодействия с внешним миром и должна отражать именно эти интерфейсы.

Таким образом, документация обычно находится рядом с кодом, реализующим адаптеры и интерфейсы, которые связывают внутреннюю логику с внешними клиентами.

Например, в Go проекте это может быть папка с HTTP-обработчиками и соответствующими swagger/openapi спецификациями.