@cmarket/partner-sdk 33.0.0 → 34.0.0

package/README.md

@@ -13,7 +13,7 @@ CMARKET V6 Partner API 의 공식 클라이언트 SDK — 외부 ERP 가 입찰
 TypeScript / Node (npm):
 
 ```bash
-npm install @cmarket/partner-sdk@33.0.0
+npm install @cmarket/partner-sdk@34.0.0
 ```
 
 Java (Maven):
@@ -22,7 +22,7 @@ Java (Maven):
 <dependency>
   <groupId>net.c-market</groupId>
   <artifactId>partner-sdk</artifactId>
-  <version>33.0.0</version>
+  <version>34.0.0</version>
 </dependency>
 ```
 
@@ -375,7 +375,7 @@ CMARKET 운영팀에 등록해야 합니다(미등록 origin 은 iframe 로드
 
 ---
 
-## @cmarket/partner-sdk@33.0.0
+## @cmarket/partner-sdk@34.0.0
 
 This generator creates TypeScript/JavaScript client that utilizes [axios](https://github.com/axios/axios). The generated Node module can be used in the following environments:
 
@@ -413,7 +413,7 @@ navigate to the folder of your consuming project and run one of the following co
 _published:_
 
 ```
-npm install @cmarket/partner-sdk@33.0.0 --save
+npm install @cmarket/partner-sdk@34.0.0 --save
 ```
 
 _unPublished (not recommended):_
@@ -444,43 +444,43 @@ Class | Method | HTTP request | Description
 *PartnerV1Api* | [**v1SubmitNegotiationScores**](docs/PartnerV1Api.md#v1submitnegotiationscores) | **POST** /v1/awards/nego-eval | 협상(H/K) 점수평가 — V5 충실
 *PartnerV1Api* | [**v1UploadFile**](docs/PartnerV1Api.md#v1uploadfile) | **POST** /v1/files | 입찰 첨부파일 업로드(base64 또는 url) → fileKey
 *PartnerV2Api* | [**acknowledgeProductReceipt**](docs/PartnerV2Api.md#acknowledgeproductreceipt) | **POST** /v2/products/receipts | 물품 수신확인
-*PartnerV2Api* | [**cancelBid**](docs/PartnerV2Api.md#cancelbid) | **POST** /v2/bids/{bidId}/cancel | 공고 취소
-*PartnerV2Api* | [**completeAcceptance**](docs/PartnerV2Api.md#completeacceptance) | **POST** /v2/bids/{bidId}/acceptance | 검수완료 전송
-*PartnerV2Api* | [**completeInvoice**](docs/PartnerV2Api.md#completeinvoice) | **POST** /v2/bids/{bidId}/settlement/complete | 정산 마감(송장 강제완료)
+*PartnerV2Api* | [**cancelBid**](docs/PartnerV2Api.md#cancelbid) | **POST** /v2/bids/{bidRef}/cancel | 공고 취소
+*PartnerV2Api* | [**completeAcceptance**](docs/PartnerV2Api.md#completeacceptance) | **POST** /v2/bids/{bidRef}/acceptance | 검수완료 전송
+*PartnerV2Api* | [**completeInvoice**](docs/PartnerV2Api.md#completeinvoice) | **POST** /v2/bids/{bidRef}/settlement/complete | 정산 마감(송장 강제완료)
 *PartnerV2Api* | [**createCardPayment**](docs/PartnerV2Api.md#createcardpayment) | **POST** /v2/card-payments | 결제창 발행
-*PartnerV2Api* | [**createCardPaymentRequest**](docs/PartnerV2Api.md#createcardpaymentrequest) | **POST** /v2/card-payment-requests | 결제창 발행
+*PartnerV2Api* | [**createCardPaymentRequest**](docs/PartnerV2Api.md#createcardpaymentrequest) | **POST** /v2/card-payment-requests | 결제창 발행 (구 경로)
 *PartnerV2Api* | [**createExternalContractDocuments**](docs/PartnerV2Api.md#createexternalcontractdocuments) | **POST** /v2/contract-documents | 계약서류 생성
 *PartnerV2Api* | [**createWebhookEndpoint**](docs/PartnerV2Api.md#createwebhookendpoint) | **POST** /v2/webhook-endpoints | 웹훅 구독 등록
 *PartnerV2Api* | [**deleteWebhookEndpoint**](docs/PartnerV2Api.md#deletewebhookendpoint) | **DELETE** /v2/webhook-endpoints/{endpointId} | 웹훅 구독 삭제
 *PartnerV2Api* | [**downloadFile**](docs/PartnerV2Api.md#downloadfile) | **GET** /files/{fileKey} | 파일 다운로드 — 안정 URL(302)
-*PartnerV2Api* | [**getBid**](docs/PartnerV2Api.md#getbid) | **GET** /v2/bids/{bidId} | 공고 단건(라이프사이클) 조회
-*PartnerV2Api* | [**getBidResults**](docs/PartnerV2Api.md#getbidresults) | **GET** /v2/bids/{bidId}/result | 입찰 결과 조회
-*PartnerV2Api* | [**getBidSettlement**](docs/PartnerV2Api.md#getbidsettlement) | **GET** /v2/bids/{bidId}/settlement | 입찰결과 정산정보 조회
-*PartnerV2Api* | [**getBidStatement**](docs/PartnerV2Api.md#getbidstatement) | **GET** /v2/bids/{bidId}/statement | 거래명세서 조회
+*PartnerV2Api* | [**getBid**](docs/PartnerV2Api.md#getbid) | **GET** /v2/bids/{bidRef} | 공고 단건(라이프사이클) 조회
+*PartnerV2Api* | [**getBidResults**](docs/PartnerV2Api.md#getbidresults) | **GET** /v2/bids/{bidRef}/result | 공고 결과 조회
+*PartnerV2Api* | [**getBidSettlement**](docs/PartnerV2Api.md#getbidsettlement) | **GET** /v2/bids/{bidRef}/settlement | 정산 정보 조회
+*PartnerV2Api* | [**getBidStatement**](docs/PartnerV2Api.md#getbidstatement) | **GET** /v2/bids/{bidRef}/statement | 거래명세서 조회
 *PartnerV2Api* | [**getFileMeta**](docs/PartnerV2Api.md#getfilemeta) | **GET** /v2/files/{fileKey} | 파일 조회(메타 + 내려받기 주소)
 *PartnerV2Api* | [**getSemoContractTaxinvoiceStatus**](docs/PartnerV2Api.md#getsemocontracttaxinvoicestatus) | **GET** /v2/semo-contracts/{externalContractId}/tax-invoice | 계산서 발행 상태 조회
-*PartnerV2Api* | [**getSupplierCardPayable**](docs/PartnerV2Api.md#getsuppliercardpayable) | **GET** /v2/card-payment-requests/suppliers/{memberId}/card-payable | 공급사 카드결제 가능 여부
+*PartnerV2Api* | [**getSupplierCardPayable**](docs/PartnerV2Api.md#getsuppliercardpayable) | **GET** /v2/card-payment-requests/suppliers/{memberId}/card-payable | 공급사 카드결제 가능 여부 (구 경로)
 *PartnerV2Api* | [**getSupplierCardPayableV2**](docs/PartnerV2Api.md#getsuppliercardpayablev2) | **GET** /v2/suppliers/{memberId}/card-payable | 공급사 카드결제 가능 여부
 *PartnerV2Api* | [**getWebhookEndpoint**](docs/PartnerV2Api.md#getwebhookendpoint) | **GET** /v2/webhook-endpoints/{endpointId} | 웹훅 구독 단건 조회
 *PartnerV2Api* | [**healthControllerCheck**](docs/PartnerV2Api.md#healthcontrollercheck) | **GET** /health | Partner API 헬스체크
-*PartnerV2Api* | [**listBidResults**](docs/PartnerV2Api.md#listbidresults) | **GET** /v2/bid-results | 입찰 결과 배치 조회
+*PartnerV2Api* | [**listBidResults**](docs/PartnerV2Api.md#listbidresults) | **GET** /v2/bid-results | 공고 결과 배치 조회
 *PartnerV2Api* | [**listBids**](docs/PartnerV2Api.md#listbids) | **GET** /v2/bids | 공고 목록 조회
 *PartnerV2Api* | [**listExternalContractDocuments**](docs/PartnerV2Api.md#listexternalcontractdocuments) | **GET** /v2/contract-documents | 거래에 필요한 계약서류 목록 조회
 *PartnerV2Api* | [**listProducts**](docs/PartnerV2Api.md#listproducts) | **GET** /v2/products | 물품 카탈로그 조회
 *PartnerV2Api* | [**listWebhookDeliveries**](docs/PartnerV2Api.md#listwebhookdeliveries) | **GET** /v2/webhook-deliveries | 웹훅 전송 이력 조회
 *PartnerV2Api* | [**listWebhookEndpoints**](docs/PartnerV2Api.md#listwebhookendpoints) | **GET** /v2/webhook-endpoints | 웹훅 구독 목록 조회
-*PartnerV2Api* | [**markBidFailed**](docs/PartnerV2Api.md#markbidfailed) | **POST** /v2/bids/{bidId}/fail | 유찰 처리
-*PartnerV2Api* | [**publishBid**](docs/PartnerV2Api.md#publishbid) | **POST** /v2/bids/{bidId}/publish | 공고 게시(초안 → 진행중)
-*PartnerV2Api* | [**regenerateContractDocuments**](docs/PartnerV2Api.md#regeneratecontractdocuments) | **POST** /v2/bids/{bidId}/contract-documents | 계약서류 생성(재생성)
-*PartnerV2Api* | [**registerAward**](docs/PartnerV2Api.md#registeraward) | **POST** /v2/bids/{bidId}/award | 낙찰 결과 전송
-*PartnerV2Api* | [**registerBid**](docs/PartnerV2Api.md#registerbid) | **POST** /v2/bids | 입찰 정보 전송(등록)
+*PartnerV2Api* | [**markBidFailed**](docs/PartnerV2Api.md#markbidfailed) | **POST** /v2/bids/{bidRef}/fail | 유찰 처리
+*PartnerV2Api* | [**publishBid**](docs/PartnerV2Api.md#publishbid) | **POST** /v2/bids/{bidRef}/publish | 공고 게시(초안 → 진행중)
+*PartnerV2Api* | [**regenerateContractDocuments**](docs/PartnerV2Api.md#regeneratecontractdocuments) | **POST** /v2/bids/{bidRef}/contract-documents | 계약서류 생성(재생성)
+*PartnerV2Api* | [**registerAward**](docs/PartnerV2Api.md#registeraward) | **POST** /v2/bids/{bidRef}/award | 낙찰 결과 전송
+*PartnerV2Api* | [**registerBid**](docs/PartnerV2Api.md#registerbid) | **POST** /v2/bids | 공고 등록
 *PartnerV2Api* | [**registerSemoContract**](docs/PartnerV2Api.md#registersemocontract) | **POST** /v2/semo-contracts | 계약 발행대상 등록
-*PartnerV2Api* | [**revertAward**](docs/PartnerV2Api.md#revertaward) | **DELETE** /v2/bids/{bidId}/award | 낙찰 되돌리기
+*PartnerV2Api* | [**revertAward**](docs/PartnerV2Api.md#revertaward) | **DELETE** /v2/bids/{bidRef}/award | 낙찰 되돌리기
 *PartnerV2Api* | [**rotateWebhookSecret**](docs/PartnerV2Api.md#rotatewebhooksecret) | **POST** /v2/webhook-endpoints/{endpointId}/rotate-secret | 웹훅 서명 시크릿 재발급
 *PartnerV2Api* | [**sendWebhookTestEvent**](docs/PartnerV2Api.md#sendwebhooktestevent) | **POST** /v2/webhook-endpoints/{endpointId}/test | 웹훅 연결 확인 발송
-*PartnerV2Api* | [**updateBid**](docs/PartnerV2Api.md#updatebid) | **PATCH** /v2/bids/{bidId} | 입찰 공고 수정
+*PartnerV2Api* | [**updateBid**](docs/PartnerV2Api.md#updatebid) | **PATCH** /v2/bids/{bidRef} | 공고 수정
 *PartnerV2Api* | [**updateWebhookEndpoint**](docs/PartnerV2Api.md#updatewebhookendpoint) | **PATCH** /v2/webhook-endpoints/{endpointId} | 웹훅 구독 수정
-*PartnerV2Api* | [**uploadFile**](docs/PartnerV2Api.md#uploadfile) | **POST** /v2/files | 입찰 첨부파일 업로드(base64 또는 url) → fileKey
+*PartnerV2Api* | [**uploadFile**](docs/PartnerV2Api.md#uploadfile) | **POST** /v2/files | 공고 첨부파일 업로드(base64 또는 url) → fileKey
 *WellKnownApi* | [**apiCatalog**](docs/WellKnownApi.md#apicatalog) | **GET** /.well-known/api-catalog | API 카탈로그 (api-catalog, RFC 9727)
 *WellKnownApi* | [**authorizationServerMetadata**](docs/WellKnownApi.md#authorizationservermetadata) | **GET** /.well-known/oauth-authorization-server | OAuth 2.0 인가서버 메타데이터 (Authorization Server Metadata, RFC 8414)
 *WellKnownApi* | [**protectedResourceMetadata**](docs/WellKnownApi.md#protectedresourcemetadata) | **GET** /.well-known/oauth-protected-resource | OAuth 2.0 보호자원 메타데이터 (Protected Resource Metadata, RFC 9728)
@@ -667,7 +667,26 @@ Authentication schemes defined for the API:
 <a id="partner-oauth2"></a>
 ### partner-oauth2
 
-- **Type**: Bearer authentication (JWT)
+- **Type**: OAuth
+- **Flow**: application
+- **Authorization URL**: 
+- **Scopes**: 
+ - **bids:read**: 공고 조회
+ - **bids:write**: 공고 등록·수정
+ - **awards:read**: 낙찰 조회
+ - **awards:write**: 낙찰 처리
+ - **contracts:read**: 계약서류 조회
+ - **contracts:write**: 계약서류 생성
+ - **invoices:read**: 정산·거래명세서 조회
+ - **payments:read**: 결제 가능 여부 조회
+ - **payments:write**: 결제창 발행
+ - **products:read**: 물품 조회
+ - **products:write**: 물품 수신확인
+ - **files:read**: 파일 메타·다운로드
+ - **files:write**: 파일 업로드
+ - **embed:launch**: 임베드 실행
+ - **webhooks:read**: 웹훅 구독·전송이력 조회
+ - **webhooks:write**: 웹훅 구독 등록·수정·삭제
 
 <a id="platform-auth-id"></a>
 ### platform-auth-id

package/api/oauth-api.ts

@@ -4,7 +4,7 @@
  * 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: 33.0.0
+ * The version of the OpenAPI document: 34.0.0
  * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/api/partner-v1-api.ts

@@ -4,7 +4,7 @@
  * 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: 33.0.0
+ * The version of the OpenAPI document: 34.0.0
  * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).