Quickly document your APIs
Nobody should be writing massive OpenAPI files from scratch. Optic helps you document your API's current behavior using real network traffic. Traffic go in → accurate OpenAPI comes out.
✅ Make it easy for developers to write accurate OpenAPI
✅ Share accurate documentation with team + consumers
✅ Ensure your API is always working as-designed
Generate OpenAPI from test traffic
- Accurate Documentation
- Documenting existing APIs manually is error prone and time consuming. Optic makes the process easy and accurate.
- Every Change Tracked
- Run Optic in CI to make sure every change to your APIs gets documented
- Connect your Test Suites
- Use the traffic from your existing tests to document your API behavior.
- Maintainable OpenAPI
- Optic generates OpenAPI with $refs. Refactor it, add descriptions, etc. Optic is smart enough to never overwrite them.
5 minute demo
Install the CLI
npm install -g @useoptic/optic
Init a capture config and empty OpenAPI spec
optic capture init openapi.yml
Run test traffic and learn endpoints
optic capture openapi.yml --update interactive
// What people are saying //
"We are set up to provide a great API and an amazing developer experience to our consumers. Realizing the promise of OpenAPI has always been hard. Optic's tools made it easier to get developers on-board and start fulfilling the promises of working API-first."
Gary Poster Senior Director Engineering
"To deliver a high quality API we need to be working API-first, and keeping track of the promises we have made to consumers. API-first has always been hard, Optic is the first tool we have found that makes it easy to quickly build and safety extend our APIs. "
Kostas Petrakis Lead API Engineer
"Brilliant! That's a whole lot of OpenAPI I don't need to write, and Optic is even making components to keep your OpenAPI Dry."
Phil Sturgeon Author, APIs you Won't Hate
"Anyone using (or wanting to use) OpenAPI to describe APIs should take a strong look at Optic. They truly get what it takes to maintain a great API at scale 🧑🍳🤌"
Marc-André Giroux API Lead
"Optic is a smart, simple, and straightforward solution to a real world problem every company faces"
Kin Lane API Evangelist
Document your APIs the easy way
Want to learn more? Read the open source documentation