@cmarket/partner-sdk 36.1.1 → 37.1.0

package/README.md

@@ -13,7 +13,7 @@ CMARKET V6 Partner API 의 공식 클라이언트 SDK — 외부 ERP 가 입찰
 TypeScript / Node (npm):
 
 ```bash
-npm install @cmarket/partner-sdk@36.1.1
+npm install @cmarket/partner-sdk@37.1.0
 ```
 
 Java (Maven):
@@ -22,7 +22,7 @@ Java (Maven):
 <dependency>
   <groupId>net.c-market</groupId>
   <artifactId>partner-sdk</artifactId>
-  <version>36.1.1</version>
+  <version>37.1.0</version>
 </dependency>
 ```
 
@@ -375,7 +375,7 @@ CMARKET 운영팀에 등록해야 합니다(미등록 origin 은 iframe 로드
 
 ---
 
-## @cmarket/partner-sdk@36.1.1
+## @cmarket/partner-sdk@37.1.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@36.1.1 --save
+npm install @cmarket/partner-sdk@37.1.0 --save
 ```
 
 _unPublished (not recommended):_
@@ -428,14 +428,17 @@ All URIs are relative to *https://partner-api.c-market.net*
 
 Class | Method | HTTP request | Description
 ------------ | ------------- | ------------- | -------------
