Interface, API and integration
Interaction contract, interface version, integration link, endpoint binding and exchange. The data schema and the transport are not equal to the business agreement.
Research draft, second pass
A second pass drafted this model: the structure a model of this thing needs, and what is known about it in the world. The line under this one says how the second half was obtained - researched against sources, or recalled without web access, in which case nothing here was read anywhere and every claim is a lead to verify. Unreviewed either way.
Bundle → Layer → Finding → Questions Missing, in the backlog
Not described yet. This gap is in the card backlog.
Note: Research contour: bundles not designed yet; questions are listed as open questions.
Classifiers Filled
- Family
- Enterprise profiles
- Category
- Enterprise subject
- Entry kind
- subject
- Domain
- EnterpriseTEC
- Industry
- Cross-industry
- Tags
- EM-TEC-03W1subjectInterfaceContractAPIVersionIntegrationEndpointBindingExchangeEvent
What it is Filled
Interaction contract, interface version, integration link, endpoint binding and exchange. The data schema and the transport are not equal to the business agreement.
Why it exists Filled
Interaction contract, interface version, integration link, endpoint binding and exchange. The data schema and the transport are not equal to the business agreement.
Distinguishing features Derived, awaiting review
- An endpoint has an environment and a period
- The contract version is pinned at the consumer
- An integration does not duplicate a dataset
What robots and AI may and may not do Derived, awaiting review
Must not
- Negative case: A new API URL is treated as a new business integration regardless of meaning.
Note: Negative case of the research brief, not yet a rule for agents.
Moral aspects Missing, in the backlog
Not described yet. This gap is in the card backlog.
Owners Filled
Steward
CTO / CIO / владелец сервиса
Master systems
- Каталог ПО
- Git
- CI/CD
- CMDB
- observability
Links to other meta-models Filled
neighbor
- EM-TEC-02
- EM-TEC-04
What else AI and robots need to interact with it Incomplete
Identity and identifiers required Derived, awaiting review
- InterfaceContract
- APIVersion
- Integration
- EndpointBinding
- ExchangeEvent
Direct properties not applicable Not applicable
Not applicable
Enterprise record contour: physical properties belong to referenced world models.
Recognition required Missing, in the backlog
Not described yet. This gap is in the card backlog.
Capabilities and actions required Missing, in the backlog
Not described yet. This gap is in the card backlog.
Hazards and failure modes required Missing, in the backlog
Not described yet. This gap is in the card backlog.
Standards and interfaces required Missing, in the backlog
Not described yet. This gap is in the card backlog.
Context of use required Missing, in the backlog
Not described yet. This gap is in the card backlog.
Sources Filled
- AISMM/WM-SFT and ArchiMate: product, system and architecture
- CSDM: business application, service and runtime instance
- SPDX/OpenTelemetry/Google SRE: delivery, observation and reliability; choose by boundary
Open questions
- How to separate the logical contract and the physical address?
- Which changes are backward compatible?
- How to represent the direction, the data and the owners of the exchange?
- Установить границу и решение reuse/extend/new по действующим спецификациям.
- Подтвердить semantic crosswalk, права и source mastership.
- Выбрать immutable refs; провести проверки fixtures до заявления о публикационной готовности.
Machine files
Provenance
enterprise research programme · published-partial
Built from: enterprise/models/em-tec-03/brief.json
Still in Russian: suggested owner, blocking decisions. Translate in research/enterprise/i18n/units.en.json.