tomjoht / learnapidoc

Repo for API doc book
157 stars 59 forks source link

Instructions to find the GET box and disabling SSL certificate verification can be added for first time Postman users #33

Open Parikshit87 opened 3 years ago

Parikshit87 commented 3 years ago

URL: https://idratherbewriting.com/learnapidoc/#testing-your-setup

To test Postman setup and help the first time users, you may consider adding a bit. For example, the description may be updated as follows-

If you want to test whether Postman works, open up the Postman app, go to Workspaces (on upper left corner of screen) > My Workspace, click the "+" icon and paste this into the GET box: https://api.openweathermap.org/data/2.5/weather?zip=95050&units=imperial&appid=126cac1a482f51de0f1287b45ae2bf9a. Then click Send. If you get a response, it’s working correctly. (In rare cases, sometimes people have security restrictions on their computers that block all network access.)

Note In case you do not get a response due to SSL certificate issues, go to Settings > General and toggle SSL certificate verification switch to OFF.

And lastly, your blog is extremely helpful and informative. Thanks for posting this great work and allowing the documentation community to grow.