본문으로 건너뛰기

목 REST API 만들기

원하는 메서드, 경로, 상태 코드, 지연 시간, 본문이나 자동 생성한 가짜 데이터로 가짜 JSON 엔드포인트를 만드세요. 프로토타입과 테스트용으로 10.tools 서버에서 CORS를 지원해 제공해요.

매개변수는 :name 형식으로 쓰세요. 예: /users/:id

응답 본문
지연0 ms

"{{fullName}}"나 "{{int(1, 100)}}" 같은 문자열은 요청할 때마다 바뀌어요.

개 항목

0이면 객체 하나를 반환해요

플레이스홀더 (36)
{{id}}
1, 2, 3… 목록 내 순서
{{index}}
0, 1, 2… 0부터 시작하는 순서
{{uuid}}
무작위 UUID v4
{{firstName}}
이름
{{lastName}}
성
{{fullName}}
성과 이름
{{username}}
소문자 아이디
{{email}}
example.com 주소
{{phone}}
전화번호 (+1 555…)
{{company}}
회사 이름
{{jobTitle}}
직함
{{street}}
도로명 주소
{{city}}
도시
{{country}}
국가
{{countryCode}}
ISO 3166 코드
{{zip}}
5자리 우편번호
{{domain}}
예시 도메인
{{url}}
https URL
{{ipv4}}
문서용 범위의 IPv4
{{color}}
HEX 색상
{{word}}
lorem 단어 1개
{{words}}
words(n): lorem 단어 n개
{{sentence}}
lorem 문장
{{paragraph}}
3~5개 문장
{{int}}
int(min, max): 정수
{{float}}
float(min, max, decimals)
{{price}}
price(min, max): 소수점 둘째 자리
{{bool}}
true 또는 false
{{date}}
지난 1년 안의 날짜 (YYYY-MM-DD)
{{datetime}}
지난 1년 안의 ISO 날짜·시간
{{futureDate}}
앞으로 1년 안의 날짜
{{status}}
active, pending 또는 inactive
{{pick}}
pick(a, b, c): 옵션 중 하나
{{param}}
param(name): URL 경로의 값. 예: :id
{{query}}
query(name): 쿼리 문자열의 값
{{null}}
JSON null
응답 헤더 (선택, X-로 시작하는 것만)
엔드포인트 3 / 10개 · CORS가 켜진 JSON 응답
서버에서 처리해요 · 엔드포인트 JSON은 직접 삭제하거나 7일 동안 요청이 없을 때까지 보관돼요작동 방식

목 REST API 사용 방법

  1. 1

    엔드포인트 정의하기

    메서드를 고르고 /users/:id 같은 경로를 입력하세요. 상태 코드와 함께, 느린 네트워크를 흉내 내고 싶다면 지연도 선택할 수 있어요.

  2. 2

    응답 작성하기

    고정 JSON을 붙여넣거나 가짜 데이터로 바꿔서 {{fullName}} 같은 자리 표시자와 목록 크기가 들어간 템플릿을 작성하세요.

  3. 3

    Mock API 만들기

    Mock API 만들기를 누르면 기본 URL이 생겨요. 모든 엔드포인트는 이 URL에 경로를 붙인 주소에서 응답하고, CORS도 켜져 있어요.

  4. 4

    호출하고 다듬기

    실행 버튼이나 curl, 앱의 fetch로 호출해 보세요. 수정하고 저장하면 바로 반영돼요. 다 쓴 Mock API는 삭제하면 돼요.

제한 및 Pro

무료: Mock API당 엔드포인트 10개, 본문 하나당 100 KB, 전체 512 KB, 지연 최대 5초, 생성 목록 최대 100개 항목, 방문자당 분당 요청 120회, 시간당 새 Mock API 10개, 요청 없이 7일이 지나면 삭제돼요.

Pro에서는 엔드포인트 50개, 본문 1 MB, 지연 30초, 목록 1,000개 항목까지 한도가 늘어나요. Pro 보기

목 REST API 소개

Mock REST API는 실제 백엔드가 나오기 전에도 프런트엔드와 모바일 개발자가 동작하는 엔드포인트를 쓸 수 있게 해줘요. Mock API마다 /api/mock-api/m/ 아래에 고유한 기본 URL이 생기고, 정의한 모든 엔드포인트는 선택한 메서드, 경로, 상태 코드, 지연, 헤더, JSON 본문 그대로 응답해요. 경로에는 매개변수를 넣을 수 있어서 /users/:id는 /users/7과 일치하고, 템플릿에서 {{param(id)}}로 그 값을 그대로 돌려주거나 {{query(name)}}으로 쿼리 문자열을 읽을 수 있어요.

가짜 데이터 모드는 JSON 템플릿을 36개의 자리 표시자로 실제와 비슷한 응답으로 바꿔요. 이름, 이메일, 회사, 도시부터 UUID, 날짜, 가격, 범위 안의 숫자, lorem 텍스트까지 쓸 수 있어요. 목록 크기를 지정하면 최대 100개 항목의 배열을 돌려주고, 요청마다 데이터를 같게 할지 매번 바꿀지도 정할 수 있어요. 같은 데이터는 스냅샷 테스트에 잘 맞아요. 200부터 599까지의 상태 코드로 401, 404, 429, 503 같은 오류 상황을 미리 연습할 수 있고, 최대 5초의 지연으로 로딩 화면이 어떻게 동작하는지도 확인할 수 있어요.

