Chapter 7. Creating your schema model

This chapter covers

  • Understanding schema modeling basics
  • Creating a RAML schema model
  • Creating an OpenAPI schema model

At this point, you should have a good idea why you have an API and what it needs to accomplish to be successful. You have a business value as your foundation, metrics to support them, and use cases to make sure you can meet your customers’ needs and understand what you want your client developers to be able to do.

This chapter moves to the next stage—modeling the schema for your API and creating a design document that can be shared with other teams, customers, or executives. This document should help you find a development path that gives you the best chance to succeed with your API. This ...

Get Irresistible APIs now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.