npm - @cmarket/partner-sdk - Versions diffs - 34.0.0 → 35.0.0 - Mend

@cmarket/partner-sdk 34.0.0 → 35.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (940) hide show

package/README.md CHANGED Viewed

@@ -13,7 +13,7 @@ CMARKET V6 Partner API 의 공식 클라이언트 SDK — 외부 ERP 가 입찰
 TypeScript / Node (npm):
 ```bash
-npm install @cmarket/partner-sdk@34.0.0
+npm install @cmarket/partner-sdk@35.0.0
 ```
 Java (Maven):
@@ -22,7 +22,7 @@ Java (Maven):
 <dependency>
   <groupId>net.c-market</groupId>
   <artifactId>partner-sdk</artifactId>
-  <version>34.0.0</version>
+  <version>35.0.0</version>
 </dependency>
 ```
@@ -375,7 +375,7 @@ CMARKET 운영팀에 등록해야 합니다(미등록 origin 은 iframe 로드
 ---
-## @cmarket/partner-sdk@34.0.0
+## @cmarket/partner-sdk@35.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@34.0.0 --save
+npm install @cmarket/partner-sdk@35.0.0 --save
 ```
 _unPublished (not recommended):_
@@ -443,43 +443,28 @@ Class | Method | HTTP request | Description
 *PartnerV1Api* | [**v1RequestSplitInvoice**](docs/PartnerV1Api.md#v1requestsplitinvoice) | **POST** /v1/invoices/split-requests | 계산서 분할 발급 청구 — V5 충실
 *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/{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* | [**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/{bidRef} | 공고 단건(라이프사이클) 조회
-*PartnerV2Api* | [**getBidResults**](docs/PartnerV2Api.md#getbidresults) | **GET** /v2/bids/{bidRef}/result | 공고 결과 조회
+*PartnerV2Api* | [**getBid**](docs/PartnerV2Api.md#getbid) | **GET** /v2/bids/{bidRef} | 공고 상세 조회
 *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* | [**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* | [**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/{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/{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/{bidRef} | 공고 수정
-*PartnerV2Api* | [**updateWebhookEndpoint**](docs/PartnerV2Api.md#updatewebhookendpoint) | **PATCH** /v2/webhook-endpoints/{endpointId} | 웹훅 구독 수정
 *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)
@@ -490,8 +475,6 @@ Class | Method | HTTP request | Description
  - [AcceptanceResultResponseDto](docs/AcceptanceResultResponseDto.md)
  - [AcceptanceResultV1ResponseDto](docs/AcceptanceResultV1ResponseDto.md)
- - [AcknowledgeProductReceipt200Response](docs/AcknowledgeProductReceipt200Response.md)
- - [AcknowledgeProductsRequestDto](docs/AcknowledgeProductsRequestDto.md)
  - [AcknowledgeProductsV1RequestDto](docs/AcknowledgeProductsV1RequestDto.md)
  - [ApiCatalogDto](docs/ApiCatalogDto.md)
  - [ApiCatalogEntryDto](docs/ApiCatalogEntryDto.md)
@@ -527,7 +510,6 @@ Class | Method | HTTP request | Description
  - [BidPaymentTermsDto](docs/BidPaymentTermsDto.md)
  - [BidProductDto](docs/BidProductDto.md)
  - [BidPublicStatus](docs/BidPublicStatus.md)
- - [BidPublishedResponseDto](docs/BidPublishedResponseDto.md)
  - [BidRegisteredResponseDto](docs/BidRegisteredResponseDto.md)
  - [BidResultParticipantAttachmentDto](docs/BidResultParticipantAttachmentDto.md)
  - [BidResultParticipantDto](docs/BidResultParticipantDto.md)
@@ -554,16 +536,12 @@ Class | Method | HTTP request | Description
  - [CompleteAcceptanceV1RequestDto](docs/CompleteAcceptanceV1RequestDto.md)
  - [CompleteInvoice200Response](docs/CompleteInvoice200Response.md)
  - [ContractDocumentItemDto](docs/ContractDocumentItemDto.md)
- - [ContractDocumentsRegeneratedResponseDto](docs/ContractDocumentsRegeneratedResponseDto.md)
  - [ContractRestrictionConfirmInputDto](docs/ContractRestrictionConfirmInputDto.md)
  - [CreateBidRequestDto](docs/CreateBidRequestDto.md)
  - [CreateBidV1RequestDto](docs/CreateBidV1RequestDto.md)
- - [CreateCardPayment200Response](docs/CreateCardPayment200Response.md)
  - [CreateCardPaymentRequestDto](docs/CreateCardPaymentRequestDto.md)
  - [CreateExternalContractDocumentsRequestDto](docs/CreateExternalContractDocumentsRequestDto.md)
  - [CreateExternalContractDocumentsResponseDto](docs/CreateExternalContractDocumentsResponseDto.md)
- - [CreateWebhookEndpoint201Response](docs/CreateWebhookEndpoint201Response.md)
- - [CreateWebhookEndpointRequestDto](docs/CreateWebhookEndpointRequestDto.md)
  - [ExternalContractDocumentItemDto](docs/ExternalContractDocumentItemDto.md)
  - [ExternalContractDocumentsResponseDto](docs/ExternalContractDocumentsResponseDto.md)
  - [ExternalContractItemDto](docs/ExternalContractItemDto.md)
@@ -574,12 +552,9 @@ Class | Method | HTTP request | Description
  - [FileUploadedV1ResponseDto](docs/FileUploadedV1ResponseDto.md)
  - [GeneratedExternalContractDocumentDto](docs/GeneratedExternalContractDocumentDto.md)
  - [GetBid200Response](docs/GetBid200Response.md)
- - [GetBidResults200Response](docs/GetBidResults200Response.md)
  - [GetBidSettlement200Response](docs/GetBidSettlement200Response.md)
  - [GetBidStatement200Response](docs/GetBidStatement200Response.md)
  - [GetFileMeta200Response](docs/GetFileMeta200Response.md)
- - [GetSupplierCardPayableV2200Response](docs/GetSupplierCardPayableV2200Response.md)
- - [GetWebhookEndpoint200Response](docs/GetWebhookEndpoint200Response.md)
  - [HealthControllerCheck200Response](docs/HealthControllerCheck200Response.md)
  - [HealthResponseDto](docs/HealthResponseDto.md)
  - [HierarchicalRegionDto](docs/HierarchicalRegionDto.md)
@@ -591,35 +566,18 @@ Class | Method | HTTP request | Description
  - [ListBidResults200Response](docs/ListBidResults200Response.md)
  - [ListBids200Response](docs/ListBids200Response.md)
  - [ListBidsResponseDto](docs/ListBidsResponseDto.md)
- - [ListProducts200Response](docs/ListProducts200Response.md)
- - [ListWebhookDeliveries200Response](docs/ListWebhookDeliveries200Response.md)
- - [ListWebhookDeliveriesResponseDto](docs/ListWebhookDeliveriesResponseDto.md)
- - [ListWebhookEndpoints200Response](docs/ListWebhookEndpoints200Response.md)
  - [MarkBidFailed201Response](docs/MarkBidFailed201Response.md)
  - [MarkBidFailedRequestDto](docs/MarkBidFailedRequestDto.md)
  - [MarkBidFailedV1RequestDto](docs/MarkBidFailedV1RequestDto.md)
  - [NegotiationScoreV1Dto](docs/NegotiationScoreV1Dto.md)
  - [NegotiationScoredResponseDto](docs/NegotiationScoredResponseDto.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)
  - [PreconditionsDto](docs/PreconditionsDto.md)
  - [PreconditionsV1Dto](docs/PreconditionsV1Dto.md)
  - [ProblemDetailsDto](docs/ProblemDetailsDto.md)
- - [ProductReceiptResponseDto](docs/ProductReceiptResponseDto.md)
  - [ProductReceiptV1ResponseDto](docs/ProductReceiptV1ResponseDto.md)
- - [ProductResponseDto](docs/ProductResponseDto.md)
  - [ProductV1ResponseDto](docs/ProductV1ResponseDto.md)
  - [ProtectedResourceMetadataDto](docs/ProtectedResourceMetadataDto.md)
- - [PublishBid200Response](docs/PublishBid200Response.md)
- - [RegenerateContractDocuments201Response](docs/RegenerateContractDocuments201Response.md)
  - [RegisterAward201Response](docs/RegisterAward201Response.md)
  - [RegisterAwardRequestDto](docs/RegisterAwardRequestDto.md)
  - [RegisterAwardV1RequestDto](docs/RegisterAwardV1RequestDto.md)
@@ -633,7 +591,6 @@ Class | Method | HTTP request | Description
  - [RevokeRequestDto](docs/RevokeRequestDto.md)
  - [SemoContractRegisteredResponseDto](docs/SemoContractRegisteredResponseDto.md)
  - [SemoContractTaxinvoiceStatusResponseDto](docs/SemoContractTaxinvoiceStatusResponseDto.md)
- - [SendWebhookTestEvent200Response](docs/SendWebhookTestEvent200Response.md)
  - [SplitInvoiceV1ResponseDto](docs/SplitInvoiceV1ResponseDto.md)
  - [StatementDocumentDto](docs/StatementDocumentDto.md)
  - [StatementProductDto](docs/StatementProductDto.md)
@@ -646,17 +603,9 @@ Class | Method | HTTP request | Description
  - [TokenResponseDto](docs/TokenResponseDto.md)
  - [UpdateBid200Response](docs/UpdateBid200Response.md)
  - [UpdateBidRequestDto](docs/UpdateBidRequestDto.md)
- - [UpdateWebhookEndpointRequestDto](docs/UpdateWebhookEndpointRequestDto.md)
  - [UploadFile201Response](docs/UploadFile201Response.md)
  - [UploadFileRequestDto](docs/UploadFileRequestDto.md)
  - [UploadFileV1RequestDto](docs/UploadFileV1RequestDto.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>

package/api/oauth-api.ts CHANGED Viewed

@@ -2,9 +2,9 @@
 /* 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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
+ * 외부 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: 34.0.0
+ * 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).

package/api/partner-v1-api.ts CHANGED Viewed

@@ -2,9 +2,9 @@
 /* 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` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
+ * 외부 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: 34.0.0
+ * 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).