Design and Build Great Web APIs

API Prototyping with OpenAPI

Earlier, in the story about creating a toile, you learned that garment makers rely on detailed design documents, called patterns,^[51] for directions on how to create the final piece of clothing. It turns out there is a whole world of pattern-making. Home patterns (called sloper patterns) are not the same as block patterns (used for industrial garment machines), and no matter the type of pattern, the process of adjusting or custom-fitting the pattern is called grading. All this pattern work relies on a standardized set of pattern symbols—a language of patterns—that the “cutter” or “sewer” needs to understand ahead of time.

This kind of “pattern language” exists when prototyping APIs too. The main GitHub repository ...