@cmarket/partner-sdk 35.0.0 → 36.1.0

package/dist/models/contract-document-item-dto.d.ts

@@ -1,45 +0,0 @@
-/**
- * CMARKET V6 Partner API
- * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.  ## 권한 — 두 개의 독립된 축 `403` 을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분할 것. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않는다. 범위 밖이면 스코프와 무관하게 403 이다.  대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것.  ## 성공 응답 봉투 `/v2` 의 모든 2xx 본문은 `{ \"data\": … }` 입니다. 단일 리소스든 목록이든 같습니다. 목록처럼 부가 정보가 있는 응답은 `meta` 가 함께 실립니다 — 예: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"…\" } }`. 부가 정보가 없으면 `meta` 키는 아예 나가지 않습니다(빈 객체를 싣지 않습니다).  봉투를 쓰지 않는 표면은 셋입니다. `/oauth/_*` 와 `/.well-known/_*` 는 각각 RFC 6749·RFC 8414·RFC 9728 이 최상위 필드를 규정하고, `/v1/_*` 은 동결된 레거시 표면이며, 파일 내용 응답은 본문이 JSON 이 아닙니다.  에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json 이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2` 의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified` 를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId` 와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId` 를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음).  `type` 은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**다. RFC 9457 §3.1.1 이 허용하는 대로 이 URI 는 **역참조(dereference)되지 않는다** — 브라우저로 열지 말고 문자열 비교로만 쓸 것. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 명시돼 있다. 새 slug 은 추가될 수 있으므로, 모르는 slug 을 만나면 `type` 이 아니라 **HTTP status 로 폴백**하도록 구현할 것.  ### 멱등성 위반: 409 와 422 의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**이다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받는다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈다. 재시도해도 영원히 같은 실패다. 새 키를 쓰거나 body 를 되돌릴 것.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나간다 — 신규 연동은 표준 필드를 쓸 것. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지한다.  `429` 에서는 `Retry-After`(초)가 우선한다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도할 것.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다.  ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시입니다. 폐지 일정이 정해지면 /v1 응답에 헤더 세 개가 실립니다 — `Deprecation`(RFC 9745, `@<epoch초>`) · `Sunset`(RFC 8594, HTTP-date) · `Link`(RFC 8288, `rel=\"deprecation\"`/`rel=\"sunset\"` — 이전 안내 문서를 가리킵니다). 일정이 정해지기 전에는 셋 다 나가지 않습니다.   종료일이 지난 뒤의 호출은 `404` 가 아니라 **`410 Gone`** 과 `type: …/endpoint-sunset` 으로 거절됩니다. 둘의 뜻이 다릅니다 — `404` 는 \"그런 것이 있었는지 모르겠다\", `410` 은 \"있었고 의도적으로 없앴다\" 입니다. `410` 을 받으면 경로 오타를 의심하지 말고 /v2 로 이전하세요. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
- *
- * The version of the OpenAPI document: 35.0.0
- * Contact: semo.io.kr@gmail.com
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-export interface ContractDocumentItemDto {
-    /**
-     * 공고번호 (V5 buy_idx — scsbidFile 이 행마다 방출하는 컬럼). 네 union 브랜치 전부가 `@iBidx` 로 제약되므로 상위 `bidNo` 와 항상 같은 값이다.
-     */
-    'bidNo': string;
-    /**
-     * 공고 회차 시퀀스 (V5 b2b_buy.buy_seq — scsbidFile i_bseq). 미해소 시 null.
-     */
-    'sequence': number | null;
-    /**
-     * 파일 순번/코드 (V5 entd_file_seq) — 위치 index 가 아니라 실코드. 날인문서는 11/12/13(회사직인·사업자등록증사본·입금통장사본), 서식은 b2b_paper_code 의 paper_code, 승낙사항 계열은 remap 후 4. 매 행 존재.
-     */
-    'fSeq': number;
-    /**
-     * 서류 종류 — V5 b2b_paper_code/b2b_contract_code 의 paper_name(한글). 운영자 편집 master 데이터라 고정 코드집합이 아닌 개방형 문자열.
-     */
-    'docType': string;
-    /**
-     * 서류 유형 코드 (V5 entd_file_type) — entd_file_seq 와 동일 실코드이며 매 행 채워진다(승낙사항 remap 시 seq/type 동시 4 치환).
-     */
-    'fileType': number | null;
-    /**
-     * 파일명. 미발급 시 null.
-     */
-    'fileName': string | null;
-    /**
-     * 파일 다운로드 URL — 만료 없는 안정 URL. GET 하면 실제 파일로 302 된다. 미발급 시 null.
-     */
-    'fileUrl': string | null;
-    /**
-     * fileUrl 과 동일 값(안정 URL). 미발급 시 null.
-     */
-    'fullUrl': string | null;
-}

package/dist/models/contract-document-item-dto.js

