\section{Postman}

\begin{frame}{Mi a Postman, és miért használjuk?}
\footnotesize
Eddig minden végpontunkat vagy böngészőből (csak GET-hez alkalmas), vagy egyáltalán nem próbáltuk ki. A \textbf{Postman} egy grafikus alkalmazás, amivel bármilyen HTTP kérést összeállíthatunk és elküldhetünk -- anélkül, hogy előbb frontendet kellene írnunk hozzá.

\begin{itemize}
\item Bármilyen metódus (GET, POST, PUT, PATCH, DELETE) kipróbálható
\item Egyedi fejlécek (headers) és JSON törzs (body) is összeállítható
\item A választ (státuszkód, headerek, body) azonnal, formázva látjuk
\item Elmenthető, újra futtatható, csapattagokkal megosztható kéréssorozatok
\end{itemize}

\begin{block}{Miért nem elég a böngésző?}
A böngésző címsorába írt URL mindig \texttt{GET} kérést küld -- \texttt{POST}, \texttt{PUT}, \texttt{DELETE} kéréshez, vagy egyedi fejlécekhez (pl. \texttt{Authorization}) külön eszköz kell.
\end{block}
\end{frame}

\begin{frame}[fragile]{Egy kérés összeállítása}
\footnotesize
Egy Postman-kérés pontosan azokból az elemekből áll, amiket az 1. héten a HTTP kérés felépítéseként már megismertünk: metódus, URL, fejlécek, törzs.

\begin{block}{Amit beállítunk}
\begin{itemize}
\item \textbf{Metódus:} pl. \texttt{POST}
\item \textbf{URL:} \texttt{http://localhost:3000/users}
\item \textbf{Headers:} \texttt{Content-Type: application/json}
\item \textbf{Body (raw, JSON):}
\end{itemize}
\end{block}

\begin{verbatim}
{
  "name": "Kis Anna",
  "email": "anna@example.com"
}
\end{verbatim}

Küldés után azonnal látjuk a választ: \texttt{201 Created} és a visszakapott, azonosítóval kiegészített felhasználó.
\end{frame}

\begin{frame}{Collections és Environment változók}
\footnotesize
Ahogy egyre több végpontot tesztelünk, hasznos ezeket rendszerezni, és elkerülni, hogy mindig kézzel írjuk be az alap URL-t.

\begin{itemize}
\item \textbf{Collection:} kérések egy mappába rendezett gyűjteménye -- pl. minden "Users" végpont egy collection-ben
\item \textbf{Environment:} névhez kötött változók (pl. \texttt{baseUrl}), amikkel a kéréseinkben \texttt{\{\{baseUrl\}\}/users} írható a teljes URL helyett
\item Így egyetlen változó átírásával válthatunk fejlesztői és éles környezet között
\end{itemize}

\begin{block}{Gyakorlati tipp}
Fejlesztés közben minden újonnan megírt végpontot azonnal próbálj ki Postmanben -- ez sokkal gyorsabb visszajelzést ad, mint egy teljes frontend felület megvárása.
\end{block}
\end{frame}

\begin{frame}{Összefoglalás -- Postman}
\footnotesize
\begin{block}{Postman}
\begin{itemize}
\item Grafikus eszköz tetszőleges HTTP kérés összeállítására és elküldésére
\item Kiválthatja a böngészőt olyan esetekben, amikor nem elég a sima GET
\item Kérés = metódus + URL + headers + body -- ugyanaz, mint amit HTTP-ből már tudunk
\item Collections: kérések rendszerezése; Environments: újrafelhasználható változók
\end{itemize}
\end{block}
\end{frame}