반응형 REST API4 REST API 설계 원칙 — 네이밍부터 버전 관리까지 왜 이 글을 쓰나팀 프로젝트를 하다 보면 API 설계 스타일이 제각각인 경우가 많다. 누군가는 /getUser를 쓰고, 누군가는 /user/fetch를 쓴다. 어떤 엔드포인트는 모든 응답을 200으로 내려보내고, 어떤 엔드포인트는 에러를 어떤 포맷으로 내려줄지 정해진 게 없다. 프론트엔드 개발자가 API 문서 없이 응답 구조를 유추해야 하는 상황이 생긴다.REST API 설계에 정답은 없지만, 업계에서 통용되는 관례와 원칙이 있다. 이걸 팀이 공유하면 커뮤니케이션 비용이 줄고 코드 리뷰가 훨씬 편해진다.이 글은 URL 네이밍부터 HTTP 메서드 올바른 사용, 상태코드 실전, 응답 구조 설계, 버전 관리, 쿼리 파라미터까지 REST API 설계에서 반복적으로 맞닥뜨리는 주제들을 정리한다.URL 네이밍 규칙.. 2026. 3. 19. [PHP] REST API 서버 만들기 — 프레임워크 없이 순수 PHP로 CRUD API 구현 왜 만들었나지난 두 편에서 PHP로 로그인 시스템과 게시판을 만들었다. 둘 다 서버에서 HTML을 렌더링하는 전통적인 방식이었다. 이번엔 반대로, JSON만 응답하는 REST API 서버를 만든다.프론트엔드가 React든 Vue든 모바일 앱이든, API 서버는 입력받고 처리하고 JSON을 돌려주는 역할만 한다. 프레임워크 없이 PHP 내장 기능만으로 이걸 구현하면, 라우팅이 어떻게 동작하는지, HTTP 메서드가 왜 5가지인지, 상태 코드가 왜 중요한지 직접 체감할 수 있다.기술 상세아키텍처27-php-rest-api/├── index.php # 라우터 + 핸들러 (단일 진입점)├── db.php # PDO SQLite 싱글턴├── .htaccess # Apache 리라이트 (php -S .. 2026. 3. 4. [Python] FastAPI로 REST API 서버 만들기 — Pydantic, CRUD, 자동 문서화 왜 FastAPI인가Python 백엔드 프레임워크 하면 Flask나 Django가 먼저 떠오른다. FastAPI는 2019년에 등장했지만 이미 Star 수에서 Flask를 앞질렀다. 이유는 세 가지다.첫째, 빠르다. Starlette + uvicorn 기반 비동기 서버라 Node.js, Go 수준의 처리량이 나온다. 둘째, 타입 힌트 기반 자동 검증이다. Pydantic 모델을 정의하면 요청 파싱, 유효성 검사, 에러 메시지가 자동으로 처리된다. 셋째, 자동 문서화다. 코드를 작성하면 /docs에서 Swagger UI가 즉시 열린다.Flask와 비교하면:항목FlaskFastAPI성능WSGI (동기)ASGI (비동기)입력 검증직접 구현Pydantic 자동 처리문서화별도 설정/docs 자동 생성타입 힌트선택.. 2026. 3. 4. [React] GitHub 프로필 검색기 만들기 (GitHub API) GitHub 프로필 검색기 만들기왜 만들었나외부 API를 React로 다루는 가장 직관적인 예제가 GitHub API다. 인증 없이 기본 60회/시간 요청이 가능하고, 응답 스키마가 일관적이다. 프로필 + 레포 두 엔드포인트만으로 의미있는 UI를 만들 수 있다.구현 목표:사용자명 검색 → GitHub REST API 호출프로필 카드 (아바타, 이름, 바이오, 위치, 링크)통계 바 (레포 수, 팔로워, 팔로잉, Gist)인기 레포 그리드 (스타 순 정렬)로딩 / 에러 / 빈 상태 처리Rate Limit 잔여량 표시구조09-react-github-profile/└── index.htmlReact 18 CDN + Babel Standalone. 빌드 없이 단일 HTML 파일로 완성.핵심 구현API 호출 흐름G.. 2026. 3. 1. 이전 1 다음 반응형
