Parties, Roles and Relationships

Recently, I worked on the specification for a RESTful API designed to capture information about individuals, organisations and the relationships between them. Modelling relationships between parties (i.e., individuals and organisations) can be complex, however, it's important to understand and record them correctly. Roles and Relationships Symmetrical Relationships A relationship…

Read More

Agile RESTful API Design

There are two common workflows followed by software engineers developing RESTful API's: the Specification-first approach; and the Implementation-first approach. The Specification-first approach The OpenAPI specification (formerly known as the Swagger specification) is the most popular and widely adopted specification for RESTful APIs. And, there are a great many tools, libraries…

Read More