DEV Community

Maxime Guilbert
Maxime Guilbert

Posted on • Edited on

1 1

What is required to write an OpenAPI contact? - OpenAPI [2]

OpenAPI documents can be written either in JSON or in YAML format. So you will need to know how to read/write in one of this format and have a text editor.

Learn read/write

If you don't know what is JSON or YAML, please go check an online tutorial before going further.
All the OpenAPI contrat is written in one of these format, so it can be hard to work with without this knowledge.


Text editor

Simple ones

So if you don't want to use any plugins, or wanted to start quickly, any text editor can work.

At least, use a text editor which support JSON and/or YAML format like:

If you are a dev, your IDE will support both format and you will be able to start quickly.

Swagger Editor

If you want to have something more graphic to help you, you can use the Swagger Editor. It's an online tool and will show you direcly the result and if something is wrong!

Image description

IDE

If you want to use your IDE, you can found some IDE to help you


When you have those elements, you are ready to start your journey to the OpenAPI world!

I hope it will help you! 🍺

Image of Timescale

🚀 pgai Vectorizer: SQLAlchemy and LiteLLM Make Vector Search Simple

We built pgai Vectorizer to simplify embedding management for AI applications—without needing a separate database or complex infrastructure. Since launch, developers have created over 3,000 vectorizers on Timescale Cloud, with many more self-hosted.

Read full post →

Top comments (0)

Postmark Image

Speedy emails, satisfied customers

Are delayed transactional emails costing you user satisfaction? Postmark delivers your emails almost instantly, keeping your customers happy and connected.

Sign up