1. All rights reserved by Postman Inc
Getting Started
with OpenAPI in
Postman
Joyce Lin
Head of Developer
Relations
Arnaud Lauret
Technical Lead, OpenAPI

2. HEAD OF DEVREL, POSTMAN
Joyce
Lin
@petuniaGray
TECHNICAL LEAD, OPENAPI, POSTMAN
Arnaud
Lauret
@apihandyman

3. 1 Introduction to OpenAPI
2 Better practices for reusable components
3 OpenAPI in Postman for documentation, tests, and more
5 Q&A
4 Resources
Stay in touch with us – @petuniaGray @apihandyman
Agenda

4. Learning Objectives
At the end of this session, you will be able to:
● Explore the applications of the OpenAPI Specification
● Design an API effectively using an API-first approach
● Leverage reusable components to ensure consistency across your
definition
● Customize generated collections based on the API definition
● Experience the complete API producer lifecycle starting with OpenAPI
Stay in touch with us – @petuniaGray @apihandyman

5. A little about you
● Answer the poll
Stay in touch with us – @petuniaGray @apihandyman

6. What is API-First?
Stay in touch with us – @petuniaGray @apihandyman

7. View the learning materials
postman.com/postman/workspace/postman-space-camp/
Stay in touch with us – @petuniaGray @apihandyman

8. During this session, we learned how to:
● Explore the applications of the OpenAPI Specification
● Design an API effectively using an API-first approach
● Leverage reusable components to ensure consistency across your
definition
● Customize generated collections based on the API definition
● Experience the complete API producer lifecycle starting with OpenAPI
Recap
Stay in touch with us – @petuniaGray @apihandyman

9. During this session, we learned about:
● API-first (aka Design-first) using OpenAPI
● Reusable components
● Boilerplate code snippets
● Schema validation
● Testing, documentation
● Version control, versioning
● Mock servers
● Integrations (CI/CD, deployment, observability)
API-first terminology
Stay in touch with us – @petuniaGray @apihandyman

10. What is API-First?
Stay in touch with us – @petuniaGray @apihandyman

11. A few things to look forward to:
● Multi-file schema support
● Partner API Network
● More APM Integrations
● No-Code Flows in Public workspaces
… and some more :)
Postman product roadmap
go.pstmn.io/public-roadmap
What’s next?
Stay in touch with us – @petuniaGray @apihandyman

12. Additional Resources
The 8-point API lifecycle blueprint
blog.postman.com/api-lifecycle-blueprint/
OpenAPI map
openapi-map.apihandyman.io/
Postman Space Camp
postman.com/postman/workspace/postman-space-camp/
OpenAPI specification 3.0.3
github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md
Stay in touch with us – @petuniaGray @apihandyman

13. Additional Resources
The Design of Web APIs
manning.com/books/the-design-of-web-apis
Stay in touch with us – @petuniaGray @apihandyman

14. Q&A
Please take a moment to tell us
about your experience in this
Space Camp session!
https://go.pstmn.io/space-camp-openapi
Stay in touch with us – @petuniaGray @apihandyman

15. Thank You
Stay in touch with us – @petuniaGray @apihandyman