/api-specification

All the OpenAPI specification files for the Nexmo APIs

Primary LanguageRubyMIT LicenseMIT

API Specifications

Provides OpenAPI Specification (v3) definitions for Nexmo APIs.

Human-readable specifications

View rendered API specifications

(Raw specification files are in definitions/)

About OpenAPI

These definitions provide a single point of truth that can be used end-to-end:

  • Planning Shared during product discussions for planning API functionality
  • Implementation Inform engineering during development
  • Testing As the basis for testing or mocking API endpoints
  • Documentation For producing thorough and interactive documentation
  • Tooling To generate server stubs and client SDKs.

Resources

Tools

  • Nexmo OAS Renderer - Nexmo's tool for rendering OpenAPI specs to HTML.
  • Nexmo Developer - Nexmo Developer uses these specs and the renderer for the API reference pages.
  • Swagger Editor - Can be used to edit OAS3 definitions, provides live reloading Swagger UI.
  • Swagger Codegen - A template-driven engine to generate documentation, API clients and server stubs in different languages by parsing OAS3 definitions.
  • Swagger Parser - Standalone library for parsing OAS3 definitions from Java

Contributing

Contributions are welcome, please follow GitHub Flow