앱과 서버는 어떻게 대화할까?
화면에서 ‘할 일 저장’을 눌렀지만 서버는 제목이 비어 있어도 성공이라고 답합니다.
기술 이름보다 해결할 문제를 먼저 살펴보겠습니다
화면에서 ‘할 일 저장’을 눌렀지만 서버는 제목이 비어 있어도 성공이라고 답합니다.
AI 개발이라고 해서 처음부터 모든 기능을 한 번에 코딩하는 것은 아닙니다. 이번 시간에는 요청과 응답의 구조를 이해하고 성공·오류를 구분한다.를 이해하고, 화면·입력·서버가 어떤 순서로 움직이는지 작은 예제로 확인해 보겠습니다.
먼저 아래 상황을 읽어보세요. 어떤 정보가 들어오고 무엇이 정상적인 결과인지 알면 코드를 처음 봐도 이해하기 쉬워집니다. 모르는 전문용어는 아래 ‘쉬운 용어 설명’을 열어 확인하세요.
오늘 사용할 가상 상황·입력
POST /api/tasks
{ "title":"" }
기대 결과: 빈 제목은 저장 안 함코드와 자료는 교육용 축약 예시입니다. 실제 운영 적용 전 추가 보안·예외 처리·환경 설정이 필요할 수 있습니다.
이런 코드 또는 설계 규칙으로 처리합니다
아래 내용을 글자 그대로 외우기보다 어떤 정보를 입력받고, 어떤 규칙을 검사하며, 무엇이 반환되는지 먼저 살펴보세요.
API 규칙:
POST /api/tasks
입력: {title: string}
성공: 201 + 작업 ID
빈 제목: 400 + 오류 문구
권한 없음: 403정상일 때 기대하는 결과
빈 제목 요청 → 400 정상 요청 → 201 권한 부족 → 403
가장 중요한 것은 외형보다 입력과 결과 사이의 규칙입니다. 빈 입력, 권한 부족, 중복 요청처럼 예외가 생겨도 문제가 없는지 확인해야 합니다. 이 예제 하나를 이해하면 다른 기능도 비슷한 방식으로 나눠 볼 수 있습니다.
실수 사례와 개선 방법을 나란히 비교합니다
어떤 요청이든 HTTP 200 성공으로 응답합니다.
요청이 올바른지 서버에서 검사하고 실패 이유를 분명히 보냅니다.
전문용어 두 개를 쉬운 말로 알아보기
- API
- 서로 다른 프로그램이 약속된 방식으로 정보를 주고받는 통로
- 상태코드
- 요청의 성공·실패 이유를 나타내는 HTTP 숫자
세 단계의 미니 개발 실습
운영 서버가 아니라 로컬 실습 또는 별도의 연습 환경에서 수행합니다. 필요한 외부 계정이나 운영 데이터는 사용하지 않습니다.
- STEP 1입력·응답 JSON 형태를 작성한다.
- STEP 2정상·빈 제목 두 경우의 응답을 설계한다.
- STEP 3클라이언트가 오류를 사용자에게 보여주게 만든다.
실습으로 확인한 입력, 정상 결과, 오류 결과와 수정할 항목을 적어보세요.
오늘 수업의 핵심 질문
서버가 오류를 감추고 항상 성공이라고 하면 괜찮을까요?
정답과 이유 펼쳐보기
아닙니다. 잘못된 데이터가 저장되고 사용자가 문제를 알 수 없습니다.
단순히 붙여 넣은 코드보다 작동 원리와 오류 처리 방법을 자신의 말로 설명하는 것이 중요합니다.
기존 LEXID·RE:LAND 등에서 검증한 개발 구조를 학습용으로 재구성했습니다. 비공개 저장소의 실제 고객 데이터나 비밀키는 공개하지 않습니다. 예시는 운영용 완제품이 아닙니다.