API의 기본: 요청(Request), 응답(Response), 그리고 JSON BODY 완벽 이해하기

Sue·2025년 6월 10일

API에서 요청(Request), 응답(Response), JSON BODY란?

API 개발에서 클라이언트(웹/모바일 앱)와 서버가 데이터를 주고받을 때 가장 핵심적인 개념이 요청(Request), 응답(Response), 그리고 그 안에 담기는 JSON BODY입니다.
이 세 가지는 RESTful API 통신의 기본 구조이며, 제대로 이해해야 안정적이고 효율적인 데이터 송수신이 가능합니다.

1. 요청(Request)이란?

클라이언트가 서버에 어떤 행동을 요청하는 메시지입니다.
예를 들어 “이 사용자 등록해줘”, “이 상품 목록 보여줘”와 같은 요청이 될 수 있습니다.

요청의 구성 요소

HTTP 메서드: GET, POST, PUT, DELETE 등
URL(경로): /users, /items/123 등
헤더(Header): 요청에 대한 부가 정보 (예: 인증 토큰, 데이터 형식)
바디(Body): 요청과 함께 보내는 실제 데이터 (주로 JSON 형식)

예시 – 사용자 등록 요청

POST /users HTTP/1.1
Content-Type: application/json

{
  "name": "홍길동",
  "email": "hong@example.com"
}

이 중 { "name": "홍길동", "email": "hong@example.com" }가 JSON BODY입니다.
POST 요청을 통해 서버에 “이 사용자 등록해줘”라고 명령하고 있는 것입니다.

2. JSON BODY란?

JSON BODY는 요청(Request)이나 응답(Response)에서 데이터를 담는 본문 영역(Body)에 JSON 포맷으로 전달되는 내용을 말합니다.

JSON: JavaScript Object Notation. 키-값 구조로 데이터를 표현하는 포맷
BODY: 요청/응답에서 실질적인 “내용”이 들어가는 부분
JSON BODY: JSON 형식으로 데이터를 담아 보내거나 받는 것

JSON 예시

{
  "name": "홍길동",
  "email": "hong@example.com"
}

3. 응답(Response)이란?

서버가 요청에 대해 결과를 알려주는 메시지입니다.
예를 들어, “사용자 등록 완료됨”, “조회된 데이터는 이거야”와 같은 정보를 클라이언트에 전달합니다.

응답의 구성 요소

상태 코드: 200 OK, 201 Created, 400 Bad Request 등
헤더(Header): 응답 관련 정보
바디(Body): 처리 결과(데이터)를 담은 영역 → 이 역시 JSON 형태가 대부분

예시 – 사용자 등록 결과 응답

{
  "id": 123,
  "name": "홍길동",
  "email": "hong@example.com",
  "status": "success"
}

이 JSON BODY는 서버가 클라이언트에게 결과를 알려주는 데이터입니다.

전체 흐름 정리

[클라이언트]              [서버]
   요청(Request)  ─────▶  API 처리
     (JSON Body 포함)

                        처리 후 응답(Response) ─────▶
                            (JSON Body로 결과 전달)

요약

구분	개념 정리
요청 (Request)	클라이언트가 서버에 무언가를 요청함
응답 (Response)	서버가 요청을 처리한 후 결과를 돌려줌
JSON BODY	요청/응답의 실질적인 내용을 담는 JSON 데이터