
PHP ์จ๋ผ์ธ ๊ฐ์
>PHP - ๊ณ ๊ธ
๐ PHP ๊ณ ๊ธ - 4์ฃผ์ฐจ: RESTful API ๊ฐ๋ฐ ๊ธฐ์ด - 04 Postman ๋ฑ API ํ ์คํธ ๋๊ตฌ ํ์ฉ
![]() |
ํ์ | 10.0 | ๋ผ์ด์ผ์ค | free |
---|---|---|---|---|
์ฌ์ฉ์ํ์ | 10.0 | ์ด์์ฒด์ | ||
๋ค์ด๋ก๋ | 1 | ํ์ผํฌ๊ธฐ | 0 | |
์ ์์ฌ | LUZENSOFT | ๋ฑ๋ก์ผ | 2025-09-14 15:20:08 | |
์กฐํ์ | 1 |
#API #ํ ์คํธ #๋๊ตฌ์ #ํ์์ฑ
#RESTful API๋ฅผ ๊ฐ๋ฐํ ๋๋ ํด๋ผ์ด์ธํธ์์ ์ํธ์์ฉ์ ํ์ธํ๊ณ , API๊ฐ ์์๋๋ก ๋์ํ๋์ง ๊ฒ์ฆํ๋ ๊ณผ์ ์ด ํ์์ ์ ๋๋ค. ์ด๋ #API ํ ์คํธ ๋๊ตฌ๋ ๊ฐ๋ฐ์๊ฐ ์ง์ ํด๋ผ์ด์ธํธ ์ฝ๋๋ฅผ ์์ฑํ์ง ์๊ณ ๋ #HTTP ์์ฒญ์ ๋ณด๋ด๊ณ ์๋ต์ ๋ฐ์๋ณผ ์ ์๊ฒ ํ์ฌ, #๊ฐ๋ฐ ์๊ฐ์ ๋จ์ถํ๊ณ #๋๋ฒ๊น ์ ์ฉ์ดํ๊ฒ ํฉ๋๋ค. ๋ํ, API์ #์ ํ์ฑ๊ณผ #์ ๋ขฐ์ฑ์ ๋์ด๋ ๋ฐ ํฌ๊ฒ ๊ธฐ์ฌํฉ๋๋ค.
#Postman #ํ์ฉ๋ฒ
#Postman์ #API ๊ฐ๋ฐ ๋ฐ ํ ์คํธ์ ๋๋ฆฌ ์ฌ์ฉ๋๋ ๊ฐ๋ ฅํ ๋๊ตฌ์ ๋๋ค. ์ง๊ด์ ์ธ UI๋ฅผ ํตํด ๋ค์ํ HTTP ์์ฒญ์ ์ฝ๊ฒ ์์ฑํ๊ณ ๊ด๋ฆฌํ ์ ์์ต๋๋ค.
1. #์์ฒญ #์์ฑ ๋ฐ #์ ์ก
Postman์ ์คํํ ํ 'New Request'๋ฅผ ํด๋ฆญํ์ฌ ์ ์์ฒญ ํญ์ ์ฝ๋๋ค.
#๋ฉ์๋ ์ ํ: GET, POST, PUT, DELETE ๋ฑ ํ์ํ HTTP ๋ฉ์๋๋ฅผ ๋๋กญ๋ค์ด ๋ฉ๋ด์์ ์ ํํฉ๋๋ค.
#URL ์ ๋ ฅ: ํ ์คํธํ API์ ์๋ํฌ์ธํธ๋ฅผ URL ์ ๋ ฅ๋์ ์ ๋ ฅํฉ๋๋ค.
#ํค๋ (Headers): 'Headers' ํญ์์
Content-Type
,Authorization
๋ฑ ํ์ํ ํค๋๋ฅผ ํค-๊ฐ ์์ผ๋ก ์ถ๊ฐํฉ๋๋ค. ์๋ฅผ ๋ค์ด, JSON ๋ฐ์ดํฐ๋ฅผ ๋ณด๋ผ ๋๋Content-Type: application/json
์ ์ค์ ํฉ๋๋ค.#๋ณธ๋ฌธ (Body): POST, PUT, PATCH ์์ฒญ์ ๊ฒฝ์ฐ 'Body' ํญ์์ ์ ์กํ ๋ฐ์ดํฐ๋ฅผ ์ ๋ ฅํฉ๋๋ค. 'raw'๋ฅผ ์ ํํ๊ณ 'JSON' ํ์ ์ ์ง์ ํ ํ JSON ๋ฐ์ดํฐ๋ฅผ ์ ๋ ฅํฉ๋๋ค.
#์ ์ก (Send): ๋ชจ๋ ์ค์ ์ ๋ง์น ํ 'Send' ๋ฒํผ์ ํด๋ฆญํ์ฌ ์์ฒญ์ ๋ณด๋ ๋๋ค.
2. #์๋ต #ํ์ธ
์์ฒญ์ ๋ณด๋ด๋ฉด Postman์ API ์๋ฒ๋ก๋ถํฐ ๋ฐ์ ์๋ต์ ํ๋จ ํจ๋์ ํ์ํฉ๋๋ค.
#์๋ต_๋ณธ๋ฌธ (Response Body): ์๋ฒ๊ฐ ๋ณด๋ธ JSON, XML, HTML ๋ฑ์ ๋ฐ์ดํฐ๋ฅผ ํ์ธํ ์ ์์ต๋๋ค. 'Pretty' ๋ทฐ๋ฅผ ํตํด ๊ฐ๋ ์ฑ ์ข๊ฒ ํฌ๋งคํ ๋ ๋ฐ์ดํฐ๋ฅผ ๋ณผ ์ ์์ต๋๋ค.
#์ํ_์ฝ๋ (Status Code): HTTP ์๋ต ์ํ ์ฝ๋ (์:
200 OK
,404 Not Found
,500 Internal Server Error
)๋ฅผ ํตํด ์์ฒญ์ ์ฑ๊ณต ์ฌ๋ถ ๋ฐ ์ค๋ฅ ์ ํ์ ํ์ ํ ์ ์์ต๋๋ค.#์๋ต_์๊ฐ ๋ฐ #ํฌ๊ธฐ: ์์ฒญ ์ฒ๋ฆฌ ์๊ฐ๊ณผ ์๋ต ๋ณธ๋ฌธ์ ํฌ๊ธฐ๋ฅผ ํ์ธํ ์ ์์ต๋๋ค.
#์๋ต_ํค๋ (Response Headers): ์๋ฒ๊ฐ ๋ณด๋ธ ์๋ต ํค๋ ์ ๋ณด๋ฅผ ํ์ธํ ์ ์์ต๋๋ค.
3. #ํ๊ฒฝ (Environments) ๋ฐ #์ปฌ๋ ์ (Collections) ํ์ฉ
#ํ๊ฒฝ: ๊ฐ๋ฐ, ์คํ ์ด์ง, ์ด์ ๋ฑ ์ฌ๋ฌ ํ๊ฒฝ์์ ๋์ผํ API ์์ฒญ์ ํ ์คํธํ ๋, URL์ด๋ ์ธ์ฆ ํ ํฐ ๊ฐ์ #๋ณ์๋ฅผ ํ๊ฒฝ๋ณ๋ก ๊ด๋ฆฌํ ์ ์์ต๋๋ค. 'Environments' ๊ธฐ๋ฅ์ ํตํด ๊ฐ ํ๊ฒฝ์ ๋ง๋ ๋ณ์๋ฅผ ์ค์ ํ๊ณ ์ฝ๊ฒ ์ ํํ ์ ์์ต๋๋ค.
#์ปฌ๋ ์ : ๊ด๋ จ๋ API ์์ฒญ๋ค์ #ํด๋์ฒ๋ผ ๋ฌถ์ด ๊ด๋ฆฌํ ์ ์์ต๋๋ค. ์ด๋ฅผ ํตํด ํ๋ก์ ํธ๋ณ๋ก API ์์ฒญ๋ค์ ์ฒด๊ณ์ ์ผ๋ก ์ ๋ฆฌํ๊ณ , ํ์๋ค๊ณผ ๊ณต์ ํ๊ฑฐ๋ ์๋ํ๋ ํ ์คํธ ์ค์ํธ๋ฅผ ๊ตฌ์ถํ ์ ์์ต๋๋ค.
#๋ค๋ฅธ #API #ํ ์คํธ #๋๊ตฌ
Postman ์ธ์๋ ๋ค์ํ API ํ ์คํธ ๋๊ตฌ๋ค์ด ์์ต๋๋ค.
#Insomnia: Postman๊ณผ ์ ์ฌํ ๊ธฐ๋ฅ์ ์ ๊ณตํ๋ฉฐ, ๊น๋ํ UI์ ์ฑ๋ฅ์ผ๋ก ๋ง์ ๊ฐ๋ฐ์์๊ฒ ์ฌ๋๋ฐ๊ณ ์์ต๋๋ค. ํนํ GraphQL API ํ ์คํธ์ ๊ฐ์ ์ ๊ฐ์ง๋๋ค.
#cURL: #๋ช ๋ น์ค ๊ธฐ๋ฐ์ ๋๊ตฌ๋ก, HTTP ์์ฒญ์ ์ง์ ๊ตฌ์ฑํ๊ณ ์คํํ ์ ์์ต๋๋ค. ์คํฌ๋ฆฝํธ ์์ฑ์ด๋ ์๋ํ๋ ํ ์คํธ์ ์ ์ฉํ๊ฒ ์ฌ์ฉ๋ฉ๋๋ค.
#Swagger #UI: API ๋ฌธ์๋ฅผ ์๋์ผ๋ก ์์ฑํ๊ณ , ํด๋น ๋ฌธ์์์ ์ง์ API๋ฅผ ํ ์คํธํ ์ ์๋ ์น ๊ธฐ๋ฐ ๋๊ตฌ์ ๋๋ค. API ๋ช ์ธ์ ํ ์คํธ๋ฅผ ๋์์ ๊ด๋ฆฌํ ์ ์๋ค๋ ์ฅ์ ์ด ์์ต๋๋ค.
#VS Code #ํ์ฅ: Visual Studio Code์ ๊ฐ์ IDE์์๋ REST Client, Thunder Client ๋ฑ ๋ค์ํ ํ์ฅ ๊ธฐ๋ฅ์ ํตํด API ํ ์คํธ๋ฅผ ์ํํ ์ ์์ต๋๋ค.
์ด๋ฌํ API ํ ์คํธ ๋๊ตฌ๋ค์ ํจ๊ณผ์ ์ผ๋ก ํ์ฉํ๋ฉด, PHP๋ฅผ ์ด์ฉํ RESTful API ๊ฐ๋ฐ ๊ณผ์ ์์ ๋ฐ์ํ ์ ์๋ ๋ฌธ์ ๋ค์ ๋น ๋ฅด๊ฒ ์๋ณํ๊ณ ํด๊ฒฐํ์ฌ, ๋์ฑ ์์ ์ ์ด๊ณ ํจ์จ์ ์ธ API๋ฅผ ๊ตฌ์ถํ ์ ์์ต๋๋ค.
PHP ๊ณ ๊ธ RESTful API ๊ฐ๋ฐ ๊ธฐ์ด Postman API ํ ์คํธ ๋๊ตฌ ํ์ฉ ํ์์ฑ Postman ํ์ฉ๋ฒ ์์ฒญ ์์ฑ ์ ์ก ์๋ต ํ์ธ ํ๊ฒฝ ์ปฌ๋ ์ ๋ค๋ฅธ API ํ ์คํธ ๋๊ตฌ Insomnia cURL Swagger UI VS Code ํ์ฅ
๊ณ ์ ์์ดํผ, ์5,500์, VPN, ์ฉ๋๋ณ ํด๋ฆฐ์์ดํผ ์ ๊ณต, ๋ฌด๋ฃํ ์คํธ
https://xn--299ao67b9qbmsf04c.net/