@@ -1,15 +0,0 @@
-"use strict";
-/* tslint:disable */
-/* eslint-disable */
-/**
- * CMARKET V6 Partner API
- * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.  ## 권한 — 두 개의 독립된 축 `403` 을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분할 것. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않는다. 범위 밖이면 스코프와 무관하게 403 이다.  대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것.  ## 성공 응답 봉투 `/v2` 의 모든 2xx 본문은 `{ \"data\": … }` 입니다. 단일 리소스든 목록이든 같습니다. 목록처럼 부가 정보가 있는 응답은 `meta` 가 함께 실립니다 — 예: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"…\" } }`. 부가 정보가 없으면 `meta` 키는 아예 나가지 않습니다(빈 객체를 싣지 않습니다).  봉투를 쓰지 않는 표면은 셋입니다. `/oauth/_*` 와 `/.well-known/_*` 는 각각 RFC 6749·RFC 8414·RFC 9728 이 최상위 필드를 규정하고, `/v1/_*` 은 동결된 레거시 표면이며, 파일 내용 응답은 본문이 JSON 이 아닙니다.  에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json 이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2` 의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified` 를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId` 와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId` 를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음).  `type` 은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**다. RFC 9457 §3.1.1 이 허용하는 대로 이 URI 는 **역참조(dereference)되지 않는다** — 브라우저로 열지 말고 문자열 비교로만 쓸 것. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 명시돼 있다. 새 slug 은 추가될 수 있으므로, 모르는 slug 을 만나면 `type` 이 아니라 **HTTP status 로 폴백**하도록 구현할 것.  ### 멱등성 위반: 409 와 422 의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**이다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받는다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈다. 재시도해도 영원히 같은 실패다. 새 키를 쓰거나 body 를 되돌릴 것.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나간다 — 신규 연동은 표준 필드를 쓸 것. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지한다.  `429` 에서는 `Retry-After`(초)가 우선한다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도할 것.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다.  ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시입니다. 폐지 일정이 정해지면 /v1 응답에 헤더 세 개가 실립니다 — `Deprecation`(RFC 9745, `@<epoch초>`) · `Sunset`(RFC 8594, HTTP-date) · `Link`(RFC 8288, `rel=\"deprecation\"`/`rel=\"sunset\"` — 이전 안내 문서를 가리킵니다). 일정이 정해지기 전에는 셋 다 나가지 않습니다.   종료일이 지난 뒤의 호출은 `404` 가 아니라 **`410 Gone`** 과 `type: …/endpoint-sunset` 으로 거절됩니다. 둘의 뜻이 다릅니다 — `404` 는 \"그런 것이 있었는지 모르겠다\", `410` 은 \"있었고 의도적으로 없앴다\" 입니다. `410` 을 받으면 경로 오타를 의심하지 말고 /v2 로 이전하세요. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
- *
- * The version of the OpenAPI document: 35.0.0
- * Contact: semo.io.kr@gmail.com
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/create-bid-v1-request-dto.d.ts

@@ -1,331 +0,0 @@
-/**
- * CMARKET V6 Partner API
- * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.  ## 권한 — 두 개의 독립된 축 `403` 을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분할 것. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않는다. 범위 밖이면 스코프와 무관하게 403 이다.  대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것.  ## 성공 응답 봉투 `/v2` 의 모든 2xx 본문은 `{ \"data\": … }` 입니다. 단일 리소스든 목록이든 같습니다. 목록처럼 부가 정보가 있는 응답은 `meta` 가 함께 실립니다 — 예: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"…\" } }`. 부가 정보가 없으면 `meta` 키는 아예 나가지 않습니다(빈 객체를 싣지 않습니다).  봉투를 쓰지 않는 표면은 셋입니다. `/oauth/_*` 와 `/.well-known/_*` 는 각각 RFC 6749·RFC 8414·RFC 9728 이 최상위 필드를 규정하고, `/v1/_*` 은 동결된 레거시 표면이며, 파일 내용 응답은 본문이 JSON 이 아닙니다.  에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json 이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2` 의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified` 를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId` 와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId` 를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음).  `type` 은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**다. RFC 9457 §3.1.1 이 허용하는 대로 이 URI 는 **역참조(dereference)되지 않는다** — 브라우저로 열지 말고 문자열 비교로만 쓸 것. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 명시돼 있다. 새 slug 은 추가될 수 있으므로, 모르는 slug 을 만나면 `type` 이 아니라 **HTTP status 로 폴백**하도록 구현할 것.  ### 멱등성 위반: 409 와 422 의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**이다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받는다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈다. 재시도해도 영원히 같은 실패다. 새 키를 쓰거나 body 를 되돌릴 것.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나간다 — 신규 연동은 표준 필드를 쓸 것. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지한다.  `429` 에서는 `Retry-After`(초)가 우선한다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도할 것.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다.  ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시입니다. 폐지 일정이 정해지면 /v1 응답에 헤더 세 개가 실립니다 — `Deprecation`(RFC 9745, `@<epoch초>`) · `Sunset`(RFC 8594, HTTP-date) · `Link`(RFC 8288, `rel=\"deprecation\"`/`rel=\"sunset\"` — 이전 안내 문서를 가리킵니다). 일정이 정해지기 전에는 셋 다 나가지 않습니다.   종료일이 지난 뒤의 호출은 `404` 가 아니라 **`410 Gone`** 과 `type: …/endpoint-sunset` 으로 거절됩니다. 둘의 뜻이 다릅니다 — `404` 는 \"그런 것이 있었는지 모르겠다\", `410` 은 \"있었고 의도적으로 없앴다\" 입니다. `410` 을 받으면 경로 오타를 의심하지 말고 /v2 로 이전하세요. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
- *
- * The version of the OpenAPI document: 35.0.0
- * Contact: semo.io.kr@gmail.com
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-import type { BidAttachmentV1Dto } from './bid-attachment-v1-dto';
-import type { BidDocumentV1Dto } from './bid-document-v1-dto';
-import type { BidItemV1Dto } from './bid-item-v1-dto';
-import type { BidManagerV1Dto } from './bid-manager-v1-dto';
-import type { HierarchicalRegionV1Dto } from './hierarchical-region-v1-dto';
-import type { PreconditionsV1Dto } from './preconditions-v1-dto';
-export interface CreateBidV1RequestDto {
-    /**
-     * 공고 명의 회원 ID(b2b_member.member_id). 한 파트너 키가 그룹 내 여러 회원 명의로 등록(멀티테넌트). 생략 시 backend 가 1:1 키 바인딩에서 명의를 완결한다(group 키는 필수 — 어느 명의인지 키가 못 정함).
-     */
-    'buyerId'?: string;
-    /**
-     * 공고 카테고리 (PRODUCT: 물품, CONSTRUCTION: 공사, SERVICE: 용역, SALES: 매각). backend BidCategoryType mirror.
-     */
-    'categoryType'?: CreateBidV1RequestDtoCategoryTypeEnum;
-    /**
-     * 공고명.
-     */
-    'projectName': string;
-    /**
-     * 공고 상세 내용. (저장 컬럼 buy_desc 는 무제한 — 상한 없음)
-     */
-    'noticeContent': string;
-    /**
-     * 예정금액(예산) 공개 여부.
-     */
-    'disclosePlannedAmount': boolean;
-    /**
-     * 공고 첨부파일 목록 — `{ fileKey, fileName? }` 객체 배열. fileKey 는 POST /v1/files 응답에서 받은 키다. **하위호환**: 원소를 fileKey 문자열로만 보내던 기존 요청(`[\"abc…\"]`)도 계속 수용하며, 이 경우 fileName 없이 등록된다.
-     */
-    'attachments'?: Array<BidAttachmentV1Dto>;
-    /**
-     * 품목 목록(1개 이상).
-     */
-    'items': Array<BidItemV1Dto>;
-    /**
-     * 총 예산금액(원, **부가세 별도**). 지정하면 items 합계(단가 × 수량)를 무시하고 이 값으로 배정예산을 정한다. 배정예산은 부가세 포함으로 표기하므로 서버가 부가세 10% 를 더해 원 단위로 반올림한 값을 저장한다 (예: 25,000,000 → 27,500,000). 부가세가 이미 포함된 금액을 보내면 이중 과세가 되니 공급가액을 보낼 것.
-     */
-    'totalBudget'?: number;
-    /**
-     * 낙찰 방법. A=최저가, B=적정가, C=최고가, D=최다수량, E=협상(임의), F=제한적최저가, H=협상(자동계산). backend AwardMethod mirror.
-     */
-    'awardMethod'?: CreateBidV1RequestDtoAwardMethodEnum;
-    /**
-     * 견적서 제출 조건. UNIT_AUTO=자동생성(단가), TOTAL_AUTO=자동생성(총액), FILE=직접첨부, NONE=미제출. backend BidQuoteCondition mirror.
-     */
-    'quoteCondition'?: CreateBidV1RequestDtoQuoteConditionEnum;
-    /**
-     * 예비가격 범위 (awardMethod=F 필수). A=±2%, B=±3%, C=±4%. backend BidPreliminaryPriceRegion mirror.
-     */
-    'preliminaryPriceRegion'?: CreateBidV1RequestDtoPreliminaryPriceRegionEnum;
-    /**
-     * 예비가격 선택수 (awardMethod=F 필수). 2/3/4 중 하나.
-     */
-    'preliminaryPriceCount'?: CreateBidV1RequestDtoPreliminaryPriceCountEnum;
-    /**
-     * 낙찰하한율(%) (awardMethod=F 필수). 0-100 범위.
-     */
-    'lowestBidPercent'?: number;
-    /**
-     * 배정비율(가격:기술 배점) (awardMethod=H 필수). 0=100:0 / 10=90:10 / 20=80:20 / 30=70:30. V5 부분집합이라 40/50 은 /v1 에서 거부된다(웹은 지원).
-     */
-    'negotiationBidRatio'?: CreateBidV1RequestDtoNegotiationBidRatioEnum;
-    /**
-     * 협상 기준 (awardMethod=H 필수). A=없음, B=차등점수제, C=원가절감적정성(→ negotiationStandardRatio 추가 필수). V5 부분집합이라 D(기타)는 /v1 에서 거부된다(웹은 지원).
-     */
-    'negotiationStandard'?: CreateBidV1RequestDtoNegotiationStandardEnum;
-    /**
-     * 기준금액비율 (negotiationStandard=C 필수). 60/70/80 중 하나.
-     */
-    'negotiationStandardRatio'?: CreateBidV1RequestDtoNegotiationStandardRatioEnum;
-    /**
-     * 참가자격 유형(V5 buy_style). A=전국경쟁, B=지명경쟁, C1=광역시도 지역제한, C2=시군구 지역제한. B 를 쓰면 `nomineeMemberIds` 가 필수다. backend BidQualificationStyle mirror.
-     */
-    'qualificationStyle'?: CreateBidV1RequestDtoQualificationStyleEnum;
-    /**
-     * 지명업체 회원 ID 목록 (V5 `buy_style_corpId`). `qualificationStyle=B`(지명경쟁) 일 때 **필수이며 1개 이상**이어야 한다 — 비어 있으면 아무도 응찰할 수 없는 공고가 된다. V5 는 콤마 구분 문자열이지만 v1 은 배열로 받는다(CSV 파싱은 계약이 아니다). B 가 아니면 무시된다. 상호(sangho)는 서버가 b2b_member 에서 파생하므로 보내지 않는다.
-     */
-    'nomineeMemberIds'?: Set<string>;
-    /**
-     * 지역제한 지역 목록 (qualificationStyle=C1/C2 시 사용).
-     */
-    'selectedRegions'?: Array<HierarchicalRegionV1Dto>;
-    /**
-     * 필수 면허 코드 목록.
-     */
-    'requiredLicenses'?: Array<string>;
-    /**
-     * 자격조건 추가 기입 (최대 1000자).
-     */
-    'preconditionDesc'?: string;
-    /**
-     * precondition 구조체. 조건 토큰 트리를 modern 명으로 표현. ACL이 backend conditions bag 으로 변환.
-     */
-    'preconditions'?: PreconditionsV1Dto;
-    /**
-     * 납품기한 유형. A=직접설정(deliveryDate 필요), B=계약후지정(deliveryPeriodDays 필요), C=계약후협의. backend BidDeliveryDateType mirror.
-     */
-    'deliveryDateType'?: CreateBidV1RequestDtoDeliveryDateTypeEnum;
-    /**
-     * 납품기한 일시 (deliveryDateType=A 시 사용). 형식: `YYYY-MM-DD-HH`(가이드 규정, 시 단위) 또는 `YYYY-MM-DD`(시 생략). 시(HH)는 잘라내지 않고 그대로 저장된다.
-     */
-    'deliveryDate'?: string;
-    /**
-     * 납품소요일(일) (deliveryDateType=B 시 사용). 최대 999일(backend deliveryDays 3자리 제한).
-     */
-    'deliveryPeriodDays'?: number;
-    /**
-     * 납품 방법. A=택배(직납가능), B=직접납품, C=납품및설치. backend BidDeliveryMethod mirror.
-     */
-    'deliveryMethod'?: CreateBidV1RequestDtoDeliveryMethodEnum;
-    /**
-     * 납품지 주소. V5 패리티로 **생략 가능**(`b2b_buy.buy_deli_location` 은 nullable) — 매각(SALES) 공고처럼 납품지가 없는 건이 있다. /v2 는 필수.
-     */
-    'deliveryAddress'?: string;
-    /**
-     * 결제 방법. A=현금, B=카드. backend BidPaymentMethod mirror.
-     */
-    'paymentMethod'?: CreateBidV1RequestDtoPaymentMethodEnum;
-    /**
-     * 대금지급 기한(일). 숫자만.
-     */
-    'paymentDays': string;
-    /**
-     * 제출 서류 목록(1개 이상).
-     */
-    'documents': Array<BidDocumentV1Dto>;
-    /**
-     * 과세 유형. A=과세, B=면세, C=면세(의제매입). backend BidTaxationType mirror.
-     */
-    'taxationType'?: CreateBidV1RequestDtoTaxationTypeEnum;
-    /**
-     * 수의계약 여부. Y=수의계약, N=일반.
-     */
-    'isOptionalContract'?: CreateBidV1RequestDtoIsOptionalContractEnum;
-    /**
-     * 입찰방식 (V5 buy_method). N=전자입찰, Y=역경매. 공사/용역/매각(CONSTRUCTION/SERVICE/SALES)은 backend 가 N 강제. 생략 시 N(전자입찰). backend BidType mirror.
-     */
-    'bidMethod'?: CreateBidV1RequestDtoBidMethodEnum;
-    /**
-     * 연간계약 여부. Y=연간계약, N=일반. (backend 갭1: annual_contract)
-     */
-    'isAnnualContract'?: CreateBidV1RequestDtoIsAnnualContractEnum;
-    /**
-     * 지명계약 여부. Y=지명계약(등록 시 검수대기 status=R 라우팅), N=일반. 지명업체 리스트는 미지원(V5 에도 없음) — Y/N 플래그만. (V5 nominated_contract 패리티)
-     */
-    'nominatedContract'?: CreateBidV1RequestDtoNominatedContractEnum;
-    /**
-     * 발주기관 담당자 사번 (V5 emp_id). 외부 ERP 담당자 식별자.
-     */
-    'empId'?: string;
-    /**
-     * 발주처 지정 조달번호 (V5 bid_puchase_no). 외부 ERP 자체 PO 번호. 동일 PO 의 선행 입찰이 전부 취소/유찰이면 재입찰로 새 번호가 채번되고, 진행 중이면 중복으로 거부된다. (V5 again_chk 패리티)
-     */
-    'purchaseNo'?: string;
-    /**
-     * 결과 공개 여부. Y=공개, N=비공개.
-     */
-    'isResultPublished'?: CreateBidV1RequestDtoIsResultPublishedEnum;
-    /**
-     * 긴급입찰 여부 (V5 urgent_yn). Y=긴급, N=일반. 생략 시 N. → b2b_buy.urgent_yn.
-     */
-    'urgentYn'?: CreateBidV1RequestDtoUrgentYnEnum;
-    /**
-     * 사업자등록번호 override (V5 bid_bizrno). 생략 시 backend 가 명의 회원의 사업자번호를 스냅샷한다(COALESCE). 외부 ERP 가 발주처 사업자번호를 명시할 때만 전달. → b2b_buy.bid_bizrno.
-     */
-    'businessRegistrationNo'?: string;
-    /**
-     * 발표평가(현장설명) 실시 여부 (V5 presentation_exec). true=실시, false=미실시. 공사/용역(gjy_ok=G/CONSTRUCTION) 맥락. → b2b_buy.presentation_exec.
-     */
-    'presentationEval'?: boolean;
-    /**
-     * 발표평가(현장설명) 장소·시간 비고 (V5 presentation_note). → b2b_buy.presentation_note.
-     */
-    'presentationNote'?: string;
-    /**
-     * 상품코드 기반 자동단가 견적 flag (V5 by_product_code). Y=KCL shop_product 코드기반 자동단가. ⚠️ partner-api 충실(faithful) 등록 경로는 by_product_code 컬럼을 적재하지 않음 — backend gateway 까지만 전달되고 b2b_buy 에는 미반영(향후 연결).
-     */
-    'byProductCode'?: CreateBidV1RequestDtoByProductCodeEnum;
-    /**
-     * 계약 담당자. email 은 필수(가이드 mem_email).
-     */
-    'contractManager': BidManagerV1Dto;
-    /**
-     * 기술 담당자.
-     */
-    'techManager': BidManagerV1Dto;
-    /**
-     * 입찰 시작 일시(ISO-8601 UTC).
-     */
-    'bidStartAt': string;
-    /**
-     * 입찰 마감 일시(ISO-8601 UTC).
-     */
-    'bidEndAt': string;
-    /**
-     * 임시저장 여부. true=임시저장(b2b_buy_imsi), false/undefined=공식등록(b2b_buy).
-     */
-    'isTemp'?: boolean;
-}
-export declare const CreateBidV1RequestDtoCategoryTypeEnum: {
-    readonly Product: "PRODUCT";
-    readonly Construction: "CONSTRUCTION";
-    readonly Service: "SERVICE";
-    readonly Sales: "SALES";
-};
-export type CreateBidV1RequestDtoCategoryTypeEnum = typeof CreateBidV1RequestDtoCategoryTypeEnum[keyof typeof CreateBidV1RequestDtoCategoryTypeEnum];
-export declare const CreateBidV1RequestDtoAwardMethodEnum: {
-    readonly A: "A";
-    readonly B: "B";
-    readonly C: "C";
-    readonly D: "D";
-    readonly E: "E";
-    readonly F: "F";
-    readonly H: "H";
-};
-export type CreateBidV1RequestDtoAwardMethodEnum = typeof CreateBidV1RequestDtoAwardMethodEnum[keyof typeof CreateBidV1RequestDtoAwardMethodEnum];
-export declare const CreateBidV1RequestDtoQuoteConditionEnum: {
-    readonly UnitAuto: "UNIT_AUTO";
-    readonly TotalAuto: "TOTAL_AUTO";
-    readonly File: "FILE";
-    readonly None: "NONE";
-};
-export type CreateBidV1RequestDtoQuoteConditionEnum = typeof CreateBidV1RequestDtoQuoteConditionEnum[keyof typeof CreateBidV1RequestDtoQuoteConditionEnum];
-export declare const CreateBidV1RequestDtoPreliminaryPriceRegionEnum: {
-    readonly A: "A";
-    readonly B: "B";
-    readonly C: "C";
-};
-export type CreateBidV1RequestDtoPreliminaryPriceRegionEnum = typeof CreateBidV1RequestDtoPreliminaryPriceRegionEnum[keyof typeof CreateBidV1RequestDtoPreliminaryPriceRegionEnum];
-export declare const CreateBidV1RequestDtoPreliminaryPriceCountEnum: {
-    readonly NUMBER_2: 2;
-    readonly NUMBER_3: 3;
-    readonly NUMBER_4: 4;
-};
-export type CreateBidV1RequestDtoPreliminaryPriceCountEnum = typeof CreateBidV1RequestDtoPreliminaryPriceCountEnum[keyof typeof CreateBidV1RequestDtoPreliminaryPriceCountEnum];
-export declare const CreateBidV1RequestDtoNegotiationBidRatioEnum: {
-    readonly NUMBER_0: 0;
-    readonly NUMBER_10: 10;
-    readonly NUMBER_20: 20;
-    readonly NUMBER_30: 30;
-};
-export type CreateBidV1RequestDtoNegotiationBidRatioEnum = typeof CreateBidV1RequestDtoNegotiationBidRatioEnum[keyof typeof CreateBidV1RequestDtoNegotiationBidRatioEnum];
-export declare const CreateBidV1RequestDtoNegotiationStandardEnum: {
-    readonly A: "A";
-    readonly B: "B";
-    readonly C: "C";
-};
-export type CreateBidV1RequestDtoNegotiationStandardEnum = typeof CreateBidV1RequestDtoNegotiationStandardEnum[keyof typeof CreateBidV1RequestDtoNegotiationStandardEnum];
-export declare const CreateBidV1RequestDtoNegotiationStandardRatioEnum: {
-    readonly NUMBER_60: 60;
-    readonly NUMBER_70: 70;
-    readonly NUMBER_80: 80;
-};
-export type CreateBidV1RequestDtoNegotiationStandardRatioEnum = typeof CreateBidV1RequestDtoNegotiationStandardRatioEnum[keyof typeof CreateBidV1RequestDtoNegotiationStandardRatioEnum];
-export declare const CreateBidV1RequestDtoQualificationStyleEnum: {
-    readonly A: "A";
-    readonly B: "B";
-    readonly C1: "C1";
-    readonly C2: "C2";
-};
-export type CreateBidV1RequestDtoQualificationStyleEnum = typeof CreateBidV1RequestDtoQualificationStyleEnum[keyof typeof CreateBidV1RequestDtoQualificationStyleEnum];
-export declare const CreateBidV1RequestDtoDeliveryDateTypeEnum: {
-    readonly A: "A";
-    readonly B: "B";
-    readonly C: "C";
-};
-export type CreateBidV1RequestDtoDeliveryDateTypeEnum = typeof CreateBidV1RequestDtoDeliveryDateTypeEnum[keyof typeof CreateBidV1RequestDtoDeliveryDateTypeEnum];
-export declare const CreateBidV1RequestDtoDeliveryMethodEnum: {
-    readonly A: "A";
-    readonly B: "B";
-    readonly C: "C";
-};
-export type CreateBidV1RequestDtoDeliveryMethodEnum = typeof CreateBidV1RequestDtoDeliveryMethodEnum[keyof typeof CreateBidV1RequestDtoDeliveryMethodEnum];
-export declare const CreateBidV1RequestDtoPaymentMethodEnum: {
-    readonly A: "A";
-    readonly B: "B";
-};
-export type CreateBidV1RequestDtoPaymentMethodEnum = typeof CreateBidV1RequestDtoPaymentMethodEnum[keyof typeof CreateBidV1RequestDtoPaymentMethodEnum];
-export declare const CreateBidV1RequestDtoTaxationTypeEnum: {
-    readonly A: "A";
-    readonly B: "B";
-    readonly C: "C";
-};
-export type CreateBidV1RequestDtoTaxationTypeEnum = typeof CreateBidV1RequestDtoTaxationTypeEnum[keyof typeof CreateBidV1RequestDtoTaxationTypeEnum];
-export declare const CreateBidV1RequestDtoIsOptionalContractEnum: {
-    readonly Y: "Y";
-    readonly N: "N";
-};
-export type CreateBidV1RequestDtoIsOptionalContractEnum = typeof CreateBidV1RequestDtoIsOptionalContractEnum[keyof typeof CreateBidV1RequestDtoIsOptionalContractEnum];
-export declare const CreateBidV1RequestDtoBidMethodEnum: {
-    readonly Y: "Y";
-    readonly N: "N";
-};
-export type CreateBidV1RequestDtoBidMethodEnum = typeof CreateBidV1RequestDtoBidMethodEnum[keyof typeof CreateBidV1RequestDtoBidMethodEnum];
-export declare const CreateBidV1RequestDtoIsAnnualContractEnum: {
-    readonly Y: "Y";
-    readonly N: "N";
-};
-export type CreateBidV1RequestDtoIsAnnualContractEnum = typeof CreateBidV1RequestDtoIsAnnualContractEnum[keyof typeof CreateBidV1RequestDtoIsAnnualContractEnum];
-export declare const CreateBidV1RequestDtoNominatedContractEnum: {
-    readonly Y: "Y";
-    readonly N: "N";
-};
-export type CreateBidV1RequestDtoNominatedContractEnum = typeof CreateBidV1RequestDtoNominatedContractEnum[keyof typeof CreateBidV1RequestDtoNominatedContractEnum];
-export declare const CreateBidV1RequestDtoIsResultPublishedEnum: {
-    readonly Y: "Y";
-    readonly N: "N";
-};
-export type CreateBidV1RequestDtoIsResultPublishedEnum = typeof CreateBidV1RequestDtoIsResultPublishedEnum[keyof typeof CreateBidV1RequestDtoIsResultPublishedEnum];
-export declare const CreateBidV1RequestDtoUrgentYnEnum: {
-    readonly Y: "Y";
-    readonly N: "N";
-};
-export type CreateBidV1RequestDtoUrgentYnEnum = typeof CreateBidV1RequestDtoUrgentYnEnum[keyof typeof CreateBidV1RequestDtoUrgentYnEnum];
-export declare const CreateBidV1RequestDtoByProductCodeEnum: {
-    readonly Y: "Y";
-    readonly N: "N";
-};
-export type CreateBidV1RequestDtoByProductCodeEnum = typeof CreateBidV1RequestDtoByProductCodeEnum[keyof typeof CreateBidV1RequestDtoByProductCodeEnum];