+*EmbedApi* | [**createEmbedLaunch**](docs/EmbedApi.md#createembedlaunch) | **POST** /v2/embed/launch | 임베드 launch code 발급 (iframe SSO)
 *OauthApi* | [**introspect**](docs/OauthApi.md#introspect) | **POST** /oauth/introspect | OAuth 2.0 토큰 검사 (Token Introspection, RFC 7662)
 *OauthApi* | [**revoke**](docs/OauthApi.md#revoke) | **POST** /oauth/revoke | OAuth 2.0 토큰 폐기 (Token Revocation, RFC 7009)
 *OauthApi* | [**token**](docs/OauthApi.md#token) | **POST** /oauth/token | OAuth 2.0 access token 발급 (client_credentials)
 *PartnerApiApi* | [**cancelBid**](docs/PartnerApiApi.md#cancelbid) | **POST** /v2/bids/{bidRef}/cancel | 공고 취소
 *PartnerApiApi* | [**completeAcceptance**](docs/PartnerApiApi.md#completeacceptance) | **POST** /v2/bids/{bidRef}/acceptance | 검수완료 전송
+*PartnerApiApi* | [**completeFileUpload**](docs/PartnerApiApi.md#completefileupload) | **POST** /v2/files/{fileKey}/complete | 첨부파일 업로드 확정
 *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 | 첨부파일 업로드 주소 발급 (대용량·권장)
 *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 | 정산 정보 조회
@@ -455,7 +458,7 @@ Class | Method | HTTP request | Description
 *PartnerApiApi* | [**revertAward**](docs/PartnerApiApi.md#revertaward) | **DELETE** /v2/bids/{bidRef}/award | 낙찰 되돌리기
 *PartnerApiApi* | [**submitNegotiationScores**](docs/PartnerApiApi.md#submitnegotiationscores) | **POST** /v2/bids/{bidRef}/negotiation-scores | 협상 점수평가
 *PartnerApiApi* | [**updateBid**](docs/PartnerApiApi.md#updatebid) | **PATCH** /v2/bids/{bidRef} | 공고 수정
-*PartnerApiApi* | [**uploadFile**](docs/PartnerApiApi.md#uploadfile) | **POST** /v2/files | 공고 첨부파일 업로드
+*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 | 물품 카탈로그 조회
 *WellKnownApi* | [**apiCatalog**](docs/WellKnownApi.md#apicatalog) | **GET** /.well-known/api-catalog | API 카탈로그 (api-catalog, RFC 9727)
@@ -476,6 +479,7 @@ Class | Method | HTTP request | Description
  - [AwardRegisteredV2ResponseDto](docs/AwardRegisteredV2ResponseDto.md)
  - [AwardRevertedV2ResponseDto](docs/AwardRevertedV2ResponseDto.md)
  - [BidAcceptanceDto](docs/BidAcceptanceDto.md)
+ - [BidAttachmentInputDto](docs/BidAttachmentInputDto.md)
  - [BidBondDto](docs/BidBondDto.md)
  - [BidCancelledResponseDto](docs/BidCancelledResponseDto.md)
  - [BidContactDto](docs/BidContactDto.md)
@@ -508,15 +512,21 @@ Class | Method | HTTP request | Description
  - [CompleteAcceptance200Response](docs/CompleteAcceptance200Response.md)
  - [CompleteAcceptanceRequestDto](docs/CompleteAcceptanceRequestDto.md)
  - [CompleteInvoice200Response](docs/CompleteInvoice200Response.md)
+ - [CompleteUploadRequestDto](docs/CompleteUploadRequestDto.md)
  - [ContractRestrictionConfirmInputDto](docs/ContractRestrictionConfirmInputDto.md)
  - [CreateBidRequestDto](docs/CreateBidRequestDto.md)
  - [CreateCardPayment200Response](docs/CreateCardPayment200Response.md)
  - [CreateCardPaymentDto](docs/CreateCardPaymentDto.md)
  - [CreateCardPaymentRequestDto](docs/CreateCardPaymentRequestDto.md)
+ - [CreateEmbedLaunch201Response](docs/CreateEmbedLaunch201Response.md)
  - [CreateExternalContractDocumentsRequestDto](docs/CreateExternalContractDocumentsRequestDto.md)
  - [CreateExternalContractDocumentsResponseDto](docs/CreateExternalContractDocumentsResponseDto.md)
+ - [CreateFileUploadUrl201Response](docs/CreateFileUploadUrl201Response.md)
+ - [CreateUploadUrlRequestDto](docs/CreateUploadUrlRequestDto.md)
  - [DeliveryDateTypePublic](docs/DeliveryDateTypePublic.md)
  - [DeliveryMethodPublic](docs/DeliveryMethodPublic.md)
+ - [EmbedLaunchRequestDto](docs/EmbedLaunchRequestDto.md)
+ - [EmbedLaunchResponseDto](docs/EmbedLaunchResponseDto.md)
  - [ExcellentProcurementPublic](docs/ExcellentProcurementPublic.md)
  - [ExternalContractDocumentItemDto](docs/ExternalContractDocumentItemDto.md)
  - [ExternalContractDocumentsResponseDto](docs/ExternalContractDocumentsResponseDto.md)
@@ -581,6 +591,7 @@ Class | Method | HTTP request | Description
  - [UpdateBidRequestDto](docs/UpdateBidRequestDto.md)
  - [UploadFile201Response](docs/UploadFile201Response.md)
  - [UploadFileRequestDto](docs/UploadFileRequestDto.md)
+ - [UploadUrlCreatedResponseDto](docs/UploadUrlCreatedResponseDto.md)
 
 
 <a id="documentation-for-authorization"></a>

package/api/embed-api.ts

@@ -0,0 +1,133 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * 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\": … }` 입니다. 단일 리소스든 목록이든 같습니다. 목록처럼 부가 정보가 있는 응답은 `meta` 가 함께 실립니다 — 예: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"…\" } }`. 부가 정보가 없으면 `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 확장, 값 없음).  `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: 37.1.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 { Configuration } from '../configuration';
+import type { AxiosPromise, AxiosInstance, RawAxiosRequestConfig } from 'axios';
+import globalAxios from 'axios';
+// Some imports not used depending on template conditions
+// @ts-ignore
+import { DUMMY_BASE_URL, assertParamExists, setApiKeyToObject, setBasicAuthToObject, setBearerAuthToObject, setOAuthToObject, setSearchParams, serializeDataIfNeeded, toPathString, createRequestFunction, replaceWithSerializableTypeIfNeeded } from '../common';
+// @ts-ignore
+import { BASE_PATH, COLLECTION_FORMATS, type RequestArgs, BaseAPI, RequiredError, operationServerMap } from '../base';
+// @ts-ignore
+import type { CreateEmbedLaunch201Response } from '../models';
+// @ts-ignore
+import type { EmbedLaunchRequestDto } from '../models';
+// @ts-ignore
+import type { ProblemDetailsDto } from '../models';
+/**
+ * EmbedApi - axios parameter creator
+ */
+export const EmbedApiAxiosParamCreator = function (configuration?: Configuration) {
+    return {
+        /**
+         * 스코프 `embed:launch` 필수. 발주기관 담당자(`memberId`)용 일회성 launch code(60초 TTL)를 발급합니다. 이 code 로 CMARKET 화면이 ERP 안에서 그대로 열립니다 — REST 로 UI 를 다시 만들지 않는 연동 방식입니다.  **프런트에서 직접 호출하지 마세요.** 이 API 는 파트너 자격증명을 쓰므로 ERP **백엔드**가 호출하고, 프런트에는 자체 엔드포인트(예: `POST /api/embed/launch`)로 감싸 노출합니다. code 는 URL 에 싣지 말고 `@cmarket/embed` SDK 의 postMessage 핸드셰이크로만 iframe 에 전달합니다(SDK 가 강제).  `memberId` 가 이 API 키의 대행 범위 밖이면 403, 화이트리스트 밖 `screen`·`components` 는 400 입니다.
+         * @summary 임베드 launch code 발급 (iframe SSO)
+         * @param {EmbedLaunchRequestDto} embedLaunchRequestDto 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        createEmbedLaunch: async (embedLaunchRequestDto: EmbedLaunchRequestDto, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'embedLaunchRequestDto' is not null or undefined
+            assertParamExists('createEmbedLaunch', 'embedLaunchRequestDto', embedLaunchRequestDto)
+            const localVarPath = `/v2/embed/launch`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication partner-oauth2 required
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["embed:launch"], configuration)
+
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = serializeDataIfNeeded(embedLaunchRequestDto, localVarRequestOptions, configuration)
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+    }
+};
+
+/**
+ * EmbedApi - functional programming interface
+ */
+export const EmbedApiFp = function(configuration?: Configuration) {
+    const localVarAxiosParamCreator = EmbedApiAxiosParamCreator(configuration)
+    return {
+        /**
+         * 스코프 `embed:launch` 필수. 발주기관 담당자(`memberId`)용 일회성 launch code(60초 TTL)를 발급합니다. 이 code 로 CMARKET 화면이 ERP 안에서 그대로 열립니다 — REST 로 UI 를 다시 만들지 않는 연동 방식입니다.  **프런트에서 직접 호출하지 마세요.** 이 API 는 파트너 자격증명을 쓰므로 ERP **백엔드**가 호출하고, 프런트에는 자체 엔드포인트(예: `POST /api/embed/launch`)로 감싸 노출합니다. code 는 URL 에 싣지 말고 `@cmarket/embed` SDK 의 postMessage 핸드셰이크로만 iframe 에 전달합니다(SDK 가 강제).  `memberId` 가 이 API 키의 대행 범위 밖이면 403, 화이트리스트 밖 `screen`·`components` 는 400 입니다.
+         * @summary 임베드 launch code 발급 (iframe SSO)
+         * @param {EmbedLaunchRequestDto} embedLaunchRequestDto 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async createEmbedLaunch(embedLaunchRequestDto: EmbedLaunchRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<CreateEmbedLaunch201Response>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.createEmbedLaunch(embedLaunchRequestDto, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['EmbedApi.createEmbedLaunch']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+    }
+};
+
+/**
+ * EmbedApi - factory interface
+ */
+export const EmbedApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
+    const localVarFp = EmbedApiFp(configuration)
+    return {
+        /**
+         * 스코프 `embed:launch` 필수. 발주기관 담당자(`memberId`)용 일회성 launch code(60초 TTL)를 발급합니다. 이 code 로 CMARKET 화면이 ERP 안에서 그대로 열립니다 — REST 로 UI 를 다시 만들지 않는 연동 방식입니다.  **프런트에서 직접 호출하지 마세요.** 이 API 는 파트너 자격증명을 쓰므로 ERP **백엔드**가 호출하고, 프런트에는 자체 엔드포인트(예: `POST /api/embed/launch`)로 감싸 노출합니다. code 는 URL 에 싣지 말고 `@cmarket/embed` SDK 의 postMessage 핸드셰이크로만 iframe 에 전달합니다(SDK 가 강제).  `memberId` 가 이 API 키의 대행 범위 밖이면 403, 화이트리스트 밖 `screen`·`components` 는 400 입니다.
+         * @summary 임베드 launch code 발급 (iframe SSO)
+         * @param {EmbedLaunchRequestDto} embedLaunchRequestDto 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        createEmbedLaunch(embedLaunchRequestDto: EmbedLaunchRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<CreateEmbedLaunch201Response> {
+            return localVarFp.createEmbedLaunch(embedLaunchRequestDto, options).then((request) => request(axios, basePath));
+        },
+    };
+};
+
+/**
+ * EmbedApi - object-oriented interface
+ */
+export class EmbedApi extends BaseAPI {
+    /**
+     * 스코프 `embed:launch` 필수. 발주기관 담당자(`memberId`)용 일회성 launch code(60초 TTL)를 발급합니다. 이 code 로 CMARKET 화면이 ERP 안에서 그대로 열립니다 — REST 로 UI 를 다시 만들지 않는 연동 방식입니다.  **프런트에서 직접 호출하지 마세요.** 이 API 는 파트너 자격증명을 쓰므로 ERP **백엔드**가 호출하고, 프런트에는 자체 엔드포인트(예: `POST /api/embed/launch`)로 감싸 노출합니다. code 는 URL 에 싣지 말고 `@cmarket/embed` SDK 의 postMessage 핸드셰이크로만 iframe 에 전달합니다(SDK 가 강제).  `memberId` 가 이 API 키의 대행 범위 밖이면 403, 화이트리스트 밖 `screen`·`components` 는 400 입니다.
+     * @summary 임베드 launch code 발급 (iframe SSO)
+     * @param {EmbedLaunchRequestDto} embedLaunchRequestDto 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public createEmbedLaunch(embedLaunchRequestDto: EmbedLaunchRequestDto, options?: RawAxiosRequestConfig) {
+        return EmbedApiFp(this.configuration).createEmbedLaunch(embedLaunchRequestDto, options).then((request) => request(this.axios, this.basePath));
+    }
+}
+

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\": … }` 입니다. 단일 리소스든 목록이든 같습니다. 목록처럼 부가 정보가 있는 응답은 `meta` 가 함께 실립니다 — 예: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"…\" } }`. 부가 정보가 없으면 `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 확장, 값 없음).  `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: 36.1.1
+ * The version of the OpenAPI document: 37.1.0
  * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).