@cmarket/partner-sdk 46.0.0 → 48.0.0

package/README.md

@@ -13,7 +13,7 @@ CMARKET V6 Partner API 의 공식 클라이언트 SDK — 외부 ERP 가 입찰
 TypeScript / Node (npm):
 
 ```bash
-npm install @cmarket/partner-sdk@46.0.0
+npm install @cmarket/partner-sdk@48.0.0
 ```
 
 Java (Maven):
@@ -22,7 +22,7 @@ Java (Maven):
 <dependency>
   <groupId>net.c-market</groupId>
   <artifactId>partner-sdk</artifactId>
-  <version>46.0.0</version>
+  <version>48.0.0</version>
 </dependency>
 ```
 
@@ -375,7 +375,7 @@ CMARKET 운영팀에 등록해야 합니다(미등록 origin 은 iframe 로드
 
 ---
 
-## @cmarket/partner-sdk@46.0.0
+## @cmarket/partner-sdk@48.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@46.0.0 --save
+npm install @cmarket/partner-sdk@48.0.0 --save
 ```
 
 _unPublished (not recommended):_
@@ -434,42 +434,30 @@ Class | Method | HTTP request | Description
 *OauthApi* | [**token**](docs/OauthApi.md#token) | **POST** /oauth/token | 액세스 토큰 발급
 *OauthApi* | [**userinfo**](docs/OauthApi.md#userinfo) | **GET** /oauth/userinfo | 로그인 사용자 신원 조회
 *PartnerApiApi* | [**cancelBid**](docs/PartnerApiApi.md#cancelbid) | **POST** /v2/bids/{bidRef}/cancel | 공고 취소
-*PartnerApiApi* | [**cancelKclMroOrder**](docs/PartnerApiApi.md#cancelkclmroorder) | **POST** /v2/kcl-mro-orders/cancel | 몰 주문 취소 표시
 *PartnerApiApi* | [**completeAcceptance**](docs/PartnerApiApi.md#completeacceptance) | **POST** /v2/bids/{bidRef}/acceptance | 검수완료 전송
 *PartnerApiApi* | [**completeFileUpload**](docs/PartnerApiApi.md#completefileupload) | **POST** /v2/files/{fileKey}/complete | 대용량 업로드 2/2 — 업로드 확정
 *PartnerApiApi* | [**completeInvoice**](docs/PartnerApiApi.md#completeinvoice) | **POST** /v2/bids/{bidRef}/settlement/complete | 정산 마감
 *PartnerApiApi* | [**createCardPayment**](docs/PartnerApiApi.md#createcardpayment) | **POST** /v2/card-payments | 결제창 발행
 *PartnerApiApi* | [**createExternalContractDocuments**](docs/PartnerApiApi.md#createexternalcontractdocuments) | **POST** /v2/contract-documents | 계약서류 생성
 *PartnerApiApi* | [**createFileUploadUrl**](docs/PartnerApiApi.md#createfileuploadurl) | **POST** /v2/files/upload-url | 대용량 업로드 1/2 — 업로드 주소 발급
-*PartnerApiApi* | [**createWebhookEndpoint**](docs/PartnerApiApi.md#createwebhookendpoint) | **POST** /v2/webhook-endpoints | 웹훅 구독 등록
-*PartnerApiApi* | [**deleteWebhookEndpoint**](docs/PartnerApiApi.md#deletewebhookendpoint) | **DELETE** /v2/webhook-endpoints/{endpointId} | 웹훅 구독 삭제
 *PartnerApiApi* | [**downloadFile**](docs/PartnerApiApi.md#downloadfile) | **GET** /files/{fileKey} | 파일 다운로드
 *PartnerApiApi* | [**getBid**](docs/PartnerApiApi.md#getbid) | **GET** /v2/bids/{bidRef} | 공고 상세 조회
 *PartnerApiApi* | [**getBidSettlement**](docs/PartnerApiApi.md#getbidsettlement) | **GET** /v2/bids/{bidRef}/settlement | 정산 정보 조회
 *PartnerApiApi* | [**getBidStatement**](docs/PartnerApiApi.md#getbidstatement) | **GET** /v2/bids/{bidRef}/statement | 거래명세서 조회
-*PartnerApiApi* | [**getFileMeta**](docs/PartnerApiApi.md#getfilemeta) | **GET** /v2/files/{fileKey} | 파일 정보 조회
-*PartnerApiApi* | [**getKclMroOrderStatus**](docs/PartnerApiApi.md#getkclmroorderstatus) | **GET** /v2/kcl-mro-orders/{orderNo} | 몰 주문 중계 상태 조회
 *PartnerApiApi* | [**getSemoContractTaxinvoiceStatus**](docs/PartnerApiApi.md#getsemocontracttaxinvoicestatus) | **GET** /v2/semo-contracts/{externalContractId}/tax-invoice | 계산서 발행 상태 조회
 *PartnerApiApi* | [**getSupplierCardPayableV2**](docs/PartnerApiApi.md#getsuppliercardpayablev2) | **GET** /v2/suppliers/{memberId}/card-payable | 공급사 카드결제 가능 여부
-*PartnerApiApi* | [**getWebhookEndpoint**](docs/PartnerApiApi.md#getwebhookendpoint) | **GET** /v2/webhook-endpoints/{endpointId} | 웹훅 구독 단건 조회
 *PartnerApiApi* | [**healthControllerCheck**](docs/PartnerApiApi.md#healthcontrollercheck) | **GET** /health | Partner API 헬스체크
 *PartnerApiApi* | [**listBidResults**](docs/PartnerApiApi.md#listbidresults) | **GET** /v2/bid-results | 공고 결과 조회
 *PartnerApiApi* | [**listBids**](docs/PartnerApiApi.md#listbids) | **GET** /v2/bids | 공고 목록 조회
 *PartnerApiApi* | [**listExternalContractDocuments**](docs/PartnerApiApi.md#listexternalcontractdocuments) | **GET** /v2/contract-documents | 거래에 필요한 계약서류 목록 조회
 *PartnerApiApi* | [**listSuppliers**](docs/PartnerApiApi.md#listsuppliers) | **GET** /v2/suppliers | 공급사 조회
-*PartnerApiApi* | [**listWebhookDeliveries**](docs/PartnerApiApi.md#listwebhookdeliveries) | **GET** /v2/webhook-deliveries | 웹훅 전송 이력 조회
-*PartnerApiApi* | [**listWebhookEndpoints**](docs/PartnerApiApi.md#listwebhookendpoints) | **GET** /v2/webhook-endpoints | 웹훅 구독 목록 조회
 *PartnerApiApi* | [**markBidFailed**](docs/PartnerApiApi.md#markbidfailed) | **POST** /v2/bids/{bidRef}/fail | 유찰 처리
 *PartnerApiApi* | [**registerAward**](docs/PartnerApiApi.md#registeraward) | **POST** /v2/bids/{bidRef}/award | 낙찰 결과 전송
 *PartnerApiApi* | [**registerBid**](docs/PartnerApiApi.md#registerbid) | **POST** /v2/bids | 공고 등록
 *PartnerApiApi* | [**registerSemoContract**](docs/PartnerApiApi.md#registersemocontract) | **POST** /v2/semo-contracts | 계약 발행대상 등록
-*PartnerApiApi* | [**relayKclMroOrder**](docs/PartnerApiApi.md#relaykclmroorder) | **POST** /v2/kcl-mro-orders | 몰 주문 중계 적재
 *PartnerApiApi* | [**requestInvoiceSplit**](docs/PartnerApiApi.md#requestinvoicesplit) | **POST** /v2/bids/{bidRef}/invoice-splits | 계산서 분할 발급 청구
 *PartnerApiApi* | [**revertAward**](docs/PartnerApiApi.md#revertaward) | **DELETE** /v2/bids/{bidRef}/award | 낙찰 되돌리기
-*PartnerApiApi* | [**rotateWebhookSecret**](docs/PartnerApiApi.md#rotatewebhooksecret) | **POST** /v2/webhook-endpoints/{endpointId}/rotate-secret | 웹훅 서명 시크릿 재발급
-*PartnerApiApi* | [**sendWebhookTestEvent**](docs/PartnerApiApi.md#sendwebhooktestevent) | **POST** /v2/webhook-endpoints/{endpointId}/test | 웹훅 연결 확인 발송
 *PartnerApiApi* | [**updateBid**](docs/PartnerApiApi.md#updatebid) | **PATCH** /v2/bids/{bidRef} | 공고 수정
-*PartnerApiApi* | [**updateWebhookEndpoint**](docs/PartnerApiApi.md#updatewebhookendpoint) | **PATCH** /v2/webhook-endpoints/{endpointId} | 웹훅 구독 수정
 *PartnerApiApi* | [**uploadFile**](docs/PartnerApiApi.md#uploadfile) | **POST** /v2/files | 공고 첨부파일 업로드 (기본)
 *ProductsApi* | [**acknowledgeProductReceipt**](docs/ProductsApi.md#acknowledgeproductreceipt) | **POST** /v2/products/receipts | 물품 수신확인
 *ProductsApi* | [**listProducts**](docs/ProductsApi.md#listproducts) | **GET** /v2/products | 물품 카탈로그 조회
@@ -537,9 +525,6 @@ Class | Method | HTTP request | Description
  - [BiddingStylePublic](docs/BiddingStylePublic.md)
  - [CancelBid200Response](docs/CancelBid200Response.md)
  - [CancelBidRequestDto](docs/CancelBidRequestDto.md)
- - [CancelKclMroOrder200Response](docs/CancelKclMroOrder200Response.md)
- - [CancelKclMroOrderRequestDto](docs/CancelKclMroOrderRequestDto.md)
- - [CancelKclMroOrderResponseDto](docs/CancelKclMroOrderResponseDto.md)
  - [CardPaymentRequestResponseDto](docs/CardPaymentRequestResponseDto.md)
  - [CompleteAcceptance200Response](docs/CompleteAcceptance200Response.md)
  - [CompleteAcceptanceRequestDto](docs/CompleteAcceptanceRequestDto.md)
@@ -555,8 +540,6 @@ Class | Method | HTTP request | Description
  - [CreateExternalContractDocumentsResponseDto](docs/CreateExternalContractDocumentsResponseDto.md)
  - [CreateFileUploadUrl201Response](docs/CreateFileUploadUrl201Response.md)
  - [CreateUploadUrlRequestDto](docs/CreateUploadUrlRequestDto.md)
- - [CreateWebhookEndpoint201Response](docs/CreateWebhookEndpoint201Response.md)
- - [CreateWebhookEndpointRequestDto](docs/CreateWebhookEndpointRequestDto.md)
  - [DeliveryDateTypePublic](docs/DeliveryDateTypePublic.md)
  - [DeliveryMethodPublic](docs/DeliveryMethodPublic.md)
  - [EmbedBidPrefillDto](docs/EmbedBidPrefillDto.md)
@@ -570,16 +553,12 @@ Class | Method | HTTP request | Description
  - [ExternalContractItemDto](docs/ExternalContractItemDto.md)
  - [ExternalContractSnapshotDto](docs/ExternalContractSnapshotDto.md)
  - [ExternalDocumentInputsDto](docs/ExternalDocumentInputsDto.md)
- - [FileMetaResponseDto](docs/FileMetaResponseDto.md)
  - [FileUploadedResponseDto](docs/FileUploadedResponseDto.md)
  - [GeneratedExternalContractDocumentDto](docs/GeneratedExternalContractDocumentDto.md)
  - [GetBid200Response](docs/GetBid200Response.md)
  - [GetBidSettlement200Response](docs/GetBidSettlement200Response.md)
  - [GetBidStatement200Response](docs/GetBidStatement200Response.md)
- - [GetFileMeta200Response](docs/GetFileMeta200Response.md)
- - [GetKclMroOrderStatus200Response](docs/GetKclMroOrderStatus200Response.md)
  - [GetSupplierCardPayableV2200Response](docs/GetSupplierCardPayableV2200Response.md)
- - [GetWebhookEndpoint200Response](docs/GetWebhookEndpoint200Response.md)
  - [GreenProductPublic](docs/GreenProductPublic.md)
  - [HandoverTypePublic](docs/HandoverTypePublic.md)
  - [HealthControllerCheck200Response](docs/HealthControllerCheck200Response.md)
@@ -590,10 +569,6 @@ Class | Method | HTTP request | Description
  - [InvalidParamDto](docs/InvalidParamDto.md)
  - [InvoiceCompletedResponseDto](docs/InvoiceCompletedResponseDto.md)
  - [InvoiceSplitResponseDto](docs/InvoiceSplitResponseDto.md)
- - [KclMroOrderItemDto](docs/KclMroOrderItemDto.md)
- - [KclMroOrderStatusResponseDto](docs/KclMroOrderStatusResponseDto.md)
- - [KclMroQuoteResultDto](docs/KclMroQuoteResultDto.md)
- - [KclMroShipToDto](docs/KclMroShipToDto.md)
  - [LegalMandatoryPublic](docs/LegalMandatoryPublic.md)
  - [LicenseCombinationMode](docs/LicenseCombinationMode.md)
  - [ListBidResults200Response](docs/ListBidResults200Response.md)
@@ -601,22 +576,10 @@ Class | Method | HTTP request | Description
  - [ListBids200ResponseMeta](docs/ListBids200ResponseMeta.md)
  - [ListProducts200Response](docs/ListProducts200Response.md)
  - [ListSuppliers200Response](docs/ListSuppliers200Response.md)
- - [ListWebhookDeliveries200Response](docs/ListWebhookDeliveries200Response.md)
- - [ListWebhookDeliveriesResponseDto](docs/ListWebhookDeliveriesResponseDto.md)
- - [ListWebhookEndpoints200Response](docs/ListWebhookEndpoints200Response.md)
  - [MarkBidFailed201Response](docs/MarkBidFailed201Response.md)
  - [MarkBidFailedRequestDto](docs/MarkBidFailedRequestDto.md)
  - [NominatedSupplierDto](docs/NominatedSupplierDto.md)
  - [OAuthErrorResponseDto](docs/OAuthErrorResponseDto.md)
- - [OnBidAwardRevertedRequest](docs/OnBidAwardRevertedRequest.md)
- - [OnBidAwardedRequest](docs/OnBidAwardedRequest.md)
- - [OnBidCanceledRequest](docs/OnBidCanceledRequest.md)
- - [OnBidClosedRequest](docs/OnBidClosedRequest.md)
- - [OnBidFailedRequest](docs/OnBidFailedRequest.md)
- - [OnPingRequest](docs/OnPingRequest.md)
- - [PartnerWebhookDeliveryStatus](docs/PartnerWebhookDeliveryStatus.md)
- - [PartnerWebhookEndpointStatus](docs/PartnerWebhookEndpointStatus.md)
- - [PartnerWebhookEventType](docs/PartnerWebhookEventType.md)
  - [PaymentMethodPublic](docs/PaymentMethodPublic.md)
  - [PreconditionsDto](docs/PreconditionsDto.md)
  - [PreliminaryPriceRegionPublic](docs/PreliminaryPriceRegionPublic.md)
@@ -633,9 +596,6 @@ Class | Method | HTTP request | Description
  - [RegisterSemoContractRequestDto](docs/RegisterSemoContractRequestDto.md)
  - [RegulationTypePublic](docs/RegulationTypePublic.md)
  - [RelatedBidRelation](docs/RelatedBidRelation.md)
- - [RelayKclMroOrder200Response](docs/RelayKclMroOrder200Response.md)
- - [RelayKclMroOrderRequestDto](docs/RelayKclMroOrderRequestDto.md)
- - [RelayKclMroOrderResponseDto](docs/RelayKclMroOrderResponseDto.md)
  - [RequestInvoiceSplit200Response](docs/RequestInvoiceSplit200Response.md)
  - [RequestInvoiceSplitRequestDto](docs/RequestInvoiceSplitRequestDto.md)
  - [RetireeRosterInputDto](docs/RetireeRosterInputDto.md)
@@ -645,7 +605,6 @@ Class | Method | HTTP request | Description
  - [RevokeRequestDto](docs/RevokeRequestDto.md)
  - [SemoContractRegisteredResponseDto](docs/SemoContractRegisteredResponseDto.md)
  - [SemoContractTaxinvoiceStatusResponseDto](docs/SemoContractTaxinvoiceStatusResponseDto.md)
- - [SendWebhookTestEvent200Response](docs/SendWebhookTestEvent200Response.md)
  - [SiteBriefingInputDto](docs/SiteBriefingInputDto.md)
  - [StatementDocumentDto](docs/StatementDocumentDto.md)
  - [StatementProductDto](docs/StatementProductDto.md)
@@ -658,18 +617,10 @@ Class | Method | HTTP request | Description
  - [TwoStagePhasePublic](docs/TwoStagePhasePublic.md)
  - [UpdateBid200Response](docs/UpdateBid200Response.md)
  - [UpdateBidRequestDto](docs/UpdateBidRequestDto.md)
- - [UpdateWebhookEndpointRequestDto](docs/UpdateWebhookEndpointRequestDto.md)
  - [UploadFile201Response](docs/UploadFile201Response.md)
  - [UploadFileRequestDto](docs/UploadFileRequestDto.md)
  - [UploadUrlCreatedResponseDto](docs/UploadUrlCreatedResponseDto.md)
  - [UserinfoResponseDto](docs/UserinfoResponseDto.md)
- - [WebhookBidEventData](docs/WebhookBidEventData.md)
- - [WebhookDeliveryDto](docs/WebhookDeliveryDto.md)
- - [WebhookEndpointDto](docs/WebhookEndpointDto.md)
- - [WebhookEndpointWithSecretDto](docs/WebhookEndpointWithSecretDto.md)
- - [WebhookEventEnvelope](docs/WebhookEventEnvelope.md)
- - [WebhookPingEventData](docs/WebhookPingEventData.md)
- - [WebhookTestResultDto](docs/WebhookTestResultDto.md)
 
 
 <a id="documentation-for-authorization"></a>
@@ -694,14 +645,9 @@ Authentication schemes defined for the API:
  - **invoices:write**: 계산서 분할 발급 청구
  - **payments:read**: 결제 가능 여부 조회
  - **payments:write**: 결제창 발행
- - **orders:read**: 몰 주문 조회
- - **orders:write**: 몰 주문 등록·취소
  - **products:read**: 물품 조회
  - **products:write**: 물품 수신확인
- - **files:read**: 파일 메타·다운로드
  - **files:write**: 파일 업로드
  - **embed:launch**: 임베드 실행
- - **webhooks:read**: 웹훅 구독·전송이력 조회
- - **webhooks:write**: 웹훅 구독 등록·수정·삭제
  - **sso:login**: SSO 로그인 클라이언트
 

package/api/embed-api.ts

@@ -4,7 +4,7 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 인증 OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token`에서 토큰을 발급받아 `Authorization: Bearer <token>` 헤더로 실으세요.  ## 권한 — 두 개의 독립된 축 `403`을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분하세요. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등입니다. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않습니다. 범위 밖이면 스코프와 무관하게 403입니다.  대행 범위는 키마다 둘 중 하나로 설정됩니다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주기관 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청하세요.  ## 성공 응답 형식 `/v2`의 모든 2xx 본문은 `{ \"data\": … }`입니다. 단일 리소스든 목록이든 같습니다. **목록은 `data`가 배열이고 `meta`가 항상 함께 실립니다** — `{ \"data\": [...], \"meta\": { \"nextCursor\": \"Mg==\", \"hasMore\": true } }`. 단일 리소스 응답에는 `meta`가 나가지 않습니다.  이 형식을 쓰지 않는 엔드포인트는 둘입니다. `/oauth/_*`와 `/.well-known/_*`는 각각 RFC 6749·RFC 8414·RFC 9728이 최상위 필드를 규정하고, 파일 내용 응답은 본문이 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 확장, 값 없음). - `code`: 조달플랫폼이 요청을 거부한 **사유 코드**(`…/upstream-*` 응답에 함께 옵니다). `type`은 상태 수준이고 `detail`은 고정 문구라, 무엇을 고쳐야 하는지는 이 값이 알려 줍니다 — 예: `BID_INVALID_BID_DATE_RANGE`(마감이 시작보다 이름), `BID_DUPLICATE_PURCHASE_NO`(같은 조달번호의 공고가 진행 중). 안정 식별자이므로 문자열로 분기해도 됩니다.  `type`은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**입니다. RFC 9457 §3.1.1이 허용하는 대로 이 URI는 **역참조(dereference)되지 않습니다** — 브라우저로 열지 말고 문자열 비교로만 쓰세요. slug 목록과 의미는 각 엔드포인트의 응답 설명에 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`가 실립니다.  ## 전방호환 — 모르는 필드와 값에서 깨지지 않게 다음 셋은 breaking 변경으로 보지 않으며 minor 릴리스에서 예고 없이 일어납니다. 이 전제로 구현하세요. - **선택 필드 추가**: 모르는 필드는 무시하세요. 엄격 파서(unknown key 거부)를 쓰지 마세요. - **enum 값 추가**: 상태·낙찰방법 등에 새 값이 생깁니다. 모르는 값을 만나면 예외를 던지지 말고 원문 문자열을 보존하세요. - **problem `type` slug 추가**: 모르는 slug은 **HTTP status로 폴백**해 분기하세요.  ## 버전 수명(deprecation/sunset) - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
  *
- * The version of the OpenAPI document: 46.0.0
+ * The version of the OpenAPI document: 48.0.0
  * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/api/oauth-api.ts

@@ -4,7 +4,7 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 인증 OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token`에서 토큰을 발급받아 `Authorization: Bearer <token>` 헤더로 실으세요.  ## 권한 — 두 개의 독립된 축 `403`을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분하세요. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등입니다. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않습니다. 범위 밖이면 스코프와 무관하게 403입니다.  대행 범위는 키마다 둘 중 하나로 설정됩니다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주기관 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청하세요.  ## 성공 응답 형식 `/v2`의 모든 2xx 본문은 `{ \"data\": … }`입니다. 단일 리소스든 목록이든 같습니다. **목록은 `data`가 배열이고 `meta`가 항상 함께 실립니다** — `{ \"data\": [...], \"meta\": { \"nextCursor\": \"Mg==\", \"hasMore\": true } }`. 단일 리소스 응답에는 `meta`가 나가지 않습니다.  이 형식을 쓰지 않는 엔드포인트는 둘입니다. `/oauth/_*`와 `/.well-known/_*`는 각각 RFC 6749·RFC 8414·RFC 9728이 최상위 필드를 규정하고, 파일 내용 응답은 본문이 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 확장, 값 없음). - `code`: 조달플랫폼이 요청을 거부한 **사유 코드**(`…/upstream-*` 응답에 함께 옵니다). `type`은 상태 수준이고 `detail`은 고정 문구라, 무엇을 고쳐야 하는지는 이 값이 알려 줍니다 — 예: `BID_INVALID_BID_DATE_RANGE`(마감이 시작보다 이름), `BID_DUPLICATE_PURCHASE_NO`(같은 조달번호의 공고가 진행 중). 안정 식별자이므로 문자열로 분기해도 됩니다.  `type`은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**입니다. RFC 9457 §3.1.1이 허용하는 대로 이 URI는 **역참조(dereference)되지 않습니다** — 브라우저로 열지 말고 문자열 비교로만 쓰세요. slug 목록과 의미는 각 엔드포인트의 응답 설명에 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`가 실립니다.  ## 전방호환 — 모르는 필드와 값에서 깨지지 않게 다음 셋은 breaking 변경으로 보지 않으며 minor 릴리스에서 예고 없이 일어납니다. 이 전제로 구현하세요. - **선택 필드 추가**: 모르는 필드는 무시하세요. 엄격 파서(unknown key 거부)를 쓰지 마세요. - **enum 값 추가**: 상태·낙찰방법 등에 새 값이 생깁니다. 모르는 값을 만나면 예외를 던지지 말고 원문 문자열을 보존하세요. - **problem `type` slug 추가**: 모르는 slug은 **HTTP status로 폴백**해 분기하세요.  ## 버전 수명(deprecation/sunset) - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
  *
- * The version of the OpenAPI document: 46.0.0
+ * The version of the OpenAPI document: 48.0.0
  * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).