Deploy Friday: E15 Developing APIs with OpenAPI and Postman
Topic: Developing APIs with OpenAPI and Postman
Hosts:
Chad Carlson, Technical Writer at Platform.sh
Larry Garfield, Director of Developer Experience at Platform.sh
Speakers:
Lorna Mitchell, Senior Developer Advocate at Nexmo
Joyce Lin, Senior Developer Advocate at Postman
OpenAPI: Clarity and structure for API development:
The OpenAPI specification (formerly known as Swagger) is a blueprint to help develop APIs and to make sure what’s in the API is clear and understandable, before development even starts. Lorna Mitchell, a Senior Development Advocate at Nexmo and one of our guests today, explains it like this, “OpenAPI is an API description standard. It's a way of explaining everything in your APIs. So think of when you would write documentation and the endpoints, the parameters, the responses you should expect, but it's in a machine-readable format. So you can generate documentation, but you can also generate mock servers, clients, feed into Postman and try out the requests. There's a bunch of possibilities.”
OpenAPI, open standard:
Because OpenAPI is an open standard, one of those possibilities (and advantages!) is being able to use a variety of tools with it. Lorna continues, “So OpenAPI, because it describes your API in its entirety, gives you a bunch of things that you can do out of the box, it's an open standard. So there's a lot of different tools, providing a lot of different features. When the machines basically read this detailed spec, you can use JSON, you can use YAML. The big advantage is that by sharing the standard, then we can also share the tools.”
Postman, a leader in API testing:
As the need for building APIs with a clear structure has risen, so has the need for testing them. This is where Postman comes in. Joyce Lin, a Senior Developer Advocate at Postman, describes Postman as a flexible, extensible API development platform that you can use for testing, deploying, as well as documenting your APIs. Joyce says the two primary use cases for OpenAPI and Postman are:
Driving the design and development of your API
Automatically generating documentation
She adds, “Postman is like a tool chain. And it’s opinionated, but it's not going to shame you because you've poorly designed your API. What Postman can help you do is interact with it a little bit more.”
She reveals support for OpenAPI in Postman happened because of customer’s requests, “Last year, one of Postman’s most requested features was support for OpenAPI. So we finally launched that, and we've been making some improvements.” Other improvements in Postman’s future include improved JSON schema and Graph SQL support.
Build and test your APIs more easily with OpenAPI and Postman on Platform.sh
Start a Free Trial on Platform.sh: https://accounts.platform.sh/platform...
Please share your feedback with us: https://platform-sh.typeform.com/to/g...
Platform.sh on social media
Twitter @platformsh
Twitter (France): @platformsh_fr
LinkedIn: Platform.sh
LinkedIn (France): Platform.sh
Facebook: Platform.sh
Watch video Deploy Friday: E15 Developing APIs with OpenAPI and Postman online without registration, duration hours minute second in high quality. This video was added by user Platform.sh 01 January 1970, don't forget to share it with your friends and acquaintances, it has been viewed on our site 460 once and liked it 15 people.