API Builder | The Exploratory

You can design your API directly in Postman using the API Builder. By defining your schema, your specification can act as the single source of truth for your API project. The API Builder supports API-first development by allowing you to generate collections from your schema and build your development, docs, and testing from there.

Code sample:

API-First software development for modern organizations:

API-First Development:

Read about it in the docs:

00:00 - Intro
00:30 - Create an API
01:54 - Schema validation
02:50 - Two-way sync
03:18 - Create an API version
03:43 - Create a Mock Server
05:40 - Update a collection from a schema
08:02 - Add Documentation
08:52 - Add Test Suite
10:30 - Add Monitor
12:14 - Summary

[greeniskilller]

I really want to use the api builder feature but the validation issue is keeping me off. Validation works when done as shown the video but if i create another schema say "audio" and then change $ref on the path to "audio" and save it and try to validate it, it doesn't detect any changes at all. This is really frustrating and only way to get those changes would be to generate new collection and mockserver. It be really nice if any changes on the spec would reflect on the collection too.

[CharithBimsara]

According to this video we can create mock servers, environments and documents inside the Postman API. But latest version is not showing that feature. Because of that we need to copy the collection into workspace and then need to create a mock server. And also if do any changes to API definition it is not reflected to the collection. Again we need to create a collection using that definition and copy that collection to workspace and create mocks server again. Any thoughts on this?

[fionnoconnor]

Any reason why you wouldn't use the same collection generated for the mock server for tests and docs?

[yashiagarwal]

Hi, I need to validate swagger schema which is in json formag with my API response..Can you please help me with that

[AnkitRaj-huij]

How come the mock servers know what to send as response? As a PM just want to know how the server side is created - as in the video it is not clear how the mock server knew the responses.Are we creating any mock DB at the mock server where response's key value pairs are stored?

[rcb]

Great presentation! Please, next time use a microphone closer to your mouth to avoid sound reverberation.

[JohnDoe-fzng]

The user interface has changed so much that your videos are so out of date and not very useful.