Join us for a one-hour, introductory Postman learning session geared specifically for developers, API architects, and anyone involved in producing APIs. We'll walk through an overview of the OpenAPI specification as well as tips and best practices around using an API-first approach.
From Event to Action: Accelerate Your Decision Making with Real-Time Automation
OpenAPI Intro (1).pdf
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
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
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