Give a summary on the interface.

Describe the functionality of the interface from the business point of view.

Describe the business processes relevant for this interface.

Describe the data in its technical context.

List the requirements on the interface.

Describe the security aspects to consider when publishing and using the interface.

Define the quantities serviced by this interface. This addresses figures concerned e.g. with

• Runtime
• Throughput/Volume
• Availability
• Logging
• Archiving

Resources affected when this interface is used.

Describe the side effects and consequences.

Document the technical protocols.

Document the codes and handling of error and exception cases.

Document access rights, temporal constraints, parallel access, and preconditions for using the interface.

Document the interface from the operation point of view.

Document the person in charge, costs of using the interface, organizational issues, and versioning.

Document the architectural decisions made for the interface.

Provide some examples to help users to get started with using the interface.

This may be use cases as well as coding examples.

Complex interfaces may be subdivided into single interfaces.