package/dist/models/create-bid-v1-request-dto.js

@@ -1,116 +0,0 @@
-"use strict";
-/* tslint:disable */
-/* eslint-disable */
-/**
- * CMARKET V6 Partner API
- * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.  ## 권한 — 두 개의 독립된 축 `403` 을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분할 것. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않는다. 범위 밖이면 스코프와 무관하게 403 이다.  대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것.  ## 성공 응답 봉투 `/v2` 의 모든 2xx 본문은 `{ \"data\": … }` 입니다. 단일 리소스든 목록이든 같습니다. 목록처럼 부가 정보가 있는 응답은 `meta` 가 함께 실립니다 — 예: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"…\" } }`. 부가 정보가 없으면 `meta` 키는 아예 나가지 않습니다(빈 객체를 싣지 않습니다).  봉투를 쓰지 않는 표면은 셋입니다. `/oauth/_*` 와 `/.well-known/_*` 는 각각 RFC 6749·RFC 8414·RFC 9728 이 최상위 필드를 규정하고, `/v1/_*` 은 동결된 레거시 표면이며, 파일 내용 응답은 본문이 JSON 이 아닙니다.  에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json 이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2` 의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified` 를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId` 와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId` 를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음).  `type` 은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**다. RFC 9457 §3.1.1 이 허용하는 대로 이 URI 는 **역참조(dereference)되지 않는다** — 브라우저로 열지 말고 문자열 비교로만 쓸 것. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 명시돼 있다. 새 slug 은 추가될 수 있으므로, 모르는 slug 을 만나면 `type` 이 아니라 **HTTP status 로 폴백**하도록 구현할 것.  ### 멱등성 위반: 409 와 422 의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**이다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받는다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈다. 재시도해도 영원히 같은 실패다. 새 키를 쓰거나 body 를 되돌릴 것.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나간다 — 신규 연동은 표준 필드를 쓸 것. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지한다.  `429` 에서는 `Retry-After`(초)가 우선한다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도할 것.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다.  ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시입니다. 폐지 일정이 정해지면 /v1 응답에 헤더 세 개가 실립니다 — `Deprecation`(RFC 9745, `@<epoch초>`) · `Sunset`(RFC 8594, HTTP-date) · `Link`(RFC 8288, `rel=\"deprecation\"`/`rel=\"sunset\"` — 이전 안내 문서를 가리킵니다). 일정이 정해지기 전에는 셋 다 나가지 않습니다.   종료일이 지난 뒤의 호출은 `404` 가 아니라 **`410 Gone`** 과 `type: …/endpoint-sunset` 으로 거절됩니다. 둘의 뜻이 다릅니다 — `404` 는 \"그런 것이 있었는지 모르겠다\", `410` 은 \"있었고 의도적으로 없앴다\" 입니다. `410` 을 받으면 경로 오타를 의심하지 말고 /v2 로 이전하세요. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
- *
- * The version of the OpenAPI document: 35.0.0
- * Contact: semo.io.kr@gmail.com
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CreateBidV1RequestDtoByProductCodeEnum = exports.CreateBidV1RequestDtoUrgentYnEnum = exports.CreateBidV1RequestDtoIsResultPublishedEnum = exports.CreateBidV1RequestDtoNominatedContractEnum = exports.CreateBidV1RequestDtoIsAnnualContractEnum = exports.CreateBidV1RequestDtoBidMethodEnum = exports.CreateBidV1RequestDtoIsOptionalContractEnum = exports.CreateBidV1RequestDtoTaxationTypeEnum = exports.CreateBidV1RequestDtoPaymentMethodEnum = exports.CreateBidV1RequestDtoDeliveryMethodEnum = exports.CreateBidV1RequestDtoDeliveryDateTypeEnum = exports.CreateBidV1RequestDtoQualificationStyleEnum = exports.CreateBidV1RequestDtoNegotiationStandardRatioEnum = exports.CreateBidV1RequestDtoNegotiationStandardEnum = exports.CreateBidV1RequestDtoNegotiationBidRatioEnum = exports.CreateBidV1RequestDtoPreliminaryPriceCountEnum = exports.CreateBidV1RequestDtoPreliminaryPriceRegionEnum = exports.CreateBidV1RequestDtoQuoteConditionEnum = exports.CreateBidV1RequestDtoAwardMethodEnum = exports.CreateBidV1RequestDtoCategoryTypeEnum = void 0;
-exports.CreateBidV1RequestDtoCategoryTypeEnum = {
-    Product: 'PRODUCT',
-    Construction: 'CONSTRUCTION',
-    Service: 'SERVICE',
-    Sales: 'SALES',
-};
-exports.CreateBidV1RequestDtoAwardMethodEnum = {
-    A: 'A',
-    B: 'B',
-    C: 'C',
-    D: 'D',
-    E: 'E',
-    F: 'F',
-    H: 'H',
-};
-exports.CreateBidV1RequestDtoQuoteConditionEnum = {
-    UnitAuto: 'UNIT_AUTO',
-    TotalAuto: 'TOTAL_AUTO',
-    File: 'FILE',
-    None: 'NONE',
-};
-exports.CreateBidV1RequestDtoPreliminaryPriceRegionEnum = {
-    A: 'A',
-    B: 'B',
-    C: 'C',
-};
-exports.CreateBidV1RequestDtoPreliminaryPriceCountEnum = {
-    NUMBER_2: 2,
-    NUMBER_3: 3,
-    NUMBER_4: 4,
-};
-exports.CreateBidV1RequestDtoNegotiationBidRatioEnum = {
-    NUMBER_0: 0,
-    NUMBER_10: 10,
-    NUMBER_20: 20,
-    NUMBER_30: 30,
-};
-exports.CreateBidV1RequestDtoNegotiationStandardEnum = {
-    A: 'A',
-    B: 'B',
-    C: 'C',
-};
-exports.CreateBidV1RequestDtoNegotiationStandardRatioEnum = {
-    NUMBER_60: 60,
-    NUMBER_70: 70,
-    NUMBER_80: 80,
-};
-exports.CreateBidV1RequestDtoQualificationStyleEnum = {
-    A: 'A',
-    B: 'B',
-    C1: 'C1',
-    C2: 'C2',
-};
-exports.CreateBidV1RequestDtoDeliveryDateTypeEnum = {
-    A: 'A',
-    B: 'B',
-    C: 'C',
-};
-exports.CreateBidV1RequestDtoDeliveryMethodEnum = {
-    A: 'A',
-    B: 'B',
-    C: 'C',
-};
-exports.CreateBidV1RequestDtoPaymentMethodEnum = {
-    A: 'A',
-    B: 'B',
-};
-exports.CreateBidV1RequestDtoTaxationTypeEnum = {
-    A: 'A',
-    B: 'B',
-    C: 'C',
-};
-exports.CreateBidV1RequestDtoIsOptionalContractEnum = {
-    Y: 'Y',
-    N: 'N',
-};
-exports.CreateBidV1RequestDtoBidMethodEnum = {
-    Y: 'Y',
-    N: 'N',
-};
-exports.CreateBidV1RequestDtoIsAnnualContractEnum = {
-    Y: 'Y',
-    N: 'N',
-};
-exports.CreateBidV1RequestDtoNominatedContractEnum = {
-    Y: 'Y',
-    N: 'N',
-};
-exports.CreateBidV1RequestDtoIsResultPublishedEnum = {
-    Y: 'Y',
-    N: 'N',
-};
-exports.CreateBidV1RequestDtoUrgentYnEnum = {
-    Y: 'Y',
-    N: 'N',
-};
-exports.CreateBidV1RequestDtoByProductCodeEnum = {
-    Y: 'Y',
-    N: 'N',
-};

package/dist/models/file-uploaded-v1-response-dto.d.ts

@@ -1,17 +0,0 @@
-/**
- * CMARKET V6 Partner API
- * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.  ## 권한 — 두 개의 독립된 축 `403` 을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분할 것. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않는다. 범위 밖이면 스코프와 무관하게 403 이다.  대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것.  ## 성공 응답 봉투 `/v2` 의 모든 2xx 본문은 `{ \"data\": … }` 입니다. 단일 리소스든 목록이든 같습니다. 목록처럼 부가 정보가 있는 응답은 `meta` 가 함께 실립니다 — 예: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"…\" } }`. 부가 정보가 없으면 `meta` 키는 아예 나가지 않습니다(빈 객체를 싣지 않습니다).  봉투를 쓰지 않는 표면은 셋입니다. `/oauth/_*` 와 `/.well-known/_*` 는 각각 RFC 6749·RFC 8414·RFC 9728 이 최상위 필드를 규정하고, `/v1/_*` 은 동결된 레거시 표면이며, 파일 내용 응답은 본문이 JSON 이 아닙니다.  에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json 이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2` 의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified` 를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId` 와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId` 를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음).  `type` 은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**다. RFC 9457 §3.1.1 이 허용하는 대로 이 URI 는 **역참조(dereference)되지 않는다** — 브라우저로 열지 말고 문자열 비교로만 쓸 것. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 명시돼 있다. 새 slug 은 추가될 수 있으므로, 모르는 slug 을 만나면 `type` 이 아니라 **HTTP status 로 폴백**하도록 구현할 것.  ### 멱등성 위반: 409 와 422 의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**이다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받는다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈다. 재시도해도 영원히 같은 실패다. 새 키를 쓰거나 body 를 되돌릴 것.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나간다 — 신규 연동은 표준 필드를 쓸 것. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지한다.  `429` 에서는 `Retry-After`(초)가 우선한다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도할 것.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다.  ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시입니다. 폐지 일정이 정해지면 /v1 응답에 헤더 세 개가 실립니다 — `Deprecation`(RFC 9745, `@<epoch초>`) · `Sunset`(RFC 8594, HTTP-date) · `Link`(RFC 8288, `rel=\"deprecation\"`/`rel=\"sunset\"` — 이전 안내 문서를 가리킵니다). 일정이 정해지기 전에는 셋 다 나가지 않습니다.   종료일이 지난 뒤의 호출은 `404` 가 아니라 **`410 Gone`** 과 `type: …/endpoint-sunset` 으로 거절됩니다. 둘의 뜻이 다릅니다 — `404` 는 \"그런 것이 있었는지 모르겠다\", `410` 은 \"있었고 의도적으로 없앴다\" 입니다. `410` 을 받으면 경로 오타를 의심하지 말고 /v2 로 이전하세요. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
- *
- * The version of the OpenAPI document: 35.0.0
- * Contact: semo.io.kr@gmail.com
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-export interface FileUploadedV1ResponseDto {
-    /**
-     * 업로드된 파일의 저장소 키. `POST /v1/bids` 의 attachments[] 에 그대로 사용.
-     */
-    'fileKey': string;
-}

