Каталог интерфейсов (API/GUI)
Простыми словами
Реестр того, чем приложение открыто наружу: «интерфейсы (API/GUI), которые предоставляют приложения». МАРФА ставит API и графический интерфейс в один каталог намеренно — оба суть точки доступа, только у одной потребитель программа, а у другой человек. От каталога сервисов приложений отличается уровнем: сервис — то, что приложение делает для потребителя, интерфейс — то, через что к этому обращаются; один сервис может быть доступен и через API, и через экран. От каталога интеграций отличается тем, что интерфейс существует и без второго конца: он объявлен, даже если им пока никто не пользуется. Элементом архитектуры МАРФА считает даже отдельный API-метод — он назван в ряду инвентаризуемых объектов рядом с прибором и подразделением. При цифровой трансформации каталог разрастается: у платформ все процессы и ресурсы становятся доступны через OpenAPI.
Примеры
Перечисляя, что бывает элементом архитектурной модели, МАРФА ставит API-метод и микросервис в один ряд с прибором, каналом связи, подразделением и нормативным документом. То есть у метода такой же паспорт, как у станка.
МАРФА 3.2, разд. 2.7 — элемент архитектуры как инвентаризованный объект или субъект реальности
В разделе о трансформации это один из трёх изменений домена приложений: обеспечение максимальной интеграционной открытости, когда все процессы и ресурсы платформы становятся доступны через программизмы OpenAPI, а приложения перепроектируются под облачную масштабируемость.
МАРФА 3.2, разд. 3.3 — изменения в домене приложений при цифровой трансформации
МАРФА снимает возражение против учёта нематериального: инвентаризации подлежат и виртуальные объекты — микросервисы, функции систем, API-методы, метаданные, компоненты развёртывания. Каталог интерфейсов ровно из таких элементов и состоит.
МАРФА 3.2, разд. 2.6 — о том, что инвентаризации подлежат ментальные и виртуальные объекты
Определение из первоисточника
дословная выпискаинтерфейсы (API/GUI), которые предоставляют приложения;
Связанные понятия
Опишите архитектуру своей компании в Storm
Реестр процессов, архитектурное рабочее пространство, связи между системами и процессами — те самые артефакты, только про вашу организацию.
Это же в StormАрхитектура систем и интеграцийГраф связей реестраРеестр процессов