응답은 항상 CORS 헤더가 붙은 JSON이라서 어떤 출처의 브라우저에서도 호출할 수 있어요. Mock API는 HTML 제공, 쿠키 설정, 리디렉션을 할 수 없고 받은 요청을 저장하지도 않아요. 데이터베이스도 아니라서 POST와 PUT은 보낸 내용을 저장하지 않고 설정해 둔 본문으로만 응답해요.

개인정보 보호

엔드포인트를 호스팅하려고 저장한 정의(메서드, 경로, 상태 코드, 지연, 헤더, 본문)는 서버로 전송되어 저장돼요. 해시된 수정 토큰, 생성 시각, 마지막 요청 시각, 요청 횟수도 함께 저장돼요. 엔드포인트로 들어오는 요청은 본문, 헤더, IP 주소를 기록하지 않고 응답해요. Mock API는 직접 삭제하거나 요청과 수정 없이 7일이 지나면 삭제되고, 수정 토큰은 이 브라우저에만 보관돼요. URL을 아는 사람은 누구나 엔드포인트를 호출할 수 있으니 비밀 정보나 실제 개인정보는 넣지 마세요.

기능

실제 HTTPS 엔드포인트

모든 메서드, 경로 매개변수, 200~599 상태 코드, 지연, X- 사용자 지정 헤더를 쓸 수 있어요.

가짜 데이터 템플릿

사람, 회사, 장소, 날짜, 숫자, 텍스트용 자리 표시자가 30개 넘게 있고 객체 하나나 목록으로 만들 수 있어요.

안전하게 설계

JSON만 지원하고 CORS가 켜져 있어요. 요청 기록이 없고 수정 토큰은 해시되며 7일간 쓰지 않으면 삭제돼요.

목 REST API: 자주 묻는 질문

서버에는 무엇이 얼마 동안 저장되나요?
저장한 엔드포인트 정의, 수정 토큰의 SHA-256 해시, Mock API를 만든 시각과 마지막으로 호출된 시각, 받은 요청 횟수를 저장해요. 요청 본문, 헤더, IP 주소는 기록하지 않아요. Mock API는 삭제를 누르거나 요청과 수정 없이 7일이 지나면 자동으로 삭제되니, 계속 쓰는 API는 그대로 유지돼요.
프런트엔드 앱에서 Mock API를 호출할 수 있나요?
네. 모든 응답에 Access-Control-Allow-Origin이 *로 설정되어 있고 프리플라이트 OPTIONS 요청에도 응답해요. 그래서 localhost를 포함해 어떤 도메인에서든 fetch, axios 같은 브라우저 HTTP 클라이언트로 호출할 수 있어요. 기본 URL에 엔드포인트 경로를 붙여 쓰면 되고, 예를 들면 fetch(base + "/users")처럼 쓰면 돼요. 일반 HTTPS URL이라서 모바일 앱, Postman, curl에서도 똑같이 동작해요.
가짜 데이터 자리 표시자는 어떻게 동작하나요?
가짜 데이터 모드에서 JSON 템플릿의 문자열이 "{{email}}"이나 "{{int(1, 100)}}" 같은 자리 표시자이면 요청이 들어올 때 값으로 바뀌어요. 문자열 전체가 숫자나 true 또는 false 자리 표시자이면 실제 JSON 숫자와 불리언이 돼요. "Hello {{firstName}}"처럼 텍스트 안에도 쓸 수 있어요. 목록 크기를 지정하면 템플릿이 반복되고 {{id}}는 항목마다 1, 2, 3으로 늘어나요.
Mock API가 오류나 느린 응답을 돌려줄 수도 있나요?
네. 401 Unauthorized, 404 Not Found, 검증 오류용 422, 429 Too Many Requests, 503처럼 200부터 599까지 원하는 상태를 고르고 앱이 기대하는 오류 JSON을 작성하세요. 무료 요금제에서는 지연 슬라이더로 응답마다 최대 5초까지 늦출 수 있어서 스피너, 타임아웃, 재시도 로직을 테스트하기 좋아요. 상태 204와 304 응답은 본문 없이 전송돼요.
Mock API는 왜 HTML을 반환하거나 쿠키를 설정할 수 없나요?
아무 콘텐츠나 반환하는 무료 호스팅 엔드포인트는 피싱 페이지와 악성코드 링크에 자주 악용돼요. 이 Mock이 API 용도로만 쓰이도록 모든 응답은 nosniff와 엄격한 콘텐츠 보안 정책이 적용된 application/json이고, X-로 시작하는 사용자 지정 헤더만 허용해요. 그래서 쿠키 설정, 브라우저 리디렉션, 웹 페이지 흉내는 낼 수 없어요.