CRUD란?
서버에 요청하는 정보의 동작은 4가지로 구분되며, 이를 CRUD라고 부릅니다.
- Create : 쓰기
- Read : 읽기
- Update : 수정
- Delete : 삭제
각 동작의 영문 첫 글자를 따서 CRUD라고 부릅니다.
RESTful API URI 설계 원칙
- URI에는 "정보의 종류(분류 체계)"만 포함시켜야 하며,
"읽기/쓰기 등의 동작(action)"은 URI에 표현하지 않는 것이 원칙입니다. - 예시:
- ✅ /movies (영화 자원에 접근)
- ❌ /getMovies, /readMovieList (비권장: 동작이 포함됨)
동작은 HTTP 메서드로 구분
RESTful API에서는 HTTP 메서드를 사용하여 요청의 동작을 구분합니다.
HTTP 메서드의미설명
| GET | 읽기 | 데이터 조회 |
| POST | 생성 | 새 데이터 추가 |
| PUT | 수정 | 기존 데이터 전체 수정 |
| DELETE | 삭제 | 데이터 삭제 |
RESTful 요청 방식 핵심 요약
- URI는 "자원의 위치(무엇에 대해 요청하는가)" 를 의미하고
- HTTP 메서드는 "그 자원에 어떤 동작을 할 것인가" 를 구분합니다.
JSON (JavaScript Object Notation)
- XML의 단점을 극복하기 위해 만들어진 경량 데이터 형식
- 사람이 읽고 쓰기 쉽고, 기계가 분석 및 생성하기도 쉬움
- 언어 독립적 → 다양한 프로그래밍 언어에서 사용 가능
JSON 기본 구조
- 객체(Object) : { 키: 값, 키: 값, ... }
- 배열(Array) : [ 값1, 값2, 값3, ... ]
API란?
**API (Application Programming Interface)**는
두 개 이상의 소프트웨어(또는 프로그램)가 서로 통신하고 연결되도록 도와주는 인터페이스입니다.
- 서비스 또는 데이터를 다른 소프트웨어에 제공하기 위한 인터페이스
- 컴퓨터와 사람을 연결하는 UI와 달리, API는 프로그램끼리 연결함
오픈 API (Open API)
- 누구나 사용할 수 있도록 공개된 API
- 주로 RESTful 형식 또는 SOAP 프로토콜을 사용해
공공 콘텐츠나 데이터 등을 제공 - 즉, 인증 키만 받으면 자유롭게 요청하여 정보 활용 가능