API Discovery, Distribution, and Development

Workshop

using Postman

guest wifi : entiverphispho

Thank you!!

Who provides an API?

Lists over 21k APIs on their site

REST API are everywhere

But they all have needs

API  NEEds

* Documentation

* Discoverability

* Development

* Distribution

* Diagnosis (testing didn't start with d) )

Postman

is A tool for all of those API needs

I don't work for postman

I am an engineer here at IDX and I work with apis all day

Postman has helped us here with 

• Support
• QA
• Integrations

QA tests with postman, Support troubleshoots with postman, Partnerships discover our APIs with postman, Postman tests our API everyday at 5am while we sleep

but is it really useful??

Development

Run postman collections from command line or as part of a a build system

Mock server

Postman will set up a mock API for development.

Front end and back end start can work at the same time!

Free tier 1000 calls per month

Diagnosis (tests)

Write tests in JavaScript and even set up auto testing

Documentation

Postman will document for you

Building in aws? export your docs in a click

Swagger is a great API doc standard and works with Postman as well!!

Distribution

Run an API call with a click of a button

Import a collection from a local file or link online

Postman will help distribute for you

NOW ANYONE LOOKING TO DISCOVER AN API, CAN GET ALL THE API CALLS IN A COLLECTION

Discovery

Once I have a collection, options are pre-filled and your first API calls are just a click away

I can code now

I know your API

A COUPLE OTHER COOL STUFFS

console.log()

RUN ALL THE API CALLS AND TESTS, AS MANY TIMES AS YOU WANT

Write code for you

Stays in sync

Postman accounts (free and paid) will sync clients with each other and teams you are on. So start on a desktop, move to your laptop and postman will sync changes automatically.

OK
Now
Let's workshop

Visit the docs for the aws mock API we will use

https://bit.ly/2VbzIfO