1. 전체 구조

{
  "name": "플로우 이름",                 // 플로우 제목 (필수)
  "description": "플로우 설명",          // 상세 설명 (선택)
  "version": "1.0",
  "config": {
    "baseUrl": "https://api.sam.kr/api/v1",
    "apiKey": "@{{$env.API_KEY}}",     // API 키 (선택)
    "timeout": 30000,
    "stopOnFailure": true
  },
  "variables": {
    "user_id": "@{{$env.FLOW_TESTER_USER_ID}}",  // 환경변수 참조
    "user_pwd": "@{{$env.FLOW_TESTER_USER_PWD}}"
  },
  "steps": [...]
}

2. Step 구조

{
  "id": "step1",              // 고유 ID (필수)
  "name": "페이지 생성",        // 표시 이름 (필수)
  "description": "테스트용 페이지 생성",  // 설명 (선택)
  "dependsOn": [],            // 의존 스텝 ID 배열 (선택)
  "method": "POST",           // HTTP 메서드 (필수)
  "endpoint": "/item-master/pages",  // 엔드포인트 (필수)
  "headers": {},              // 추가 헤더 (선택)
  "body": {                   // 요청 바디 (선택)
    "page_name": "@{{variables.testPrefix}}Page"
  },
  "expect": {                 // 응답 검증 (선택)
    "status": [200, 201],
    "jsonPath": {
      "$.success": true
    }
  },
  "extract": {                // 변수 추출 (선택)
    "pageId": "$.data.id"
  },
  "continueOnFailure": false, // 실패 시 계속 여부 (기본: false)
  "delay": 0                  // 실행 전 대기 (ms, 기본: 0)
}

3. HTTP 메서드

메서드	용도	예시
`GET`	조회	목록, 상세
`POST`	생성	새 리소스
`PUT`	수정 (전체)	리소스 교체
`PATCH`	수정 (일부)	필드 수정
`DELETE`	삭제	리소스 삭제

변수 바인딩 문법

패턴	설명	예시
`@{{variables.xxx}}`	전역 변수	`@{{variables.testPrefix}}` → "TEST_"
`@{{stepN.xxx}}`	이전 스텝 추출값	`@{{step1.pageId}}` → 42
`@{{stepN.response.xxx}}`	이전 스텝 응답	`@{{step1.response.data.name}}`
`@{{$timestamp}}`	현재 타임스탬프	1701100800
`@{{$uuid}}`	랜덤 UUID	550e8400-e29b-...
`@{{$random:N}}`	N자리 랜덤 숫자	`@{{$random:6}}` → 482916
`@{{$date}}`	오늘 날짜	2025-11-27

Faker 변수 (랜덤 데이터 생성)

Create API 테스트 시 임의의 테스트 데이터를 자동 생성합니다. @{{$faker.타입}} 형식으로 사용합니다.

패턴	설명	예시 결과
텍스트
`@{{$faker.name}}`	랜덤 이름	김철수
`@{{$faker.company}}`	랜덤 회사명	삼성전자
`@{{$faker.email}}`	랜덤 이메일	test@example.com
`@{{$faker.phone}}`	랜덤 전화번호	010-1234-5678
`@{{$faker.sentence}}`	랜덤 문장	테스트용 설명 문장입니다.
숫자/가격
`@{{$faker.number:MIN:MAX}}`	범위 내 정수	`@{{$faker.number:1:100}}` → 42
`@{{$faker.price:MIN:MAX}}`	범위 내 가격	`@{{$faker.price:1000:50000}}` → 25430.50
`@{{$faker.quantity}}`	수량 (1~100)	25
코드/ID 생성
`@{{$faker.itemCode:PREFIX}}`	품목코드 생성	`@{{$faker.itemCode:TEST}}` → TEST-482916
`@{{$faker.code:PREFIX:LEN}}`	커스텀 코드	`@{{$faker.code:MAT:4}}` → MAT0042
`@{{$faker.sku}}`	SKU 코드	SKU-AB123
`@{{$faker.barcode}}`	바코드 (EAN13)	4006381333931
품목 관련
`@{{$faker.productName}}`	제품명 (한글)	프리미엄 부품 Pro-425
`@{{$faker.unit}}`	단위	EA, SET, BOX, KG 등
`@{{$faker.category}}`	품목 카테고리	원자재, 부품, 반제품 등

사용 위치

endpoint: /pages/@{{step1.pageId}}/sections
body: "name": "@{{variables.testPrefix}}Page_@{{$timestamp}}"
headers: "X-Request-ID": "@{{$uuid}}"

Tip: extract로 추출한 값은 이후 스텝에서 @{{stepId.변수명}}으로 사용

expect.status - 상태 코드 검증

"expect": {
  "status": [200, 201]  // 허용 상태 코드 배열
}

expect.jsonPath - 응답 바디 검증

연산자	설명	예시
(직접 값)	정확한 값 비교	`"$.success": true`
`@exists`	존재 여부	`"$.data.id": "@exists"`
`@isNumber`	숫자 타입	`"$.data.id": "@isNumber"`
`@isString`	문자열 타입	`"$.data.name": "@isString"`
`@isArray`	배열 타입	`"$.data.items": "@isArray"`
`@notEmpty`	비어있지 않음	`"$.data.name": "@notEmpty"`
`@minLength:N`	최소 길이	`"$.data.items": "@minLength:1"`
`@gt:N`	N보다 큼	`"$.data.id": "@gt:0"`
`@regex:패턴`	정규식 매칭	`"$.data.code": "@regex:^[A-Z]+$"`
`@contains:값`	포함 여부	`"$.message": "@contains:success"`

extract - 값 추출

"extract": {
  "pageId": "$.data.id",           // 이후 @{{step1.pageId}}로 사용
  "pageName": "$.data.page_name",  // 이후 @{{step1.pageName}}로 사용
  "sections": "$.data.sections"    // 배열도 추출 가능
}