OpenAPI is an industry standard specification for describing APIs. We use OpenAPI to describe all our APIs, and we make those specifications publicly available too.
Each of our products has its own OpenAPI specification. The easiest way to find it is from the API reference - at the top of the page you'll find a "Download OpenAPI 3 Definition" button. The API reference pages themselves are generated from these specifications.
The spec files for each API product are also available on a GitHub repository if you'd like to browse the list directly.
Each specification is in YAML format; you can view it with an plain text editor.
Having the OpenAPI description of an API that you want to integrate with can really make things easier! Here are some suggestions that you might like to try:
Whether you're working on a poor connection or just prefer to keep things simple, an OpenAPI spec has all the information you need to be able to run a local application to show documentation. Try one of these tools:
- Nexmo OAS Renderer is an open source Ruby tool (as you may guess from the name, we created and maintain it)
If you're already a Postman fan then this may well appeal to you. If not, then give it a try.
- Download the spec for the API you're interested (via the API reference page)
- In Postman, click "Import" and choose the
*.ymlfile you just downloaded
.... that's it. You have a ready-made set of requests to make against the API, just add your Nexmo account details and off you go!
See our Guide to Postman for more examples and advanced usage.
We have a more detailed guide to working with Prism and OpenAPI that you may find useful.