We use cookies on this site to enhance your user experience. By using this site, you are giving your consent for us to set cookies.


You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »

What makes good apis?

Criteria for interfaces?

Design approach 1st?


Hierarchy organization

How we organize apis

Reuse existing work e.g. https://apiblueprint.org/

Common design patterns

  • Discovery
  • Versioning
    • Backwards compatibility
    • Lifecycle
    • Granularity e.g. service, entire tree VSS
  • Thick and Thin Data API
    • How works with VSS.  How grouped

Types of interfaces e.g. data, rpc

  • when do use?
  • Interface classification/level


Document VISS and Kuksa/Implementation decisions against blueprints.


  • No labels