68 lines
3.0 KiB
TeX
68 lines
3.0 KiB
TeX
\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}
|