package/dist/models/file-uploaded-v1-response-dto.js

@@ -1,15 +0,0 @@
-"use strict";
-/* tslint:disable */
-/* eslint-disable */
-/**
- * CMARKET V6 Partner API
- * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.  ## 권한 — 두 개의 독립된 축 `403` 을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분할 것. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않는다. 범위 밖이면 스코프와 무관하게 403 이다.  대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것.  ## 성공 응답 봉투 `/v2` 의 모든 2xx 본문은 `{ \"data\": … }` 입니다. 단일 리소스든 목록이든 같습니다. 목록처럼 부가 정보가 있는 응답은 `meta` 가 함께 실립니다 — 예: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"…\" } }`. 부가 정보가 없으면 `meta` 키는 아예 나가지 않습니다(빈 객체를 싣지 않습니다).  봉투를 쓰지 않는 표면은 셋입니다. `/oauth/_*` 와 `/.well-known/_*` 는 각각 RFC 6749·RFC 8414·RFC 9728 이 최상위 필드를 규정하고, `/v1/_*` 은 동결된 레거시 표면이며, 파일 내용 응답은 본문이 JSON 이 아닙니다.  에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json 이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2` 의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified` 를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId` 와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId` 를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음).  `type` 은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**다. RFC 9457 §3.1.1 이 허용하는 대로 이 URI 는 **역참조(dereference)되지 않는다** — 브라우저로 열지 말고 문자열 비교로만 쓸 것. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 명시돼 있다. 새 slug 은 추가될 수 있으므로, 모르는 slug 을 만나면 `type` 이 아니라 **HTTP status 로 폴백**하도록 구현할 것.  ### 멱등성 위반: 409 와 422 의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**이다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받는다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈다. 재시도해도 영원히 같은 실패다. 새 키를 쓰거나 body 를 되돌릴 것.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나간다 — 신규 연동은 표준 필드를 쓸 것. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지한다.  `429` 에서는 `Retry-After`(초)가 우선한다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도할 것.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다.  ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시입니다. 폐지 일정이 정해지면 /v1 응답에 헤더 세 개가 실립니다 — `Deprecation`(RFC 9745, `@<epoch초>`) · `Sunset`(RFC 8594, HTTP-date) · `Link`(RFC 8288, `rel=\"deprecation\"`/`rel=\"sunset\"` — 이전 안내 문서를 가리킵니다). 일정이 정해지기 전에는 셋 다 나가지 않습니다.   종료일이 지난 뒤의 호출은 `404` 가 아니라 **`410 Gone`** 과 `type: …/endpoint-sunset` 으로 거절됩니다. 둘의 뜻이 다릅니다 — `404` 는 \"그런 것이 있었는지 모르겠다\", `410` 은 \"있었고 의도적으로 없앴다\" 입니다. `410` 을 받으면 경로 오타를 의심하지 말고 /v2 로 이전하세요. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
- *
- * The version of the OpenAPI document: 35.0.0
- * Contact: semo.io.kr@gmail.com
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/hierarchical-region-v1-dto.d.ts

@@ -1,21 +0,0 @@
-/**
- * CMARKET V6 Partner API
- * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.  ## 권한 — 두 개의 독립된 축 `403` 을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분할 것. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않는다. 범위 밖이면 스코프와 무관하게 403 이다.  대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것.  ## 성공 응답 봉투 `/v2` 의 모든 2xx 본문은 `{ \"data\": … }` 입니다. 단일 리소스든 목록이든 같습니다. 목록처럼 부가 정보가 있는 응답은 `meta` 가 함께 실립니다 — 예: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"…\" } }`. 부가 정보가 없으면 `meta` 키는 아예 나가지 않습니다(빈 객체를 싣지 않습니다).  봉투를 쓰지 않는 표면은 셋입니다. `/oauth/_*` 와 `/.well-known/_*` 는 각각 RFC 6749·RFC 8414·RFC 9728 이 최상위 필드를 규정하고, `/v1/_*` 은 동결된 레거시 표면이며, 파일 내용 응답은 본문이 JSON 이 아닙니다.  에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json 이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2` 의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified` 를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId` 와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId` 를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음).  `type` 은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**다. RFC 9457 §3.1.1 이 허용하는 대로 이 URI 는 **역참조(dereference)되지 않는다** — 브라우저로 열지 말고 문자열 비교로만 쓸 것. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 명시돼 있다. 새 slug 은 추가될 수 있으므로, 모르는 slug 을 만나면 `type` 이 아니라 **HTTP status 로 폴백**하도록 구현할 것.  ### 멱등성 위반: 409 와 422 의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**이다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받는다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈다. 재시도해도 영원히 같은 실패다. 새 키를 쓰거나 body 를 되돌릴 것.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나간다 — 신규 연동은 표준 필드를 쓸 것. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지한다.  `429` 에서는 `Retry-After`(초)가 우선한다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도할 것.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다.  ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시입니다. 폐지 일정이 정해지면 /v1 응답에 헤더 세 개가 실립니다 — `Deprecation`(RFC 9745, `@<epoch초>`) · `Sunset`(RFC 8594, HTTP-date) · `Link`(RFC 8288, `rel=\"deprecation\"`/`rel=\"sunset\"` — 이전 안내 문서를 가리킵니다). 일정이 정해지기 전에는 셋 다 나가지 않습니다.   종료일이 지난 뒤의 호출은 `404` 가 아니라 **`410 Gone`** 과 `type: …/endpoint-sunset` 으로 거절됩니다. 둘의 뜻이 다릅니다 — `404` 는 \"그런 것이 있었는지 모르겠다\", `410` 은 \"있었고 의도적으로 없앴다\" 입니다. `410` 을 받으면 경로 오타를 의심하지 말고 /v2 로 이전하세요. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
- *
- * The version of the OpenAPI document: 35.0.0
- * Contact: semo.io.kr@gmail.com
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-export interface HierarchicalRegionV1Dto {
-    /**
-     * 광역시도명.
-     */
-    'province': string;
-    /**
-     * 시군구 목록 (빈 배열 = 광역시도 전체).
-     */
-    'districts': Array<string>;
-}