notwen_services · API & Exports
API & Exports
Stable contracts between Notwen resources for Notwen Services.
Boundary note
External services can fail. Public contracts should define timeouts, fallbacks and failure behaviour instead of assuming availability.
01
Exports
Prefer small, explicit exports for synchronous lookups and commands.
02
Events
Use events for state changes and between resources notifications that do not require a direct response.
03
Data contracts
Keep payloads versionable, validated and limited to data consumers actually need.
contract styleillustrative
-- Keep public contracts narrow and documented.
-- Validate input at the resource boundary.
-- Avoid consumers reaching into internal state.