프로젝트 소개

JSON Server는 JSON 또는 JSON5 데이터 파일로부터 가짜 REST API를 생성하는 Node.js 패키지입니다. npm install json-server로 설치한 후, posts, comments, profile과 같은 리소스가 포함된 db.json 또는 db.json5 파일을 생성하고 npx json-server db.json을 실행하여 사용합니다. 서버는 기본적으로 http://localhost:3000에서 시작되며, 배열 리소스와 단일 객체 리소스에 대한 REST 엔드포인트를 제공합니다. 배열 리소스는 GET(컬렉션 및 항목), POST, PUT, PATCH, DELETE를 지원하며, 객체 리소스는 GET, PUT, PATCH를 지원합니다. 쿼리 기능으로는 eq, ne, lt, lte, gt, gte, in, contains, startsWith, endsWith 연산자를 사용하는 필드 조건, _sort 및 - 접두사를 이용한 내림차순 정렬, _page와 _per_page를 이용한 페이지네이션(first, prev, next, last, pages, items, data와 같은 메타데이터 반환), _embed를 이용한 관계 임베딩, 그리고 JSON 객체를 사용하는 _where 복합 필터링이 포함됩니다. 종속 항목은 _dependent로 삭제할 수 있습니다. ./public의 정적 파일은 자동으로 제공되며, -s 옵션으로 추가 정적 디렉토리를 지정할 수 있습니다. README에서는 v0에서 v1로의 마이그레이션 변경 사항을 안내합니다. id는 항상 문자열이며 누락 시 자동 생성됩니다. 페이지네이션은 _limit 대신 _per_page를 사용하고, 관계 설정은 _expand 대신 _embed를 사용합니다. --delay CLI 옵션은 제거되었으며 브라우저 DevTools의 쓰로틀링 기능을 대신 사용합니다. README에 따르면 v1은 베타 버전으로 파괴적 변경이 있을 수 있으며, 안정적인 문서는 v0.17.4에서 확인할 수 있습니다.