프런트엔드 팀이 작업에 막혔습니다. 디자인은 승인되었고, 화면은 절반 정도 완성되었는데, 유일한 걸림돌은 아직 존재하지 않는 API입니다. 백엔드는 아직 한 스프린트 정도 더 걸릴 예정이라 UI는 호출할 실제 데이터가 없습니다. 보통 임시방편으로 로컬 목(mock)을 사용하는데, 이는 노트북을 닫는 순간까지만 작동합니다. 그러고 나면 다른 시간대에 있는 팀원이 사용하던 엔드포인트는 사용할 수 없게 됩니다.
Apidog가 Cloud Mock으로 이러한 공백을 메워줍니다. 하나의 기계에서만 생성되고 사라지는 목 대신, mock.apidog.com에서 24시간 호스팅되는 공개 URL을 얻을 수 있습니다. 프런트엔드, QA, 파트너 개발자들은 백엔드 코드가 한 줄도 배포되기 전에 실제와 같은 엔드포인트를 호출할 수 있습니다. 목이 팀에 가져다주는 더 넓은 그림을 먼저 알고 싶다면, API 목이 무엇이며 언제 사용해야 하는지에 대한 저희의 입문서가 배경 지식을 제공할 것입니다. 공개 목 URL이 요청 처리에 어떻게 적용되는지에 대한 메커니즘은 MDN의 HTTP 요청/응답 모델 참조가 좋은 복습 자료가 될 것입니다.
클라우드 목이란 무엇이며 로컬 목이 부족한 이유
Apidog는 설계하는 모든 API에 대해 목 엔드포인트를 생성합니다. 기본적으로 이 목은 로컬 목이며, Apidog 인스턴스에서 실행되고 컴퓨터가 켜져 있는 동안 응답합니다. 컴퓨터를 끄는 순간 엔드포인트는 응답을 멈춥니다. 이는 단독 디버깅에는 괜찮습니다. 하지만 다른 누군가가 이 URL에 의존하는 순간 문제가 발생합니다.
Cloud Mock이 이 문제를 해결합니다. 이는 개별 머신과 독립적으로 지속되는 지속적으로 사용 가능한 목 엔드포인트입니다. 팀원들의 컴퓨터가 잠들어 있거나, 노트북이 가방 안에 있어도 클라우드 목은 24시간 연중무휴로 요청에 응답합니다. 엔드포인트는 Apidog의 호스팅 서비스에 상주하므로 가용성이 누가 온라인 상태인지에 묶여 있지 않습니다.
실질적인 이점은 깔끔한 인계입니다. 계약을 설계하고, Cloud Mock을 켜고, 하나의 URL을 공유합니다. 프런트엔드는 실제 데이터에 맞춰 구축하고, QA는 실제 응답 형태에 맞춰 테스트 케이스를 작성하며, 통합하는 파트너는 즉시 클라이언트를 연결하기 시작할 수 있습니다. 아무도 백엔드를 기다리지 않으며, 아무도 프로세스를 계속 실행하기 위해 여러분을 기다리지 않습니다. 지역을 넘어 이를 조율하는 경우, 글로벌 팀과 목 서버 및 환경을 공유하는 방법에 대한 패턴이 워크플로를 더 깊이 다룹니다.
Cloud Mock을 활성화하고 공개 URL 얻기
실제 API를 통해 살펴보겠습니다. 고객 레코드 목록을 반환하는 GET /users 엔드포인트를 가진 users 서비스를 구축하고 있다고 가정해 봅시다. 이를 공유 가능한 클라우드 엔드포인트로 바꾸는 방법은 다음과 같습니다.
1단계: Cloud Mock 켜기
프로젝트를 열고 프로젝트 설정(Project Settings) > 기능 설정(Feature Settings) > 목 설정(Mock Settings)으로 이동합니다. Cloud Mock을 켙니다. 이 스위치는 Apidog에 목을 로컬에서만 제공하는 대신, 항상 켜져 있는 서비스에 호스팅하도록 지시합니다.
이 작업은 프로젝트당 한 번만 수행합니다. 켠 후에는 프로젝트의 모든 엔드포인트가 로컬 URL과 함께 클라우드 목 URL을 얻게 됩니다.
2단계: 클라우드 목 URL 복사
공유하려는 엔드포인트, 이 경우 GET /users를 엽니다. 목(Mock) 탭으로 이동하여 클라우드 목 URL을 복사합니다. 다음과 같은 형태를 얻게 될 것입니다:
https://mock.apidog.com/m1/2689726-0-default/users?apidogToken=GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi
경로 구조는 mock.apidog.com/m1/<projectId>-<num>-<env>/<path> 패턴을 따릅니다. Apidog가 자동으로 생성하므로 직접 조립할 필요가 없습니다. 문서는 고정된 템플릿을 게시하는 대신 예시를 통해 이를 보여주므로, 직접 구성하려고 시도하기보다는 복사된 URL을 진실의 원천으로 취급하십시오.
3단계: Apidog 내에서 즉시 목 테스트
URL을 누구에게든 넘겨주기 전에 예상대로 반환되는지 확인하세요. 동일한 목(Mock) 탭에서 목 URL에 테스트 요청을 보냅니다. Apidog는 요청을 실행하고 바로 응답을 보여줍니다. 생성된 데이터가 올바른지 즉시 확인할 수 있습니다.
GET /users 목은 다음과 같이 돌아올 수 있습니다:
[
{
"id": 1,
"name": "Amelia Turner",
"email": "amelia.turner@example.com",
"city": "Portland"
},
{
"id": 2,
"name": "Marcus Bell",
"email": "marcus.bell@example.com",
"city": "Austin"
}
]
이 값들은 하드코딩된 것이 아닙니다. Apidog는 스키마의 필드 이름과 유형을 읽고 이에 맞는 그럴듯한 데이터를 생성하는데, 이것이 목이 실제와 같은 테이블을 렌더링하는 프런트엔드에 유용한 이유입니다.
4단계: 브라우저에서 URL 열기
GET 요청의 경우, 클라우드 목 URL은 웹 브라우저에서 직접 작동합니다. 주소창에 붙여넣으면 JSON 응답을 볼 수 있습니다. 이것은 비기술적 이해관계자에게 가장 빠르게 제공할 수 있는 정상 작동 확인입니다: 클라이언트도, 컬도 필요 없이, 데이터만 반환하는 링크 하나면 됩니다.
빠른 확인 이상을 위해서는 프런트엔드가 다른 엔드포인트와 마찬가지로 호출합니다:
curl "https://mock.apidog.com/m1/2689726-0-default/users?apidogToken=GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi"
이것이 전체 루프입니다. 엔드포인트를 설계하고, Cloud Mock을 활성화하고, URL을 복사하면 팀의 작업이 막힘없이 진행됩니다.
토큰 인증으로 목 보호하기
공개 URL은 편리하지만, 때로는 너무 편리합니다. 목이 아직 출시되지 않은 기능이나 노출하고 싶지 않은 파트너 통합을 반영하는 경우, 이를 게이트할 수 있습니다.
프로젝트 설정(Project Settings) > 기능 설정(Feature Settings) > 목 설정(Mock Settings)으로 이동하여 접근 권한을 토큰 인증(Token Authentication)으로 설정합니다. 이 설정을 켜면 모든 요청에는 유효한 apidogToken이 포함되어야 하며, 토큰이 없는 요청은 거부됩니다. 토큰을 제공하는 방법은 세 가지입니다:
복사된 URL에서 이미 사용하고 있는 URL 쿼리 문자열 매개변수로:
curl "https://mock.apidog.com/m1/2689726-0-default/users?apidogToken=GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi"
토큰을 URL과 서버 로그에서 제외하는 요청 헤더로:
curl "https://mock.apidog.com/m1/2689726-0-default/users" \
-H "apidogToken: GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi"
또는 form-data 또는 x-www-form-urlencoded 요청에서 apidogToken이라는 이름의 본문 매개변수로, 이는 폼 본문을 전송하는 클라이언트에 적합합니다.
프런트엔드 코드의 경우 헤더 방식이 일반적으로 가장 깔끔합니다. 이는 전체 URL을 로깅하는 어떤 곳에서도 토큰을 제외시키고, 자격 증명을 리소스 경로와 분리합니다:
const res = await fetch(
"https://mock.apidog.com/m1/2689726-0-default/users",
{ headers: { apidogToken: "GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi" } }
);
const users = await res.json();
계획해야 할 한 가지: 이미 일반 URL을 공유한 후 토큰 인증을 활성화하면, 모든 소비자는 토큰을 추가해야 하며 그렇지 않으면 호출이 실패하기 시작합니다. 전환을 조율하여 QA와 파트너가 거부된 요청을 멍하니 바라보지 않도록 하십시오.
로케일을 사용하여 실제와 같은, 지역을 인식하는 데이터 생성
모든 레코드에 대해 "name": "string"을 반환하는 목은 UI에 아무것도 가르쳐주지 않습니다. 실제와 같은 이름, 주소, 전화번호를 반환하는 목은 실제 데이터가 도착하기 전에 프런트엔드가 레이아웃 버그, 텍스트 오버플로, 서식 문제를 파악할 수 있도록 합니다. Apidog는 Faker.js를 기반으로 이를 처리하며, 로케일 컨트롤은 국제 제품에 정말 유용합니다.
기본 로케일 작동 방식
기본적으로 Faker는 프로젝트의 언어 설정을 따릅니다. 이는 프로젝트 설정(Project Settings) > 기본 설정(Basic Settings)에서 구성되며, 거기서 선택한 언어가 생성된 모든 목 값의 기본 로케일이 됩니다. 프로젝트를 프랑스어로 설정하면 목 이름과 주소가 필드별 작업 없이 프랑스어 스타일로 반환됩니다.
전체 프로젝트에 대한 로케일 재정의
프로젝트 언어와 다른 특정 로케일의 목 데이터를 원한다면 이를 재정의할 수 있습니다. 프로젝트 설정(Project Settings) > 기능 설정(Feature Settings) > 목 설정(Mock Settings)으로 이동하여 드롭다운에서 Faker 로케일을 선택합니다. 이 재정의는 프로젝트의 모든 필드에 대해 기본 설정(Basic Settings) 언어 기본값을 이깁니다.
이는 국제화 테스트 시 유용합니다. 프로젝트 로케일을 일본으로 지정하면 생성된 모든 주소, 이름, 전화번호가 해당 지역을 반영하여 UI가 비라틴 스크립트 및 다른 주소 형식에 어떻게 반응하는지 확인할 수 있습니다. 이러한 스키마 인식 데이터를 자동 생성하는 것은 그 자체로 중요한 주제이며, Apidog의 스마트 목과 스키마를 읽는 방법에 대한 설명은 생성 측면을 자세히 다룹니다.
필드별 로케일 재정의
때로는 다른 필드와 다른 로케일의 필드가 필요할 수 있습니다. 예를 들어, 지역이 혼합된 고객 목록이 있을 수 있습니다. locale parameter를 사용하여 목 표현식에서 바로 로케일을 설정할 수 있습니다:
{{$person.fullName(locale='ja')}}
이는 해당 필드에 대해서만 田中 太郎와 같은 일본어 이름을 출력하고, 나머지 응답은 프로젝트 로케일을 따릅니다. 우선순위는 세 단계로 작동합니다: 필드 수준 로케일이 프로젝트 수준 로케일을 재정의하고, 프로젝트 수준 로케일이 기본 설정(Basic Settings) 언어 기본값을 재정의합니다. 따라서 합리적인 프로젝트 기본값을 설정하고, 예외가 필요한 경우에만 필드 수준 재정의를 사용합니다.
범위에 대한 솔직한 참고: 문서는 ja를 예시로 보여주며 지원되는 로케일의 전체 목록을 게시하지 않으므로, 의존하기 전에 Apidog 목 문서에서 대상 지역의 정확한 코드를 확인하십시오. Faker 자체의 규칙은 Faker.js 로케일 참조에 문서화되어 있습니다.
시간대도 일치시키기
시간에 대한 병렬 제어도 있습니다. 프로젝트 수준 기본값은 프로젝트 설정(Project Settings) > 기능 설정(Feature Settings) > 목 설정(Mock Settings)에 있으며, 목 표현식 내의 timeZone parameter를 사용하여 필드별로 재정의할 수 있습니다. UI가 타임스탬프를 렌더링하는 경우, 이는 생성된 createdAt 값을 서버 위치의 기본값 대신 시뮬레이션하는 지역과 일치시킵니다.
로케일과 시간대 컨트롤 사이에서, 동일한 엔드포인트 스키마에서 일본 사용자 기반, 독일 사용자 기반 또는 혼합된 국제 사용자 기반을 설득력 있게 모방하는 목을 설정할 수 있습니다. 이로 인해 잠금 해제되는 더 넓은 시나리오 세트에 대해서는 실용적인 API 목킹 사용 사례에 대한 요약도 참고할 가치가 있습니다.
클라우드 목 대 자체 호스팅 목
Cloud Mock은 Apidog의 호스팅 옵션이며 대부분의 팀을 커버합니다. 조직에 데이터 상주 규칙이 있거나 공급업체의 클라우드를 통한 테스트 트래픽 라우팅에 반대하는 정책이 있는 경우, Apidog는 자체 인프라에서 목 서비스를 실행하는 것도 지원합니다. 트레이드오프는 간단합니다: 클라우드 옵션은 설정이 필요 없고 항상 켜져 있는 반면, 자체 호스팅은 서비스를 직접 실행하는 비용으로 제어권을 제공합니다. 이러한 상황이라면 Apidog 목 서버 자체 호스팅 가이드가 이를 안내합니다. 호스팅 옵션을 나란히 비교하는 팀을 위해 온라인 API 목킹 도구 비교가 전반적인 상황을 설명합니다.
플랜 게이팅에 대한 솔직한 답변: 여기에 문서화된 Cloud Mock 및 로케일 기능은 특정 플랜 요구 사항을 명시하지 않으므로, 블로그 게시물의 숫자를 참고하기보다는 자신의 계정에서 현재 가용성을 확인하는 것이 솔직한 접근 방식입니다. Apidog 다운로드하여 워크플로를 처음부터 끝까지 시도하여 작업 공간에 무엇이 포함되어 있는지 정확히 확인할 수 있습니다.
Apidog CLI로 워크플로 자동화
Apidog에서의 목킹은 GUI 및 클라우드 기능입니다. 목 응답은 엔드포인트 스키마에서 자동으로 생성되며, 터미널에서 실행하는 어떤 것도 아닌 Apidog의 호스팅 엔진에 의해 서비스됩니다. 따라서 솔직히 말하면: Apidog CLI는 목 서버를 시작하거나 서비스하지 않습니다. 대신 목 입력이 정확하게 유지되도록 합니다.
CLI 및 Cursor 또는 Claude Code와 같은 AI 코딩 에이전트는 프로젝트의 엔드포인트와 스키마를 생성하고 업데이트할 수 있습니다. 클라우드 목이 해당 스키마를 읽어 데이터를 생성하므로, 사양을 최신 상태로 유지하면 API가 진화함에 따라 목 출력이 정확하게 유지됩니다. 에이전트 도구를 사용하여 필드를 추가하면, 수동 편집 없이도 목에 반영됩니다.
그런 다음, 목이 프런트엔드 작업을 막힘없이 진행하고 실제 백엔드가 배포되면, 동일한 프로젝트의 테스트 시나리오가 백엔드에 대해 헤드리스 방식으로 실행됩니다. CLI의 실행 명령은 목이 설명했던 동일한 계약에 대해 라이브 백엔드를 검증합니다:
apidog run -t <scenario_id> -e <env_id> -r cli
이 단일 명령은 저장된 테스트 시나리오를 환경에 대해 실행하고 결과를 보고하므로, UI를 막힘없이 진행시킨 목과 백엔드를 검증하는 테스트가 모두 하나의 진실의 원천으로 추적됩니다. Apidog에서 시나리오를 열고 -t 시나리오 ID와 -e 환경 ID가 이미 채워진 생성된 명령을 복사하여 플래그를 직접 조립하는 대신 사용하십시오. 이를 파이프라인에 연결하는 방법은 CI/CD 파이프라인에서 Apidog 실행 가이드에 설명되어 있습니다.
자주 묻는 질문
Apidog를 닫아도 클라우드 목 URL이 계속 작동하나요?
네, 그것이 바로 Cloud Mock의 핵심입니다. 호스팅 머신이 종료되면 응답을 멈추는 로컬 목과 달리, 클라우드 목은 Apidog의 인프라에서 서비스되며 24시간 연중무휴로 사용할 수 있습니다. 팀원들은 여러분의 컴퓨터가 켜져 있는지 여부와 관계없이 이를 사용할 수 있습니다.
브라우저에서 클라우드 목 URL을 직접 사용할 수 있나요?
GET 요청의 경우, 그렇습니다. apidogToken 쿼리 매개변수를 포함한 전체 URL을 주소창에 붙여넣으면 JSON 응답을 볼 수 있습니다. 다른 메서드나 토큰을 URL 기록에 남기지 않으려면 curl과 같은 도구나 프런트엔드 클라이언트를 사용하여 호출하고 토큰을 대신 헤더로 전달하십시오.
토큰을 포함하지 않는 요청은 어떻게 되나요?
접근 권한을 토큰 인증으로 설정한 경우, 유효한 apidogToken이 없는 모든 요청은 거부됩니다. 쿼리 문자열 매개변수, 요청 헤더 또는 폼 요청의 본문 매개변수로 제공해야 합니다. 일반 URL을 공유한 후 토큰 인증을 활성화한 경우, 팀원들에게 알려 호출이 실패하기 시작하기 전에 토큰을 추가하도록 하십시오.
특정 국가에 맞는 목 데이터를 얻으려면 어떻게 해야 하나요?
기본 설정(Basic Settings)에서 프로젝트 로케일을 설정하거나, 기능 설정(Feature Settings) > 목 설정(Mock Settings)에서 전체 프로젝트에 대해 재정의하거나, {{$person.fullName(locale='ja')}}와 같이 목 표현식에서 locale 매개변수를 사용하여 단일 필드를 재정의할 수 있습니다. 필드 수준이 프로젝트 수준을 이기고, 프로젝트 수준이 기본 설정(Basic Settings) 기본값을 이깁니다. 스마트 목 가이드는 스키마 인식 생성이 이와 어떻게 연결되는지 보여줍니다.
Cloud Mock과 헤드리스 목 도구 중 무엇을 사용해야 하나요?
Cloud Mock은 API 디자인에 연결된 호스팅된, 유지보수가 필요 없는 엔드포인트를 원하는 팀에 적합합니다. GUI가 전혀 없는 자동화된 빌드에 목을 포함해야 하는 경우, 헤드리스 API 목 도구 조사는 옵션과 각 옵션이 적합한 곳을 비교합니다. OpenAPI Initiative 사양은 대부분의 이러한 도구를 뒷받침하므로, 깔끔한 사양은 어떤 경로를 선택하든 이점을 제공합니다.
마무리
노트북에서만 작동하는 목은 단 한 사람의 작업만 가능하게 합니다. Cloud Mock은 이를 전체 팀이 구축할 수 있는 공개 mock.apidog.com URL로 바꿉니다. 필요할 때 토큰 인증으로 접근을 제어하고, 특정 지역에 맞는 실제와 같은 데이터가 필요할 때 로케일 컨트롤을 사용합니다. 엔드포인트를 설계하고, 토글을 켜고, 링크를 공유하면 프런트엔드는 더 이상 백엔드를 기다리지 않습니다. Apidog를 다운로드하여 첫 번째 공유 가능한 클라우드 목을 무료로, 신용 카드 없이 설정하십시오.