우체부라는 뜻을 가진 Postman
왜 쓰는 것일까?
알아보자
Postman is an API platform for building and using APIs
Postman simplifies each step of the API lifecycle and streamlines collaboration so you can create better APIs—faster.
API 개발과 테스트를 손쉽게 할 수 있다고 한다.
특히 이번에 알고 가야할 것은 REST API로 배경지식으로 꼭 필요하다.
또한 명세서가 필요없다.
사실 필요는 있고.. 명세서 + 포스트맨이 최고의 조합이라고 생각한다.
API repository
Easily store, catalog, and collaborate around all your API artifacts on one central platform. Postman can store and manage API specifications, documentation, workflow recipes, test cases and results, metrics, and everything else related to APIs.
여러가지 협업 툴도 제공한다.
Tools
The Postman platform includes a comprehensive set of tools that help accelerate the API lifecycle—from design, testing, documentation, and mocking to the sharing and discoverability of your APIs.
그리고 똑똑하다.
Intelligence
The Postman platform gives you advanced intelligence and insights about all of your API operations by leveraging alerts and security warnings, search, reporting, and more.
또한 워크스페이스 별로 격리도 제공한다.
Workspaces
Postman workspaces help you organize your API work and collaborate across your organization or across the world. There are three different kinds of Postman workspaces for your different needs: personal workspaces, team workspaces, and public workspaces.
또한 협업에 특화된 만큼 통합기능도 제공한다.
Integrations
Postman integrates with the most important tools in your software development pipeline to enable API-first practices. The Postman platform is also extensible through the Postman API and through open source technologies.
뭐 모든 기능을 이용할 필요는 없다.
그리고 Postman 자체에서 이용할 필요도 없다.
그냥 이것은 하나의 도구고 저 사람이 이 기능을 제공하기 위해서 어떤 식으로 구현했구나
내가 구현하는 게 좋을까? 얘 그냥 쓰는게 좋을까? 생각하면서 그냥 쓰면 된다.
Postman이 제공한다는 공식적인 기능을 보면 아주 많다.
Making requests
If you're building a client app or want to connect to an API, check out some Postman essentials:
- Connecting to APIs
- Authorizing requests
- Grouping requests in collections
- Using variables
- Visualizing data
Testing APIs
If you're testing an API, you can use Postman to automate various parts of the process:
- Writing test scripts
- Automating workflows with the collection runner
- Capturing HTTP requests
- Test script examples
Building and managing APIs
If you're developing a back-end, working API-first, or need to monitor API performance, Postman utilities can streamline your workflows:
Publishing APIs
If you're exposing an API for public use, Postman can support developer onboarding:
Collaborating with your team
If you're using Postman in your company or team, check out these guides to maximize your collaboration:
- Collaborating in Postman
- Creating workspaces
- Managing Postman for an organization
- Onboarding your team
Developing with Postman
If you're integrating Postman with your CI/CD workflow or are developing with Postman APIs or libraries, check out these resources:
내가 사용하는 주요 기능으로 몇가지 뽑아보자면
API 만들고 API Test 이다.
좀더 정확하게 말하자면 Request를 보내는 용도이자 테스트를 할 때 쓴다.
얘를 가지고 직접 뭔가를 하지는 않는다.
다만 명세서 + Postman을 쓰면 가독성이 완전 좋아진다.
하지만 먼저 이 기능을 사용하기 전에 Interface 를 봐야 한다.
내가 무엇이 어디에 있고 무엇을 할 수 있는지를 알아야 사용할 것이지 않은가.
**나한테 중요한 내용은 설명과 더불어 파란색으로 바꿔놓았다.
처음은 Header부터 보자.
대개 Header는 메뉴 바가 있다.
얘도 그렇다.
영어 설명으론 아래와 같다.
=> 어차피 Postman docs에 있는 내용이다.
Header
The header enables you to create workspaces, access reports, explore the public API network, search in Postman, view sync status and notifications, and access your settings, account, and Postman plan.
- Home - Go to your personal home page, which includes alerts, announcements, your activity feed, your recently visited workspaces, and links to resources for your team if applicable.
- Workspaces - Search for workspaces, view your recently visited workspaces, or create a new workspace.
=> Workspaces가 하나의 단위다. 프로젝트 단위로 나눌 수 있다고 생각하면 된다.
- API Network - Explore the Public API Network and access your team's Private API Network.
=> 외부의 API를 쓸 수 있다. 다만 나의 경우는 많이 쓰지는 않는다.
- Explore - Browse public APIs, teams, workspaces, and collections on Postman.
- Search Postman - Search all workspaces, collections, APIs, and teams in Postman. For more details on searching in Postman, see Search Postman.
- Invite - If you have an Admin role on a workspace, you can invite other users to collaborate.
- Settings - Access Postman settings and other Postman resources.
- Notifications - View recent activity from your team, get notifications about Postman updates, and see pull requests, comment activity, and other important information.
- Your avatar - View your profile, access your account and notification settings, see all active sessions for your account, or sign out of your account.
- Team (paid plans) or Upgrade (free plan) - View resource usage and access your billing dashboard and other account management tools.
Search Postman
To search in Postman, select Search Postman in the header then enter your search terms. You can also use the keyboard shortcut ⌘+K or Ctrl+K. To change the scope of your search to your personal or team space or the Public API Network, select All of Postman and choose the desired scope. You can also change the scope of your search to Workspaces, Collections, APIs, or Teams.
For signed-out users, search results only include public resources.
If you don't find what you are looking for in the list of results, select Search all workspaces, collections, APIs and teams and you can find all the results in one page.
The Search results page lists the scope and element type. You can change these options to further filter your results.
You can also sort results using Sort by on the right by selecting Most relevant (default), Most views, or Most recent.
Depending on the element type, the search results contain different information:
- For workspaces, the search result contains the workspace type, summary, who published it, and when was it published.
- For collections, the search result contains the workspace type, whether the collection is a fork or not, who published it, and when was it published.
- For APIs, the search result contains the name and summary of the API, the API's owner (either an individual user or a team), and the workspace type.
- For teams, the search result contains the name and summary of the team. Selecting the team name redirects you to the team profile.
중요한 기능을 추려보자면
1. Workspace 만들기
2. API들 관리
그 외엔 기본적으로 무조건 알아야 한다는 것은 없다.
다음은 Sidebar이다.
영어는 이렇다.
아마 Sidebar를 제일 많이 쓰지 않을까 싶다.
실제 워크스페이스는 처음 설정에서만 들어가고 나머진 똑같으니까..?
Sidebar
The Postman sidebar provides access to the fundamental elements of Postman:
To see the task options that are available for elements in the sidebar, select the element's name then select the more options icon
.
The task options will vary depending on the type of element you've selected.
For collections, folders and requests inside a collection, and requests in History, you can select more than one element at a time. Press and hold ⌘ or Ctrl, then select the desired elements.
For elements that are next to each other, press and hold Shift, then select the desired elements.
For collections and their contents, you can also use keyboard shortcuts for tasks like copying, pasting, and deleting.
To hide the sidebar, select the hide sidebar icon
from the footer.
내가 가장 많이쓰는 탭이
Collection과 APIs이다.
Collection은 이름에서 보다시피 당연히 Request를 저장하는 곳이며
APIs는 API를 만드는 곳이다.
나는 위 2가지 메뉴를 제일 많이 쓴다.
물론 History도 쓰지만 엄청 많다고는 못하겠다.
History
To access the requests you've made, select History in the sidebar. When you're signed in to Postman, your history syncs across your devices.
Select a request to open it again in a new tab. To select more than one request, press and hold ⌘ or Ctrl, then select the requests.
Your history also includes collection runs. These remain as the summarized version of the run and aren't logged as single requests.
- Select the add icon + to save the request to a collection.
- Select the delete icon to remove the request from your history.
- Select the more actions icon to access other actions, including creating a monitor, documentation, or mock server for the request.
Clearing your history
To remove all requests from your history, select the more actions icon
next to the History search bar, then select Clear all.
Saving responses in history
To save request responses in your history, select the more actions icon
next to the History search bar, then turn on Save Responses.
You can't use the Save Responses option with requests from Collection Runner.
다음은 메인
사실 설명이 필요없다.
그냥 작업하는 공간이다.
감이 다 온다.
Main work area
Whether you're working with a collection, an API, or another element type, the center section of Postman is where you do the majority of your work. Tabs enable you to organize your work, while the right sidebar gives you access to element-specific tools like documentation, and the environment selector and environment quick look enable you to manage variables.
Tabs
Tabs allow you to organize and work between requests.
Opening a new tab
To open a new tab, select + in the middle of the screen.
You can also select ⌘+T or Ctrl+T to open a new tab.
If you open a request and don't edit or send it, then open another request, the second tab replaces the first tab. When the tab is in preview mode, it displays in italics.
You can set whether Postman opens requests in new tabs. Select the settings icon
to open Settings. Under Requests, select Always open requests in a new tab to turn this option on or off.
Saving or discarding changes
If a tab has unsaved changes, Postman displays a dot next to the tab name. Select
Save to save the changes. To close the tab and discard changes, select the close icon
then select Don't save.
Viewing conflicts
A tab will alert you to a conflict if you or a collaborator changes its contents in another tab or workspace. Postman prompts you to resolve any conflicts that happen.
Managing tabs
You can have many tabs open at the same time. To rearrange your open tabs, select and drag them in the desired order.
To manage your open tabs or to access recently closed tabs, select the more actions icon
to open a menu with action options:
- Recently Closed Tabs - Shows tabs that you closed recently. Select one to reopen it.
- Duplicate Selected Tab - (Desktop app only) Duplicates the current tab. This doesn't create a copy of the request, so when you duplicate a tab any edits you make are reflected in the original request.
- Close Selected Tab - Closes the current tab. If the tab has unsaved changes, Postman asks if you want to save before closing.
- Force Close Selected Tab - Closes the current tab without saving any changes.
- Close All but Selected Tab - Closes all tabs except the one you're working in.
- Close All Tabs - Closes all tabs. If any tabs contain unsaved changes, Postman will ask if you want to save before closing.
- Force Close All Tabs - Closes all tabs without saving any changes.
You can also manage your open tabs or open a new tab by right-clicking on an existing tab.
Closing unsaved tabs. You can set whether Postman asks whether you want to save when you close a tab that has changes. Select the settings icon
to open Settings. Under Requests, select Always ask when closing unsaved tabs to turn this option on or off.
If you have a lot of tabs open, they might overflow the area of the tab bar. To go to tabs that are outside the viewable area, select the arrows to the left or right of the tab bar.
Right sidebar
The right sidebar gives you access to more tools, including documentation, comments, code snippets, and request information, based on which kind of Postman element you select.
ToolAvailable forDescriptionDocumentation | Collections, requests | See the documentation for a collection or for a specific request. |
Comments | Collections, requests, APIs | Leave comments on a specific part of a request or an API. |
Code | Requests, APIs, history | Generate code snippets in a variety of languages and frameworks that you can use in other apps. |
Info | Collections, requests, APIs, environments, mock servers, monitors | See details about the element, including its ID, when it was created, who created it, and more. |
Related collections | Requests, history | View public collections from the Public API Network that share the same base URL as your request and include API documentation. |
Changelog | Collections, APIs | Use the changelog to see changes that you and your collaborators have made. Available on Postman Basic, Professional, and Enterprise plans. |
Pull requests | Collections, environments | View any pull requests for a Postman element. |
Forks | Collections, environments | View any forks of a Postman element. |
Activity feed | Monitors | View the activity feed for a monitor. |
Environment selector and environment quick look
The environment selector enables you to choose which environment to use in your work. Select an environment from the menu to set it as the active environment, which gives you access to the variables in that environment.
To check a variable value at a glance, use the quick look icon
마지막은 Footer
얘도 딱히 뭐 별거 없다.
Footer
The footer on the bottom of Postman enables you to find and replace text, open the console, capture requests and cookies, open Bootcamp, and access several other tools.
- Hide sidebar - Close or reopen the sidebar.
- Sync status - See if you are connected to Postman's servers and your data is syncing.
- Find and replace - (Postman Desktop app only) Search the current workspace. You can also use the shortcuts ⌘+Shift+F or Ctrl+Shift+F. Enter your search string then select Find. Limit your search to a specific element type by selecting Collections, Environments, Globals, or Open tabs. To replace your search term in a selected element, select Replace in selected.
- Console - Inspect and debug your Postman requests.
- Cookies - View, manage, and sync cookies.
- Capture requests - Start a Postman proxy or Interceptor session.
- Bootcamp - Access an in-app classroom that teaches you how to use Postman, from the basics to advanced topics.
- Runner - Open the Collection Runner.
- Trash - Recover or permanently delete any deleted collections.
- Two-pane view - Toggle between a single pane view and a two pane view.
- Help - Access more resources, including release notes and Postman Support.
인터페이스에서 대충 알아보았고
진짜 쓰이는 내용은 다음부터 알아보려고 한다.
내가 쓰는 방법이지 모두가 쓰이는 것은 아니므로 참고만하자.
'Game Development, 게임개발 > 게임네트워크' 카테고리의 다른 글
멀티 플레이 환경에서의 클라이언트와 서버 - 1, 구조 (0) | 2022.05.10 |
---|---|
Client - side Prection, 클라이언트 단 예측 (0) | 2022.05.02 |
멀티플레이 게임과 네트워크 지연 (1) | 2022.04.29 |
Socket으로 통신 라이브러리 만들기 (0) | 2021.10.02 |
TCP,UDP 소켓프로그래밍, C# - 소켓 생성부터 종료까지 (0) | 2021.09.28 |