Skip to content
This repository has been archived by the owner on May 11, 2023. It is now read-only.

Commit

Permalink
Updated Postman install
Browse files Browse the repository at this point in the history
  • Loading branch information
gildedgardenia committed Nov 3, 2022
1 parent 83581bd commit a673135
Show file tree
Hide file tree
Showing 4 changed files with 37 additions and 21 deletions.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/appendices/figures/launchpad-view-mac.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
54 changes: 36 additions & 18 deletions src/appendices/postman-install.rst
Original file line number Diff line number Diff line change
Expand Up @@ -12,33 +12,51 @@ tool that puts you in full control of configuring and executing API requests.

Installing Postman is easy thanks to its cross-platform nature. You can download the installer on `their downloads page <https://www.postman.com/downloads/>`_.

**Windows Users**: Select the *Windows x64* installer download then run the installer:
Mac Users
---------

.. figure:: figures/download-installer.png
:alt: Close up of webpage to install Postman, user selecting Windows x64 option
1. Select the version that matches the type of chip your Mac has. If you are unsure if you have an Intel chip or the Apple chip, click on the apple in the upper left corner of your screen.
Select *About This Mac*. Under *Processor* on the *Overview* tab, you will see the chip manufaturer.

Windows user should select the *Windows 64-bit* download option
.. figure:: figures/download-installer-mac.png
:alt: Postman installation page with two Mac options displayed

After installation, if Postman does not open automatically, locate the download and open it manually. Making an account can be useful, but if you do not
want to create one, select the link in grey at the bottom of the splash screen that reads: "Skip signing in and take me straight to the to the app":
2. After installation, you can open the app. Postman will first prompt you to make an account, but if you are uncomfortable doing so, at the bottom of the screen is the option to sign up for an account later.

.. figure:: figures/account.png
:alt: Postman splash screen for a new account
The main view of Postman is the launchpad view.

You may skip the step to create an account
.. figure:: figures/launchpad-view-mac.png
:alt: Postman launchpad view for Mac, contains overview of initial actions a user can make with the software

.. admonition:: Tip
You are ready to go!

**Windows Users**: Once installed, you can right-click the Postman icon and pin it to your taskbar for easy access in the future:
Windows Users
-------------

.. figure:: figures/pin-taskbar.png
:alt: User pins the Postman application to their taskbar on Windows
1. Select the *Windows x64* installer download then run the installer:

Pinning the Postman application to your Windows taskbar could make your life easier
.. figure:: figures/download-installer.png
:alt: Close up of webpage to install Postman, user selecting Windows x64 option

You can leave the launchpad view open for now. We will explore Postman after setting up our API server.
Windows user should select the *Windows 64-bit* download option

.. figure:: figures/launchpad-view.png
:alt: Postman launchpad view, contains overview of initial actions a user can make with the software
2. After installation, if Postman does not open automatically, locate the download and open it manually. Making an account can be useful, but if you do not want to create one, select the link in grey at the bottom of the splash screen that reads: "Skip signing in and take me straight to the to the app":

Now that Postman is installed, there are a lot of features of the software to explore
.. figure:: figures/account.png
:alt: Postman splash screen for a new account

.. admonition:: Tip

**Windows Users**: Once installed, you can right-click the Postman icon and pin it to your taskbar for easy access in the future:

.. figure:: figures/pin-taskbar.png
:alt: User pins the Postman application to their taskbar on Windows

Pinning the Postman application to your Windows taskbar could make your life easier

3. You can leave the launchpad view open for now. We will explore Postman after setting up our API server.

.. figure:: figures/launchpad-view.png
:alt: Postman launchpad view, contains overview of initial actions a user can make with the software

Now that Postman is installed, there are a lot of features of the software to explore
4 changes: 1 addition & 3 deletions src/chapters/web-apis/exercises.rst
Original file line number Diff line number Diff line change
Expand Up @@ -199,8 +199,6 @@ If the request fails because of a client error, then it will respond with a ``40

- ``Title``: 10-100 characters
- ``Description``: less than 1000 characters

.. _delete_coding_event:

.. admonition:: Question

Expand All @@ -214,7 +212,7 @@ If the request fails because of a client error, then it will respond with a ``40
#. If the request is successful, what information can we expect to be included in the response?
#. If the request contains an error, what information can we expect to be included in the response?


.. _delete_coding_event:

Delete a Coding Event
~~~~~~~~~~~~~~~~~~~~~
Expand Down

0 comments on commit a673135

Please sign in to comment.