웹개발

API 분석하고 설계해보기

블루요시 2026. 5. 29. 16:45

맛집 정보 조회 API 분석

• 맛집: 명동 교자 본점

•  URL: https://place.map.kakao.com/1479300828

Method: GET

• Status: 200 OK

• Content-Type: text/html;charset=UTF-8

분석 내용

• 해당 URL에 접속한 뒤 개발자도구(F12)의 Network 탭을 통해 요청과 응답 내용을 확인하였다.

• 우선 클라이언트(브라우저)는 카카오맵 서버에 장소 상세 페이지 조회를 요청하였다.

• 서버는 장소 정보, 리뷰, 사진, 주변 맛집 등 페이지를 구성하기 위한 다양한 데이터를 응답한 것으로 보인다.

• 브라우저는 전달받은 데이터를 해석하여 화면에 출력한다.


Request Body (요청)

• 해당 요청은 GET Method를 사용하였다.

• GET 요청은 일반적으로 데이터를 조회할 때 사용되며 Body 없이 URL만으로 요청하는 경우가 많다.

• 따라서 이번 요청 역시 별도의 Request Body 없이 URL 기반으로 데이터를 요청한 것으로 보인다.

https://place.map.kakao.com/1479300828

1479300828 값은 장소를 식별하기 위한 ID처럼 사용되는 것으로 추정된다.

 


Response Body (응답)

• 개발자도구의 Fetch/XHR 항목을 확인한 결과, 페이지를 구성하기 위한 다양한 데이터 요청이 발생하는 것을 확인하였다.

• 응답 데이터에는 장소 기본 정보, 이미지, 리뷰, 카테고리 등 여러 데이터가 포함되어 있었다.

• 또한 <head> 영역에는 메타데이터 및 스크립트 정보가 많이 포함되어 있었고 <body> 영역은 상대적으로 단순한 구조로 보였다.

 


API  명세서 작성 해보기

• 맛집 정보를 등록, 조회, 삭제할 수 있는 API 명세서를 직접 설계해보았다.

API 맛집 등록
API 맛집 조회
API 맛집 삭제


진행 내용

• Postman을 사용하여 맛집 등록 API, 맛집 조회 API, 맛집 삭제 API를 직접 구성하고 요청 및 응답 구조를 작성해보았다.

• 또한 API 동작에 필요한 요소들을 직접 설계하였다.


아쉬웠던 점

• Postman을 통해 API 요청과 응답 구조를 연습할 수 있었지만, 실제 서버와 데이터베이스가 연결된 환경은 아니었다.

'웹개발' 카테고리의 다른 글

API  (0) 2026.06.01
HTTP  (0) 2026.05.28
Server  (0) 2026.05.28
JavaScript  (0) 2026.05.28
CSS  (0) 2026.05.27