Swagger is the world's largest framework of API developer tools for the OpenAPI Specification (OAS) enabling development across the entire API lifecycle, from design and documentation, to test and deployment.
Aria provides a swagger-based description of Aria Billing Cloud's Core API. Swagger is a format for describing REST-based APIs and can be written in one of two different formats (either JSON or YAML). It can be thought of as a similar mechanism for REST-based APIs as WSDLs are for SOAP-based ones. Compared to WSDL files, SWAGGER files can contain more information about its described APIs and is thought to be more human readable than WSDL.
Describing Aria Billing Cloud APIs enables the ability to generate an SDK client to access the APIs in one of many programming languages supported by the Swagger open source community. In addition to API SDK generation, Swagger also provides an HTML-based user interface, "SwaggerUI", that provides a user-friendly way to view APIs, describe parameters and responses, and structure live calls to them.
"swagger-codegen" is the open-source library used to to generate the calling of swagger-defined APIs. Swagger clients pass arguments and return objects as typed objects. This typed format makes larger APIs more manageable and easy to use. Many of the language-based client platforms provide additional ways to make asynchronous calls and can perform client-side validations. The open-source community for swagger-codegen continues to push new functionality out of this platform.