Defining APIs

  • Cloves CarneiroJr.
  • Tim Schmelmer


This chapter will introduce approaches and tools for describing your services' APIs in a machine-readable format. First we will introduce the concepts behind Interface Definition Languages (IDLs) and will briefly introduce a number of such languages. Next, we will introduce the Swagger IDL framework and its associated tool chain in more detail, and we will conclude the chapter by illustrating how to use Swagger to define the APIs of one of the services in our bookstore application.


User Service Tool Chain Common Object Request Broker Architecture Definition Language Remote Procedure Call 
These keywords were added by machine and not by the authors. This process is experimental and the keywords may be updated as the learning algorithm improves.

Copyright information

© Cloves Carneiro Jr. and Tim Schmelmer 2016

Authors and Affiliations

  • Cloves CarneiroJr.
    • 1
  • Tim Schmelmer
    • 2
  1. 1.HollywoodUSA
  2. 2.BroomfieldUSA

Personalised recommendations