@cmarket/partner-sdk 49.2.1 → 49.3.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 (700) hide show
  1. package/README.md +4 -4
  2. package/api/embed-api.ts +2 -2
  3. package/api/oauth-api.ts +2 -2
  4. package/api/partner-api-api.ts +2 -2
  5. package/api/products-api.ts +2 -2
  6. package/api/well-known-api.ts +2 -2
  7. package/api.ts +2 -2
  8. package/base.ts +2 -2
  9. package/common.ts +2 -2
  10. package/configuration.ts +2 -2
  11. package/dist/api/embed-api.d.ts +2 -2
  12. package/dist/api/embed-api.js +2 -2
  13. package/dist/api/oauth-api.d.ts +2 -2
  14. package/dist/api/oauth-api.js +2 -2
  15. package/dist/api/partner-api-api.d.ts +2 -2
  16. package/dist/api/partner-api-api.js +2 -2
  17. package/dist/api/products-api.d.ts +2 -2
  18. package/dist/api/products-api.js +2 -2
  19. package/dist/api/well-known-api.d.ts +2 -2
  20. package/dist/api/well-known-api.js +2 -2
  21. package/dist/api.d.ts +2 -2
  22. package/dist/api.js +2 -2
  23. package/dist/base.d.ts +2 -2
  24. package/dist/base.js +2 -2
  25. package/dist/common.d.ts +2 -2
  26. package/dist/common.js +2 -2
  27. package/dist/configuration.d.ts +2 -2
  28. package/dist/configuration.js +2 -2
  29. package/dist/esm/api/embed-api.d.ts +2 -2
  30. package/dist/esm/api/embed-api.js +2 -2
  31. package/dist/esm/api/oauth-api.d.ts +2 -2
  32. package/dist/esm/api/oauth-api.js +2 -2
  33. package/dist/esm/api/partner-api-api.d.ts +2 -2
  34. package/dist/esm/api/partner-api-api.js +2 -2
  35. package/dist/esm/api/products-api.d.ts +2 -2
  36. package/dist/esm/api/products-api.js +2 -2
  37. package/dist/esm/api/well-known-api.d.ts +2 -2
  38. package/dist/esm/api/well-known-api.js +2 -2
  39. package/dist/esm/api.d.ts +2 -2
  40. package/dist/esm/api.js +2 -2
  41. package/dist/esm/base.d.ts +2 -2
  42. package/dist/esm/base.js +2 -2
  43. package/dist/esm/common.d.ts +2 -2
  44. package/dist/esm/common.js +2 -2
  45. package/dist/esm/configuration.d.ts +2 -2
  46. package/dist/esm/configuration.js +2 -2
  47. package/dist/esm/index.d.ts +2 -2
  48. package/dist/esm/index.js +2 -2
  49. package/dist/esm/models/acceptance-result-response-dto.d.ts +2 -2
  50. package/dist/esm/models/acceptance-result-response-dto.js +2 -2
  51. package/dist/esm/models/acknowledge-product-receipt200-response.d.ts +2 -2
  52. package/dist/esm/models/acknowledge-product-receipt200-response.js +2 -2
  53. package/dist/esm/models/acknowledge-products-request-dto.d.ts +2 -2
  54. package/dist/esm/models/acknowledge-products-request-dto.js +2 -2
  55. package/dist/esm/models/api-catalog-dto.d.ts +2 -2
  56. package/dist/esm/models/api-catalog-dto.js +2 -2
  57. package/dist/esm/models/api-catalog-entry-dto.d.ts +2 -2
  58. package/dist/esm/models/api-catalog-entry-dto.js +2 -2
  59. package/dist/esm/models/api-catalog-link-dto.d.ts +2 -2
  60. package/dist/esm/models/api-catalog-link-dto.js +2 -2
  61. package/dist/esm/models/authorization-server-metadata-dto.d.ts +2 -2
  62. package/dist/esm/models/authorization-server-metadata-dto.js +2 -2
  63. package/dist/esm/models/avalues-input-dto.d.ts +2 -2
  64. package/dist/esm/models/avalues-input-dto.js +2 -2
  65. package/dist/esm/models/award-method-public.d.ts +2 -2
  66. package/dist/esm/models/award-method-public.js +2 -2
  67. package/dist/esm/models/award-registered-v2-response-dto.d.ts +2 -2
  68. package/dist/esm/models/award-registered-v2-response-dto.js +2 -2
  69. package/dist/esm/models/bid-acceptance-dto.d.ts +2 -2
  70. package/dist/esm/models/bid-acceptance-dto.js +2 -2
  71. package/dist/esm/models/bid-attachment-dto.d.ts +2 -2
  72. package/dist/esm/models/bid-attachment-dto.js +2 -2
  73. package/dist/esm/models/bid-attachment-input-dto.d.ts +2 -2
  74. package/dist/esm/models/bid-attachment-input-dto.js +2 -2
  75. package/dist/esm/models/bid-avalues-dto.d.ts +2 -2
  76. package/dist/esm/models/bid-avalues-dto.js +2 -2
  77. package/dist/esm/models/bid-award-method-detail-dto.d.ts +2 -2
  78. package/dist/esm/models/bid-award-method-detail-dto.js +2 -2
  79. package/dist/esm/models/bid-bond-dto.d.ts +2 -2
  80. package/dist/esm/models/bid-bond-dto.js +2 -2
  81. package/dist/esm/models/bid-cancellation-dto.d.ts +2 -2
  82. package/dist/esm/models/bid-cancellation-dto.js +2 -2
  83. package/dist/esm/models/bid-category-public.d.ts +2 -2
  84. package/dist/esm/models/bid-category-public.js +2 -2
  85. package/dist/esm/models/bid-contact-dto.d.ts +2 -2
  86. package/dist/esm/models/bid-contact-dto.js +2 -2
  87. package/dist/esm/models/bid-contacts-dto.d.ts +2 -2
  88. package/dist/esm/models/bid-contacts-dto.js +2 -2
  89. package/dist/esm/models/bid-contract-document-dto.d.ts +2 -2
  90. package/dist/esm/models/bid-contract-document-dto.js +2 -2
  91. package/dist/esm/models/bid-delivery-terms-dto.d.ts +2 -2
  92. package/dist/esm/models/bid-delivery-terms-dto.js +2 -2
  93. package/dist/esm/models/bid-detail-response-dto.d.ts +2 -2
  94. package/dist/esm/models/bid-detail-response-dto.js +2 -2
  95. package/dist/esm/models/bid-document-dto.d.ts +2 -2
  96. package/dist/esm/models/bid-document-dto.js +2 -2
  97. package/dist/esm/models/bid-failed-v2-response-dto.d.ts +2 -2
  98. package/dist/esm/models/bid-failed-v2-response-dto.js +2 -2
  99. package/dist/esm/models/bid-item-dto.d.ts +2 -2
  100. package/dist/esm/models/bid-item-dto.js +2 -2
  101. package/dist/esm/models/bid-license-requirement-dto.d.ts +2 -2
  102. package/dist/esm/models/bid-license-requirement-dto.js +2 -2
  103. package/dist/esm/models/bid-lifecycle-dto.d.ts +2 -2
  104. package/dist/esm/models/bid-lifecycle-dto.js +2 -2
  105. package/dist/esm/models/bid-manager-dto.d.ts +2 -2
  106. package/dist/esm/models/bid-manager-dto.js +2 -2
  107. package/dist/esm/models/bid-must-read-notice-dto.d.ts +2 -2
  108. package/dist/esm/models/bid-must-read-notice-dto.js +2 -2
  109. package/dist/esm/models/bid-payment-terms-dto.d.ts +2 -2
  110. package/dist/esm/models/bid-payment-terms-dto.js +2 -2
  111. package/dist/esm/models/bid-preliminary-price-dto.d.ts +2 -2
  112. package/dist/esm/models/bid-preliminary-price-dto.js +2 -2
  113. package/dist/esm/models/bid-preliminary-price-slot-dto.d.ts +2 -2
  114. package/dist/esm/models/bid-preliminary-price-slot-dto.js +2 -2
  115. package/dist/esm/models/bid-product-dto.d.ts +2 -2
  116. package/dist/esm/models/bid-product-dto.js +2 -2
  117. package/dist/esm/models/bid-public-status.d.ts +2 -2
  118. package/dist/esm/models/bid-public-status.js +2 -2
  119. package/dist/esm/models/bid-qualification-review-dto.d.ts +2 -2
  120. package/dist/esm/models/bid-qualification-review-dto.js +2 -2
  121. package/dist/esm/models/bid-region-dto.d.ts +2 -2
  122. package/dist/esm/models/bid-region-dto.js +2 -2
  123. package/dist/esm/models/bid-region-restriction-dto.d.ts +2 -2
  124. package/dist/esm/models/bid-region-restriction-dto.js +2 -2
  125. package/dist/esm/models/bid-registered-response-dto.d.ts +2 -2
  126. package/dist/esm/models/bid-registered-response-dto.js +2 -2
  127. package/dist/esm/models/bid-related-bid-dto.d.ts +2 -2
  128. package/dist/esm/models/bid-related-bid-dto.js +2 -2
  129. package/dist/esm/models/bid-required-document-dto.d.ts +2 -2
  130. package/dist/esm/models/bid-required-document-dto.js +2 -2
  131. package/dist/esm/models/bid-result-participant-attachment-dto.d.ts +2 -2
  132. package/dist/esm/models/bid-result-participant-attachment-dto.js +2 -2
  133. package/dist/esm/models/bid-result-participant-dto.d.ts +2 -2
  134. package/dist/esm/models/bid-result-participant-dto.js +2 -2
  135. package/dist/esm/models/bid-results-response-dto.d.ts +2 -2
  136. package/dist/esm/models/bid-results-response-dto.js +2 -2
  137. package/dist/esm/models/bid-site-briefing-dto.d.ts +2 -2
  138. package/dist/esm/models/bid-site-briefing-dto.js +2 -2
  139. package/dist/esm/models/bid-statement-response-dto.d.ts +2 -2
  140. package/dist/esm/models/bid-statement-response-dto.js +2 -2
  141. package/dist/esm/models/bidding-style-public.d.ts +2 -2
  142. package/dist/esm/models/bidding-style-public.js +2 -2
  143. package/dist/esm/models/card-payment-request-response-dto.d.ts +2 -2
  144. package/dist/esm/models/card-payment-request-response-dto.js +2 -2
  145. package/dist/esm/models/complete-acceptance-request-dto.d.ts +2 -2
  146. package/dist/esm/models/complete-acceptance-request-dto.js +2 -2
  147. package/dist/esm/models/complete-acceptance200-response.d.ts +2 -2
  148. package/dist/esm/models/complete-acceptance200-response.js +2 -2
  149. package/dist/esm/models/contract-restriction-confirm-input-dto.d.ts +2 -2
  150. package/dist/esm/models/contract-restriction-confirm-input-dto.js +2 -2
  151. package/dist/esm/models/create-bid-request-dto.d.ts +2 -2
  152. package/dist/esm/models/create-bid-request-dto.js +2 -2
  153. package/dist/esm/models/create-card-payment-dto.d.ts +2 -2
  154. package/dist/esm/models/create-card-payment-dto.js +2 -2
  155. package/dist/esm/models/create-card-payment-request-dto.d.ts +2 -2
  156. package/dist/esm/models/create-card-payment-request-dto.js +2 -2
  157. package/dist/esm/models/create-card-payment200-response.d.ts +2 -2
  158. package/dist/esm/models/create-card-payment200-response.js +2 -2
  159. package/dist/esm/models/create-embed-launch201-response.d.ts +2 -2
  160. package/dist/esm/models/create-embed-launch201-response.js +2 -2
  161. package/dist/esm/models/create-external-contract-documents-request-dto.d.ts +2 -2
  162. package/dist/esm/models/create-external-contract-documents-request-dto.js +2 -2
  163. package/dist/esm/models/create-external-contract-documents-response-dto.d.ts +2 -2
  164. package/dist/esm/models/create-external-contract-documents-response-dto.js +2 -2
  165. package/dist/esm/models/delivery-date-type-public.d.ts +2 -2
  166. package/dist/esm/models/delivery-date-type-public.js +2 -2
  167. package/dist/esm/models/delivery-method-public.d.ts +2 -2
  168. package/dist/esm/models/delivery-method-public.js +2 -2
  169. package/dist/esm/models/embed-bid-prefill-dto.d.ts +2 -2
  170. package/dist/esm/models/embed-bid-prefill-dto.js +2 -2
  171. package/dist/esm/models/embed-bid-prefill-item-dto.d.ts +2 -2
  172. package/dist/esm/models/embed-bid-prefill-item-dto.js +2 -2
  173. package/dist/esm/models/embed-bid-prefill-manager-dto.d.ts +2 -2
  174. package/dist/esm/models/embed-bid-prefill-manager-dto.js +2 -2
  175. package/dist/esm/models/embed-launch-request-dto.d.ts +2 -2
  176. package/dist/esm/models/embed-launch-request-dto.js +2 -2
  177. package/dist/esm/models/embed-launch-response-dto.d.ts +2 -2
  178. package/dist/esm/models/embed-launch-response-dto.js +2 -2
  179. package/dist/esm/models/excellent-procurement-public.d.ts +2 -2
  180. package/dist/esm/models/excellent-procurement-public.js +2 -2
  181. package/dist/esm/models/external-contract-document-item-dto.d.ts +2 -2
  182. package/dist/esm/models/external-contract-document-item-dto.js +2 -2
  183. package/dist/esm/models/external-contract-documents-response-dto.d.ts +2 -2
  184. package/dist/esm/models/external-contract-documents-response-dto.js +2 -2
  185. package/dist/esm/models/external-contract-item-dto.d.ts +2 -2
  186. package/dist/esm/models/external-contract-item-dto.js +2 -2
  187. package/dist/esm/models/external-contract-snapshot-dto.d.ts +2 -2
  188. package/dist/esm/models/external-contract-snapshot-dto.js +2 -2
  189. package/dist/esm/models/external-document-inputs-dto.d.ts +2 -2
  190. package/dist/esm/models/external-document-inputs-dto.js +2 -2
  191. package/dist/esm/models/file-uploaded-response-dto.d.ts +2 -2
  192. package/dist/esm/models/file-uploaded-response-dto.js +2 -2
  193. package/dist/esm/models/generated-external-contract-document-dto.d.ts +2 -2
  194. package/dist/esm/models/generated-external-contract-document-dto.js +2 -2
  195. package/dist/esm/models/get-bid-statement200-response.d.ts +2 -2
  196. package/dist/esm/models/get-bid-statement200-response.js +2 -2
  197. package/dist/esm/models/get-supplier-card-payable-v2200-response.d.ts +2 -2
  198. package/dist/esm/models/get-supplier-card-payable-v2200-response.js +2 -2
  199. package/dist/esm/models/green-product-public.d.ts +2 -2
  200. package/dist/esm/models/green-product-public.js +2 -2
  201. package/dist/esm/models/handover-type-public.d.ts +2 -2
  202. package/dist/esm/models/handover-type-public.js +2 -2
  203. package/dist/esm/models/health-controller-check200-response.d.ts +2 -2
  204. package/dist/esm/models/health-controller-check200-response.js +2 -2
  205. package/dist/esm/models/health-response-dto.d.ts +2 -2
  206. package/dist/esm/models/health-response-dto.js +2 -2
  207. package/dist/esm/models/hierarchical-region-dto.d.ts +2 -2
  208. package/dist/esm/models/hierarchical-region-dto.js +2 -2
  209. package/dist/esm/models/introspect-request-dto.d.ts +2 -2
  210. package/dist/esm/models/introspect-request-dto.js +2 -2
  211. package/dist/esm/models/introspection-response-dto.d.ts +2 -2
  212. package/dist/esm/models/introspection-response-dto.js +2 -2
  213. package/dist/esm/models/invalid-param-dto.d.ts +2 -2
  214. package/dist/esm/models/invalid-param-dto.js +2 -2
  215. package/dist/esm/models/invoice-split-response-dto.d.ts +2 -2
  216. package/dist/esm/models/invoice-split-response-dto.js +2 -2
  217. package/dist/esm/models/legal-mandatory-public.d.ts +2 -2
  218. package/dist/esm/models/legal-mandatory-public.js +2 -2
  219. package/dist/esm/models/license-combination-mode.d.ts +2 -2
  220. package/dist/esm/models/license-combination-mode.js +2 -2
  221. package/dist/esm/models/list-bid-results200-response-meta.d.ts +2 -2
  222. package/dist/esm/models/list-bid-results200-response-meta.js +2 -2
  223. package/dist/esm/models/list-bid-results200-response.d.ts +2 -2
  224. package/dist/esm/models/list-bid-results200-response.js +2 -2
  225. package/dist/esm/models/list-products200-response.d.ts +2 -2
  226. package/dist/esm/models/list-products200-response.js +2 -2
  227. package/dist/esm/models/mark-bid-failed-request-dto.d.ts +2 -2
  228. package/dist/esm/models/mark-bid-failed-request-dto.js +2 -2
  229. package/dist/esm/models/mark-bid-failed201-response.d.ts +2 -2
  230. package/dist/esm/models/mark-bid-failed201-response.js +2 -2
  231. package/dist/esm/models/nominated-supplier-dto.d.ts +2 -2
  232. package/dist/esm/models/nominated-supplier-dto.js +2 -2
  233. package/dist/esm/models/oauth-error-response-dto.d.ts +2 -2
  234. package/dist/esm/models/oauth-error-response-dto.js +2 -2
  235. package/dist/esm/models/payment-method-public.d.ts +2 -2
  236. package/dist/esm/models/payment-method-public.js +2 -2
  237. package/dist/esm/models/preconditions-dto.d.ts +2 -2
  238. package/dist/esm/models/preconditions-dto.js +2 -2
  239. package/dist/esm/models/preliminary-price-region-public.d.ts +2 -2
  240. package/dist/esm/models/preliminary-price-region-public.js +2 -2
  241. package/dist/esm/models/price-score-type-public.d.ts +2 -2
  242. package/dist/esm/models/price-score-type-public.js +2 -2
  243. package/dist/esm/models/pricing-type-public.d.ts +2 -2
  244. package/dist/esm/models/pricing-type-public.js +2 -2
  245. package/dist/esm/models/problem-details-dto.d.ts +2 -2
  246. package/dist/esm/models/problem-details-dto.js +2 -2
  247. package/dist/esm/models/product-receipt-response-dto.d.ts +2 -2
  248. package/dist/esm/models/product-receipt-response-dto.js +2 -2
  249. package/dist/esm/models/product-response-dto.d.ts +2 -2
  250. package/dist/esm/models/product-response-dto.js +2 -2
  251. package/dist/esm/models/protected-resource-metadata-dto.d.ts +2 -2
  252. package/dist/esm/models/protected-resource-metadata-dto.js +2 -2
  253. package/dist/esm/models/qualification-review-input-dto.d.ts +2 -2
  254. package/dist/esm/models/qualification-review-input-dto.js +2 -2
  255. package/dist/esm/models/register-award-request-dto.d.ts +2 -2
  256. package/dist/esm/models/register-award-request-dto.js +2 -2
  257. package/dist/esm/models/register-award201-response.d.ts +2 -2
  258. package/dist/esm/models/register-award201-response.js +2 -2
  259. package/dist/esm/models/register-bid201-response.d.ts +2 -2
  260. package/dist/esm/models/register-bid201-response.js +2 -2
  261. package/dist/esm/models/register-semo-contract-request-dto.d.ts +2 -2
  262. package/dist/esm/models/register-semo-contract-request-dto.js +2 -2
  263. package/dist/esm/models/regulation-type-public.d.ts +2 -2
  264. package/dist/esm/models/regulation-type-public.js +2 -2
  265. package/dist/esm/models/related-bid-relation.d.ts +2 -2
  266. package/dist/esm/models/related-bid-relation.js +2 -2
  267. package/dist/esm/models/request-invoice-split-request-dto.d.ts +2 -2
  268. package/dist/esm/models/request-invoice-split-request-dto.js +2 -2
  269. package/dist/esm/models/request-invoice-split200-response.d.ts +2 -2
  270. package/dist/esm/models/request-invoice-split200-response.js +2 -2
  271. package/dist/esm/models/retiree-roster-input-dto.d.ts +2 -2
  272. package/dist/esm/models/retiree-roster-input-dto.js +2 -2
  273. package/dist/esm/models/retiree-roster-row-dto.d.ts +2 -2
  274. package/dist/esm/models/retiree-roster-row-dto.js +2 -2
  275. package/dist/esm/models/revoke-request-dto.d.ts +2 -2
  276. package/dist/esm/models/revoke-request-dto.js +2 -2
  277. package/dist/esm/models/rotate-secret-request-dto.d.ts +2 -2
  278. package/dist/esm/models/rotate-secret-request-dto.js +2 -2
  279. package/dist/esm/models/rotate-secret-response-dto.d.ts +2 -2
  280. package/dist/esm/models/rotate-secret-response-dto.js +2 -2
  281. package/dist/esm/models/semo-contract-registered-response-dto.d.ts +2 -2
  282. package/dist/esm/models/semo-contract-registered-response-dto.js +2 -2
  283. package/dist/esm/models/semo-contract-taxinvoice-status-response-dto.d.ts +2 -2
  284. package/dist/esm/models/semo-contract-taxinvoice-status-response-dto.js +2 -2
  285. package/dist/esm/models/site-briefing-input-dto.d.ts +2 -2
  286. package/dist/esm/models/site-briefing-input-dto.js +2 -2
  287. package/dist/esm/models/statement-document-dto.d.ts +2 -2
  288. package/dist/esm/models/statement-document-dto.js +2 -2
  289. package/dist/esm/models/statement-product-dto.d.ts +2 -2
  290. package/dist/esm/models/statement-product-dto.js +2 -2
  291. package/dist/esm/models/supplier-card-payable-response-dto.d.ts +2 -2
  292. package/dist/esm/models/supplier-card-payable-response-dto.js +2 -2
  293. package/dist/esm/models/taxation-type-public.d.ts +2 -2
  294. package/dist/esm/models/taxation-type-public.js +2 -2
  295. package/dist/esm/models/token-request-dto.d.ts +2 -2
  296. package/dist/esm/models/token-request-dto.js +2 -2
  297. package/dist/esm/models/token-response-dto.d.ts +2 -2
  298. package/dist/esm/models/token-response-dto.js +2 -2
  299. package/dist/esm/models/two-stage-phase-public.d.ts +2 -2
  300. package/dist/esm/models/two-stage-phase-public.js +2 -2
  301. package/dist/esm/models/upload-file-request-dto.d.ts +2 -2
  302. package/dist/esm/models/upload-file-request-dto.js +2 -2
  303. package/dist/esm/models/upload-file201-response.d.ts +2 -2
  304. package/dist/esm/models/upload-file201-response.js +2 -2
  305. package/dist/esm/models/userinfo-response-dto.d.ts +2 -2
  306. package/dist/esm/models/userinfo-response-dto.js +2 -2
  307. package/dist/index.d.ts +2 -2
  308. package/dist/index.js +2 -2
  309. package/dist/models/acceptance-result-response-dto.d.ts +2 -2
  310. package/dist/models/acceptance-result-response-dto.js +2 -2
  311. package/dist/models/acknowledge-product-receipt200-response.d.ts +2 -2
  312. package/dist/models/acknowledge-product-receipt200-response.js +2 -2
  313. package/dist/models/acknowledge-products-request-dto.d.ts +2 -2
  314. package/dist/models/acknowledge-products-request-dto.js +2 -2
  315. package/dist/models/api-catalog-dto.d.ts +2 -2
  316. package/dist/models/api-catalog-dto.js +2 -2
  317. package/dist/models/api-catalog-entry-dto.d.ts +2 -2
  318. package/dist/models/api-catalog-entry-dto.js +2 -2
  319. package/dist/models/api-catalog-link-dto.d.ts +2 -2
  320. package/dist/models/api-catalog-link-dto.js +2 -2
  321. package/dist/models/authorization-server-metadata-dto.d.ts +2 -2
  322. package/dist/models/authorization-server-metadata-dto.js +2 -2
  323. package/dist/models/avalues-input-dto.d.ts +2 -2
  324. package/dist/models/avalues-input-dto.js +2 -2
  325. package/dist/models/award-method-public.d.ts +2 -2
  326. package/dist/models/award-method-public.js +2 -2
  327. package/dist/models/award-registered-v2-response-dto.d.ts +2 -2
  328. package/dist/models/award-registered-v2-response-dto.js +2 -2
  329. package/dist/models/bid-acceptance-dto.d.ts +2 -2
  330. package/dist/models/bid-acceptance-dto.js +2 -2
  331. package/dist/models/bid-attachment-dto.d.ts +2 -2
  332. package/dist/models/bid-attachment-dto.js +2 -2
  333. package/dist/models/bid-attachment-input-dto.d.ts +2 -2
  334. package/dist/models/bid-attachment-input-dto.js +2 -2
  335. package/dist/models/bid-avalues-dto.d.ts +2 -2
  336. package/dist/models/bid-avalues-dto.js +2 -2
  337. package/dist/models/bid-award-method-detail-dto.d.ts +2 -2
  338. package/dist/models/bid-award-method-detail-dto.js +2 -2
  339. package/dist/models/bid-bond-dto.d.ts +2 -2
  340. package/dist/models/bid-bond-dto.js +2 -2
  341. package/dist/models/bid-cancellation-dto.d.ts +2 -2
  342. package/dist/models/bid-cancellation-dto.js +2 -2
  343. package/dist/models/bid-category-public.d.ts +2 -2
  344. package/dist/models/bid-category-public.js +2 -2
  345. package/dist/models/bid-contact-dto.d.ts +2 -2
  346. package/dist/models/bid-contact-dto.js +2 -2
  347. package/dist/models/bid-contacts-dto.d.ts +2 -2
  348. package/dist/models/bid-contacts-dto.js +2 -2
  349. package/dist/models/bid-contract-document-dto.d.ts +2 -2
  350. package/dist/models/bid-contract-document-dto.js +2 -2
  351. package/dist/models/bid-delivery-terms-dto.d.ts +2 -2
  352. package/dist/models/bid-delivery-terms-dto.js +2 -2
  353. package/dist/models/bid-detail-response-dto.d.ts +2 -2
  354. package/dist/models/bid-detail-response-dto.js +2 -2
  355. package/dist/models/bid-document-dto.d.ts +2 -2
  356. package/dist/models/bid-document-dto.js +2 -2
  357. package/dist/models/bid-failed-v2-response-dto.d.ts +2 -2
  358. package/dist/models/bid-failed-v2-response-dto.js +2 -2
  359. package/dist/models/bid-item-dto.d.ts +2 -2
  360. package/dist/models/bid-item-dto.js +2 -2
  361. package/dist/models/bid-license-requirement-dto.d.ts +2 -2
  362. package/dist/models/bid-license-requirement-dto.js +2 -2
  363. package/dist/models/bid-lifecycle-dto.d.ts +2 -2
  364. package/dist/models/bid-lifecycle-dto.js +2 -2
  365. package/dist/models/bid-manager-dto.d.ts +2 -2
  366. package/dist/models/bid-manager-dto.js +2 -2
  367. package/dist/models/bid-must-read-notice-dto.d.ts +2 -2
  368. package/dist/models/bid-must-read-notice-dto.js +2 -2
  369. package/dist/models/bid-payment-terms-dto.d.ts +2 -2
  370. package/dist/models/bid-payment-terms-dto.js +2 -2
  371. package/dist/models/bid-preliminary-price-dto.d.ts +2 -2
  372. package/dist/models/bid-preliminary-price-dto.js +2 -2
  373. package/dist/models/bid-preliminary-price-slot-dto.d.ts +2 -2
  374. package/dist/models/bid-preliminary-price-slot-dto.js +2 -2
  375. package/dist/models/bid-product-dto.d.ts +2 -2
  376. package/dist/models/bid-product-dto.js +2 -2
  377. package/dist/models/bid-public-status.d.ts +2 -2
  378. package/dist/models/bid-public-status.js +2 -2
  379. package/dist/models/bid-qualification-review-dto.d.ts +2 -2
  380. package/dist/models/bid-qualification-review-dto.js +2 -2
  381. package/dist/models/bid-region-dto.d.ts +2 -2
  382. package/dist/models/bid-region-dto.js +2 -2
  383. package/dist/models/bid-region-restriction-dto.d.ts +2 -2
  384. package/dist/models/bid-region-restriction-dto.js +2 -2
  385. package/dist/models/bid-registered-response-dto.d.ts +2 -2
  386. package/dist/models/bid-registered-response-dto.js +2 -2
  387. package/dist/models/bid-related-bid-dto.d.ts +2 -2
  388. package/dist/models/bid-related-bid-dto.js +2 -2
  389. package/dist/models/bid-required-document-dto.d.ts +2 -2
  390. package/dist/models/bid-required-document-dto.js +2 -2
  391. package/dist/models/bid-result-participant-attachment-dto.d.ts +2 -2
  392. package/dist/models/bid-result-participant-attachment-dto.js +2 -2
  393. package/dist/models/bid-result-participant-dto.d.ts +2 -2
  394. package/dist/models/bid-result-participant-dto.js +2 -2
  395. package/dist/models/bid-results-response-dto.d.ts +2 -2
  396. package/dist/models/bid-results-response-dto.js +2 -2
  397. package/dist/models/bid-site-briefing-dto.d.ts +2 -2
  398. package/dist/models/bid-site-briefing-dto.js +2 -2
  399. package/dist/models/bid-statement-response-dto.d.ts +2 -2
  400. package/dist/models/bid-statement-response-dto.js +2 -2
  401. package/dist/models/bidding-style-public.d.ts +2 -2
  402. package/dist/models/bidding-style-public.js +2 -2
  403. package/dist/models/card-payment-request-response-dto.d.ts +2 -2
  404. package/dist/models/card-payment-request-response-dto.js +2 -2
  405. package/dist/models/complete-acceptance-request-dto.d.ts +2 -2
  406. package/dist/models/complete-acceptance-request-dto.js +2 -2
  407. package/dist/models/complete-acceptance200-response.d.ts +2 -2
  408. package/dist/models/complete-acceptance200-response.js +2 -2
  409. package/dist/models/contract-restriction-confirm-input-dto.d.ts +2 -2
  410. package/dist/models/contract-restriction-confirm-input-dto.js +2 -2
  411. package/dist/models/create-bid-request-dto.d.ts +2 -2
  412. package/dist/models/create-bid-request-dto.js +2 -2
  413. package/dist/models/create-card-payment-dto.d.ts +2 -2
  414. package/dist/models/create-card-payment-dto.js +2 -2
  415. package/dist/models/create-card-payment-request-dto.d.ts +2 -2
  416. package/dist/models/create-card-payment-request-dto.js +2 -2
  417. package/dist/models/create-card-payment200-response.d.ts +2 -2
  418. package/dist/models/create-card-payment200-response.js +2 -2
  419. package/dist/models/create-embed-launch201-response.d.ts +2 -2
  420. package/dist/models/create-embed-launch201-response.js +2 -2
  421. package/dist/models/create-external-contract-documents-request-dto.d.ts +2 -2
  422. package/dist/models/create-external-contract-documents-request-dto.js +2 -2
  423. package/dist/models/create-external-contract-documents-response-dto.d.ts +2 -2
  424. package/dist/models/create-external-contract-documents-response-dto.js +2 -2
  425. package/dist/models/delivery-date-type-public.d.ts +2 -2
  426. package/dist/models/delivery-date-type-public.js +2 -2
  427. package/dist/models/delivery-method-public.d.ts +2 -2
  428. package/dist/models/delivery-method-public.js +2 -2
  429. package/dist/models/embed-bid-prefill-dto.d.ts +2 -2
  430. package/dist/models/embed-bid-prefill-dto.js +2 -2
  431. package/dist/models/embed-bid-prefill-item-dto.d.ts +2 -2
  432. package/dist/models/embed-bid-prefill-item-dto.js +2 -2
  433. package/dist/models/embed-bid-prefill-manager-dto.d.ts +2 -2
  434. package/dist/models/embed-bid-prefill-manager-dto.js +2 -2
  435. package/dist/models/embed-launch-request-dto.d.ts +2 -2
  436. package/dist/models/embed-launch-request-dto.js +2 -2
  437. package/dist/models/embed-launch-response-dto.d.ts +2 -2
  438. package/dist/models/embed-launch-response-dto.js +2 -2
  439. package/dist/models/excellent-procurement-public.d.ts +2 -2
  440. package/dist/models/excellent-procurement-public.js +2 -2
  441. package/dist/models/external-contract-document-item-dto.d.ts +2 -2
  442. package/dist/models/external-contract-document-item-dto.js +2 -2
  443. package/dist/models/external-contract-documents-response-dto.d.ts +2 -2
  444. package/dist/models/external-contract-documents-response-dto.js +2 -2
  445. package/dist/models/external-contract-item-dto.d.ts +2 -2
  446. package/dist/models/external-contract-item-dto.js +2 -2
  447. package/dist/models/external-contract-snapshot-dto.d.ts +2 -2
  448. package/dist/models/external-contract-snapshot-dto.js +2 -2
  449. package/dist/models/external-document-inputs-dto.d.ts +2 -2
  450. package/dist/models/external-document-inputs-dto.js +2 -2
  451. package/dist/models/file-uploaded-response-dto.d.ts +2 -2
  452. package/dist/models/file-uploaded-response-dto.js +2 -2
  453. package/dist/models/generated-external-contract-document-dto.d.ts +2 -2
  454. package/dist/models/generated-external-contract-document-dto.js +2 -2
  455. package/dist/models/get-bid-statement200-response.d.ts +2 -2
  456. package/dist/models/get-bid-statement200-response.js +2 -2
  457. package/dist/models/get-supplier-card-payable-v2200-response.d.ts +2 -2
  458. package/dist/models/get-supplier-card-payable-v2200-response.js +2 -2
  459. package/dist/models/green-product-public.d.ts +2 -2
  460. package/dist/models/green-product-public.js +2 -2
  461. package/dist/models/handover-type-public.d.ts +2 -2
  462. package/dist/models/handover-type-public.js +2 -2
  463. package/dist/models/health-controller-check200-response.d.ts +2 -2
  464. package/dist/models/health-controller-check200-response.js +2 -2
  465. package/dist/models/health-response-dto.d.ts +2 -2
  466. package/dist/models/health-response-dto.js +2 -2
  467. package/dist/models/hierarchical-region-dto.d.ts +2 -2
  468. package/dist/models/hierarchical-region-dto.js +2 -2
  469. package/dist/models/introspect-request-dto.d.ts +2 -2
  470. package/dist/models/introspect-request-dto.js +2 -2
  471. package/dist/models/introspection-response-dto.d.ts +2 -2
  472. package/dist/models/introspection-response-dto.js +2 -2
  473. package/dist/models/invalid-param-dto.d.ts +2 -2
  474. package/dist/models/invalid-param-dto.js +2 -2
  475. package/dist/models/invoice-split-response-dto.d.ts +2 -2
  476. package/dist/models/invoice-split-response-dto.js +2 -2
  477. package/dist/models/legal-mandatory-public.d.ts +2 -2
  478. package/dist/models/legal-mandatory-public.js +2 -2
  479. package/dist/models/license-combination-mode.d.ts +2 -2
  480. package/dist/models/license-combination-mode.js +2 -2
  481. package/dist/models/list-bid-results200-response-meta.d.ts +2 -2
  482. package/dist/models/list-bid-results200-response-meta.js +2 -2
  483. package/dist/models/list-bid-results200-response.d.ts +2 -2
  484. package/dist/models/list-bid-results200-response.js +2 -2
  485. package/dist/models/list-products200-response.d.ts +2 -2
  486. package/dist/models/list-products200-response.js +2 -2
  487. package/dist/models/mark-bid-failed-request-dto.d.ts +2 -2
  488. package/dist/models/mark-bid-failed-request-dto.js +2 -2
  489. package/dist/models/mark-bid-failed201-response.d.ts +2 -2
  490. package/dist/models/mark-bid-failed201-response.js +2 -2
  491. package/dist/models/nominated-supplier-dto.d.ts +2 -2
  492. package/dist/models/nominated-supplier-dto.js +2 -2
  493. package/dist/models/oauth-error-response-dto.d.ts +2 -2
  494. package/dist/models/oauth-error-response-dto.js +2 -2
  495. package/dist/models/payment-method-public.d.ts +2 -2
  496. package/dist/models/payment-method-public.js +2 -2
  497. package/dist/models/preconditions-dto.d.ts +2 -2
  498. package/dist/models/preconditions-dto.js +2 -2
  499. package/dist/models/preliminary-price-region-public.d.ts +2 -2
  500. package/dist/models/preliminary-price-region-public.js +2 -2
  501. package/dist/models/price-score-type-public.d.ts +2 -2
  502. package/dist/models/price-score-type-public.js +2 -2
  503. package/dist/models/pricing-type-public.d.ts +2 -2
  504. package/dist/models/pricing-type-public.js +2 -2
  505. package/dist/models/problem-details-dto.d.ts +2 -2
  506. package/dist/models/problem-details-dto.js +2 -2
  507. package/dist/models/product-receipt-response-dto.d.ts +2 -2
  508. package/dist/models/product-receipt-response-dto.js +2 -2
  509. package/dist/models/product-response-dto.d.ts +2 -2
  510. package/dist/models/product-response-dto.js +2 -2
  511. package/dist/models/protected-resource-metadata-dto.d.ts +2 -2
  512. package/dist/models/protected-resource-metadata-dto.js +2 -2
  513. package/dist/models/qualification-review-input-dto.d.ts +2 -2
  514. package/dist/models/qualification-review-input-dto.js +2 -2
  515. package/dist/models/register-award-request-dto.d.ts +2 -2
  516. package/dist/models/register-award-request-dto.js +2 -2
  517. package/dist/models/register-award201-response.d.ts +2 -2
  518. package/dist/models/register-award201-response.js +2 -2
  519. package/dist/models/register-bid201-response.d.ts +2 -2
  520. package/dist/models/register-bid201-response.js +2 -2
  521. package/dist/models/register-semo-contract-request-dto.d.ts +2 -2
  522. package/dist/models/register-semo-contract-request-dto.js +2 -2
  523. package/dist/models/regulation-type-public.d.ts +2 -2
  524. package/dist/models/regulation-type-public.js +2 -2
  525. package/dist/models/related-bid-relation.d.ts +2 -2
  526. package/dist/models/related-bid-relation.js +2 -2
  527. package/dist/models/request-invoice-split-request-dto.d.ts +2 -2
  528. package/dist/models/request-invoice-split-request-dto.js +2 -2
  529. package/dist/models/request-invoice-split200-response.d.ts +2 -2
  530. package/dist/models/request-invoice-split200-response.js +2 -2
  531. package/dist/models/retiree-roster-input-dto.d.ts +2 -2
  532. package/dist/models/retiree-roster-input-dto.js +2 -2
  533. package/dist/models/retiree-roster-row-dto.d.ts +2 -2
  534. package/dist/models/retiree-roster-row-dto.js +2 -2
  535. package/dist/models/revoke-request-dto.d.ts +2 -2
  536. package/dist/models/revoke-request-dto.js +2 -2
  537. package/dist/models/rotate-secret-request-dto.d.ts +2 -2
  538. package/dist/models/rotate-secret-request-dto.js +2 -2
  539. package/dist/models/rotate-secret-response-dto.d.ts +2 -2
  540. package/dist/models/rotate-secret-response-dto.js +2 -2
  541. package/dist/models/semo-contract-registered-response-dto.d.ts +2 -2
  542. package/dist/models/semo-contract-registered-response-dto.js +2 -2
  543. package/dist/models/semo-contract-taxinvoice-status-response-dto.d.ts +2 -2
  544. package/dist/models/semo-contract-taxinvoice-status-response-dto.js +2 -2
  545. package/dist/models/site-briefing-input-dto.d.ts +2 -2
  546. package/dist/models/site-briefing-input-dto.js +2 -2
  547. package/dist/models/statement-document-dto.d.ts +2 -2
  548. package/dist/models/statement-document-dto.js +2 -2
  549. package/dist/models/statement-product-dto.d.ts +2 -2
  550. package/dist/models/statement-product-dto.js +2 -2
  551. package/dist/models/supplier-card-payable-response-dto.d.ts +2 -2
  552. package/dist/models/supplier-card-payable-response-dto.js +2 -2
  553. package/dist/models/taxation-type-public.d.ts +2 -2
  554. package/dist/models/taxation-type-public.js +2 -2
  555. package/dist/models/token-request-dto.d.ts +2 -2
  556. package/dist/models/token-request-dto.js +2 -2
  557. package/dist/models/token-response-dto.d.ts +2 -2
  558. package/dist/models/token-response-dto.js +2 -2
  559. package/dist/models/two-stage-phase-public.d.ts +2 -2
  560. package/dist/models/two-stage-phase-public.js +2 -2
  561. package/dist/models/upload-file-request-dto.d.ts +2 -2
  562. package/dist/models/upload-file-request-dto.js +2 -2
  563. package/dist/models/upload-file201-response.d.ts +2 -2
  564. package/dist/models/upload-file201-response.js +2 -2
  565. package/dist/models/userinfo-response-dto.d.ts +2 -2
  566. package/dist/models/userinfo-response-dto.js +2 -2
  567. package/docs/EmbedApi.md +1 -1
  568. package/docs/PartnerApiApi.md +13 -13
  569. package/docs/ProductsApi.md +2 -2
  570. package/index.ts +2 -2
  571. package/models/acceptance-result-response-dto.ts +2 -2
  572. package/models/acknowledge-product-receipt200-response.ts +2 -2
  573. package/models/acknowledge-products-request-dto.ts +2 -2
  574. package/models/api-catalog-dto.ts +2 -2
  575. package/models/api-catalog-entry-dto.ts +2 -2
  576. package/models/api-catalog-link-dto.ts +2 -2
  577. package/models/authorization-server-metadata-dto.ts +2 -2
  578. package/models/avalues-input-dto.ts +2 -2
  579. package/models/award-method-public.ts +2 -2
  580. package/models/award-registered-v2-response-dto.ts +2 -2
  581. package/models/bid-acceptance-dto.ts +2 -2
  582. package/models/bid-attachment-dto.ts +2 -2
  583. package/models/bid-attachment-input-dto.ts +2 -2
  584. package/models/bid-avalues-dto.ts +2 -2
  585. package/models/bid-award-method-detail-dto.ts +2 -2
  586. package/models/bid-bond-dto.ts +2 -2
  587. package/models/bid-cancellation-dto.ts +2 -2
  588. package/models/bid-category-public.ts +2 -2
  589. package/models/bid-contact-dto.ts +2 -2
  590. package/models/bid-contacts-dto.ts +2 -2
  591. package/models/bid-contract-document-dto.ts +2 -2
  592. package/models/bid-delivery-terms-dto.ts +2 -2
  593. package/models/bid-detail-response-dto.ts +2 -2
  594. package/models/bid-document-dto.ts +2 -2
  595. package/models/bid-failed-v2-response-dto.ts +2 -2
  596. package/models/bid-item-dto.ts +2 -2
  597. package/models/bid-license-requirement-dto.ts +2 -2
  598. package/models/bid-lifecycle-dto.ts +2 -2
  599. package/models/bid-manager-dto.ts +2 -2
  600. package/models/bid-must-read-notice-dto.ts +2 -2
  601. package/models/bid-payment-terms-dto.ts +2 -2
  602. package/models/bid-preliminary-price-dto.ts +2 -2
  603. package/models/bid-preliminary-price-slot-dto.ts +2 -2
  604. package/models/bid-product-dto.ts +2 -2
  605. package/models/bid-public-status.ts +2 -2
  606. package/models/bid-qualification-review-dto.ts +2 -2
  607. package/models/bid-region-dto.ts +2 -2
  608. package/models/bid-region-restriction-dto.ts +2 -2
  609. package/models/bid-registered-response-dto.ts +2 -2
  610. package/models/bid-related-bid-dto.ts +2 -2
  611. package/models/bid-required-document-dto.ts +2 -2
  612. package/models/bid-result-participant-attachment-dto.ts +2 -2
  613. package/models/bid-result-participant-dto.ts +2 -2
  614. package/models/bid-results-response-dto.ts +2 -2
  615. package/models/bid-site-briefing-dto.ts +2 -2
  616. package/models/bid-statement-response-dto.ts +2 -2
  617. package/models/bidding-style-public.ts +2 -2
  618. package/models/card-payment-request-response-dto.ts +2 -2
  619. package/models/complete-acceptance-request-dto.ts +2 -2
  620. package/models/complete-acceptance200-response.ts +2 -2
  621. package/models/contract-restriction-confirm-input-dto.ts +2 -2
  622. package/models/create-bid-request-dto.ts +2 -2
  623. package/models/create-card-payment-dto.ts +2 -2
  624. package/models/create-card-payment-request-dto.ts +2 -2
  625. package/models/create-card-payment200-response.ts +2 -2
  626. package/models/create-embed-launch201-response.ts +2 -2
  627. package/models/create-external-contract-documents-request-dto.ts +2 -2
  628. package/models/create-external-contract-documents-response-dto.ts +2 -2
  629. package/models/delivery-date-type-public.ts +2 -2
  630. package/models/delivery-method-public.ts +2 -2
  631. package/models/embed-bid-prefill-dto.ts +2 -2
  632. package/models/embed-bid-prefill-item-dto.ts +2 -2
  633. package/models/embed-bid-prefill-manager-dto.ts +2 -2
  634. package/models/embed-launch-request-dto.ts +2 -2
  635. package/models/embed-launch-response-dto.ts +2 -2
  636. package/models/excellent-procurement-public.ts +2 -2
  637. package/models/external-contract-document-item-dto.ts +2 -2
  638. package/models/external-contract-documents-response-dto.ts +2 -2
  639. package/models/external-contract-item-dto.ts +2 -2
  640. package/models/external-contract-snapshot-dto.ts +2 -2
  641. package/models/external-document-inputs-dto.ts +2 -2
  642. package/models/file-uploaded-response-dto.ts +2 -2
  643. package/models/generated-external-contract-document-dto.ts +2 -2
  644. package/models/get-bid-statement200-response.ts +2 -2
  645. package/models/get-supplier-card-payable-v2200-response.ts +2 -2
  646. package/models/green-product-public.ts +2 -2
  647. package/models/handover-type-public.ts +2 -2
  648. package/models/health-controller-check200-response.ts +2 -2
  649. package/models/health-response-dto.ts +2 -2
  650. package/models/hierarchical-region-dto.ts +2 -2
  651. package/models/introspect-request-dto.ts +2 -2
  652. package/models/introspection-response-dto.ts +2 -2
  653. package/models/invalid-param-dto.ts +2 -2
  654. package/models/invoice-split-response-dto.ts +2 -2
  655. package/models/legal-mandatory-public.ts +2 -2
  656. package/models/license-combination-mode.ts +2 -2
  657. package/models/list-bid-results200-response-meta.ts +2 -2
  658. package/models/list-bid-results200-response.ts +2 -2
  659. package/models/list-products200-response.ts +2 -2
  660. package/models/mark-bid-failed-request-dto.ts +2 -2
  661. package/models/mark-bid-failed201-response.ts +2 -2
  662. package/models/nominated-supplier-dto.ts +2 -2
  663. package/models/oauth-error-response-dto.ts +2 -2
  664. package/models/payment-method-public.ts +2 -2
  665. package/models/preconditions-dto.ts +2 -2
  666. package/models/preliminary-price-region-public.ts +2 -2
  667. package/models/price-score-type-public.ts +2 -2
  668. package/models/pricing-type-public.ts +2 -2
  669. package/models/problem-details-dto.ts +2 -2
  670. package/models/product-receipt-response-dto.ts +2 -2
  671. package/models/product-response-dto.ts +2 -2
  672. package/models/protected-resource-metadata-dto.ts +2 -2
  673. package/models/qualification-review-input-dto.ts +2 -2
  674. package/models/register-award-request-dto.ts +2 -2
  675. package/models/register-award201-response.ts +2 -2
  676. package/models/register-bid201-response.ts +2 -2
  677. package/models/register-semo-contract-request-dto.ts +2 -2
  678. package/models/regulation-type-public.ts +2 -2
  679. package/models/related-bid-relation.ts +2 -2
  680. package/models/request-invoice-split-request-dto.ts +2 -2
  681. package/models/request-invoice-split200-response.ts +2 -2
  682. package/models/retiree-roster-input-dto.ts +2 -2
  683. package/models/retiree-roster-row-dto.ts +2 -2
  684. package/models/revoke-request-dto.ts +2 -2
  685. package/models/rotate-secret-request-dto.ts +2 -2
  686. package/models/rotate-secret-response-dto.ts +2 -2
  687. package/models/semo-contract-registered-response-dto.ts +2 -2
  688. package/models/semo-contract-taxinvoice-status-response-dto.ts +2 -2
  689. package/models/site-briefing-input-dto.ts +2 -2
  690. package/models/statement-document-dto.ts +2 -2
  691. package/models/statement-product-dto.ts +2 -2
  692. package/models/supplier-card-payable-response-dto.ts +2 -2
  693. package/models/taxation-type-public.ts +2 -2
  694. package/models/token-request-dto.ts +2 -2
  695. package/models/token-response-dto.ts +2 -2
  696. package/models/two-stage-phase-public.ts +2 -2
  697. package/models/upload-file-request-dto.ts +2 -2
  698. package/models/upload-file201-response.ts +2 -2
  699. package/models/userinfo-response-dto.ts +2 -2
  700. package/package.json +1 -1
package/dist/models/upload-file-request-dto.d.ts CHANGED
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * CMARKET V6 Partner API
3
- * 외부 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`입니다. **축이 여러 개라 어느 것을 읽어야 하는지 한 곳에서 정리합니다.** - **분기**는 `status` → `type` → `code` 순서로 좁혀 가세요. 앞의 둘만으로 충분한 연동이 대부분이고, `code`는 같은 status·type 안에서 사유를 가릅니다. - **표시·로그**는 `title`과 `detail`을 쓰세요. 사람이 읽는 문장이며 예고 없이 다듬습니다 — **문자열 비교로 분기하지 마세요**. - **재시도**는 `Retry-After` 헤더가 있으면 그 값을, 없으면 `retryable`을, 그것도 없으면 `status`를 따르세요. - **문의**할 때는 `traceId`를 첨부하세요. - `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` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
3
+ * 외부 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`입니다. **축이 여러 개라 어느 것을 읽어야 하는지 한 곳에서 정리합니다.** - **분기**는 `status` → `type` → `code` 순서로 좁혀 가세요. 앞의 둘만으로 충분한 연동이 대부분이고, `code`는 같은 status·type 안에서 사유를 가릅니다. - **표시·로그**는 `title`과 `detail`을 쓰세요. 사람이 읽는 문장이며 예고 없이 다듬습니다 — **문자열 비교로 분기하지 마세요**. - **재시도**는 `Retry-After` 헤더가 있으면 그 값을, 없으면 `retryable`을, 그것도 없으면 `status`를 따르세요. - **문의**할 때는 `traceId`를 첨부하세요. - `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 별로 적혀 있습니다. ### 502와 4xx의 차이 - `502` `…/upstream-unavailable` — 조달플랫폼이 **일시적으로 처리하지 못했습니다.** 요청은 그대로 두고 backoff 후 재시도하세요. - `4xx` `…/upstream-*` — 조달플랫폼이 **요청을 거부했습니다.** 같은 요청을 다시 보내도 결과는 같습니다. `code`의 사유를 보고 요청을 고치세요. ### 멱등성 위반: 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` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
4
4
  *
5
- * The version of the OpenAPI document: 49.2.1
5
+ * The version of the OpenAPI document: 49.3.0
6
6
  * Contact: semo.io.kr@gmail.com
7
7
  *
8
8
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
package/dist/models/upload-file-request-dto.js CHANGED
@@ -3,9 +3,9 @@
3
3
  /* eslint-disable */
4
4
  /**
5
5
  * CMARKET V6 Partner API
6
- * 외부 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`입니다. **축이 여러 개라 어느 것을 읽어야 하는지 한 곳에서 정리합니다.** - **분기**는 `status` → `type` → `code` 순서로 좁혀 가세요. 앞의 둘만으로 충분한 연동이 대부분이고, `code`는 같은 status·type 안에서 사유를 가릅니다. - **표시·로그**는 `title`과 `detail`을 쓰세요. 사람이 읽는 문장이며 예고 없이 다듬습니다 — **문자열 비교로 분기하지 마세요**. - **재시도**는 `Retry-After` 헤더가 있으면 그 값을, 없으면 `retryable`을, 그것도 없으면 `status`를 따르세요. - **문의**할 때는 `traceId`를 첨부하세요. - `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` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
6
+ * 외부 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`입니다. **축이 여러 개라 어느 것을 읽어야 하는지 한 곳에서 정리합니다.** - **분기**는 `status` → `type` → `code` 순서로 좁혀 가세요. 앞의 둘만으로 충분한 연동이 대부분이고, `code`는 같은 status·type 안에서 사유를 가릅니다. - **표시·로그**는 `title`과 `detail`을 쓰세요. 사람이 읽는 문장이며 예고 없이 다듬습니다 — **문자열 비교로 분기하지 마세요**. - **재시도**는 `Retry-After` 헤더가 있으면 그 값을, 없으면 `retryable`을, 그것도 없으면 `status`를 따르세요. - **문의**할 때는 `traceId`를 첨부하세요. - `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 별로 적혀 있습니다. ### 502와 4xx의 차이 - `502` `…/upstream-unavailable` — 조달플랫폼이 **일시적으로 처리하지 못했습니다.** 요청은 그대로 두고 backoff 후 재시도하세요. - `4xx` `…/upstream-*` — 조달플랫폼이 **요청을 거부했습니다.** 같은 요청을 다시 보내도 결과는 같습니다. `code`의 사유를 보고 요청을 고치세요. ### 멱등성 위반: 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` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
7
7
  *
8
- * The version of the OpenAPI document: 49.2.1
8
+ * The version of the OpenAPI document: 49.3.0
9
9
  * Contact: semo.io.kr@gmail.com
10
10
  *
11
11
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
package/dist/models/upload-file201-response.d.ts CHANGED
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * CMARKET V6 Partner API
3
- * 외부 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`입니다. **축이 여러 개라 어느 것을 읽어야 하는지 한 곳에서 정리합니다.** - **분기**는 `status` → `type` → `code` 순서로 좁혀 가세요. 앞의 둘만으로 충분한 연동이 대부분이고, `code`는 같은 status·type 안에서 사유를 가릅니다. - **표시·로그**는 `title`과 `detail`을 쓰세요. 사람이 읽는 문장이며 예고 없이 다듬습니다 — **문자열 비교로 분기하지 마세요**. - **재시도**는 `Retry-After` 헤더가 있으면 그 값을, 없으면 `retryable`을, 그것도 없으면 `status`를 따르세요. - **문의**할 때는 `traceId`를 첨부하세요. - `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` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
3
+ * 외부 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`입니다. **축이 여러 개라 어느 것을 읽어야 하는지 한 곳에서 정리합니다.** - **분기**는 `status` → `type` → `code` 순서로 좁혀 가세요. 앞의 둘만으로 충분한 연동이 대부분이고, `code`는 같은 status·type 안에서 사유를 가릅니다. - **표시·로그**는 `title`과 `detail`을 쓰세요. 사람이 읽는 문장이며 예고 없이 다듬습니다 — **문자열 비교로 분기하지 마세요**. - **재시도**는 `Retry-After` 헤더가 있으면 그 값을, 없으면 `retryable`을, 그것도 없으면 `status`를 따르세요. - **문의**할 때는 `traceId`를 첨부하세요. - `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 별로 적혀 있습니다. ### 502와 4xx의 차이 - `502` `…/upstream-unavailable` — 조달플랫폼이 **일시적으로 처리하지 못했습니다.** 요청은 그대로 두고 backoff 후 재시도하세요. - `4xx` `…/upstream-*` — 조달플랫폼이 **요청을 거부했습니다.** 같은 요청을 다시 보내도 결과는 같습니다. `code`의 사유를 보고 요청을 고치세요. ### 멱등성 위반: 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` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
4
4
  *
5
- * The version of the OpenAPI document: 49.2.1
5
+ * The version of the OpenAPI document: 49.3.0
6
6
  * Contact: semo.io.kr@gmail.com
7
7
  *
8
8
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
package/dist/models/upload-file201-response.js CHANGED
@@ -3,9 +3,9 @@
3
3
  /* eslint-disable */
4
4
  /**
5
5
  * CMARKET V6 Partner API
6
- * 외부 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`입니다. **축이 여러 개라 어느 것을 읽어야 하는지 한 곳에서 정리합니다.** - **분기**는 `status` → `type` → `code` 순서로 좁혀 가세요. 앞의 둘만으로 충분한 연동이 대부분이고, `code`는 같은 status·type 안에서 사유를 가릅니다. - **표시·로그**는 `title`과 `detail`을 쓰세요. 사람이 읽는 문장이며 예고 없이 다듬습니다 — **문자열 비교로 분기하지 마세요**. - **재시도**는 `Retry-After` 헤더가 있으면 그 값을, 없으면 `retryable`을, 그것도 없으면 `status`를 따르세요. - **문의**할 때는 `traceId`를 첨부하세요. - `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` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
6
+ * 외부 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`입니다. **축이 여러 개라 어느 것을 읽어야 하는지 한 곳에서 정리합니다.** - **분기**는 `status` → `type` → `code` 순서로 좁혀 가세요. 앞의 둘만으로 충분한 연동이 대부분이고, `code`는 같은 status·type 안에서 사유를 가릅니다. - **표시·로그**는 `title`과 `detail`을 쓰세요. 사람이 읽는 문장이며 예고 없이 다듬습니다 — **문자열 비교로 분기하지 마세요**. - **재시도**는 `Retry-After` 헤더가 있으면 그 값을, 없으면 `retryable`을, 그것도 없으면 `status`를 따르세요. - **문의**할 때는 `traceId`를 첨부하세요. - `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 별로 적혀 있습니다. ### 502와 4xx의 차이 - `502` `…/upstream-unavailable` — 조달플랫폼이 **일시적으로 처리하지 못했습니다.** 요청은 그대로 두고 backoff 후 재시도하세요. - `4xx` `…/upstream-*` — 조달플랫폼이 **요청을 거부했습니다.** 같은 요청을 다시 보내도 결과는 같습니다. `code`의 사유를 보고 요청을 고치세요. ### 멱등성 위반: 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` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
7
7
  *
8
- * The version of the OpenAPI document: 49.2.1
8
+ * The version of the OpenAPI document: 49.3.0
9
9
  * Contact: semo.io.kr@gmail.com
10
10
  *
11
11
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
package/dist/models/userinfo-response-dto.d.ts CHANGED
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * CMARKET V6 Partner API
3
- * 외부 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`입니다. **축이 여러 개라 어느 것을 읽어야 하는지 한 곳에서 정리합니다.** - **분기**는 `status` → `type` → `code` 순서로 좁혀 가세요. 앞의 둘만으로 충분한 연동이 대부분이고, `code`는 같은 status·type 안에서 사유를 가릅니다. - **표시·로그**는 `title`과 `detail`을 쓰세요. 사람이 읽는 문장이며 예고 없이 다듬습니다 — **문자열 비교로 분기하지 마세요**. - **재시도**는 `Retry-After` 헤더가 있으면 그 값을, 없으면 `retryable`을, 그것도 없으면 `status`를 따르세요. - **문의**할 때는 `traceId`를 첨부하세요. - `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` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
3
+ * 외부 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`입니다. **축이 여러 개라 어느 것을 읽어야 하는지 한 곳에서 정리합니다.** - **분기**는 `status` → `type` → `code` 순서로 좁혀 가세요. 앞의 둘만으로 충분한 연동이 대부분이고, `code`는 같은 status·type 안에서 사유를 가릅니다. - **표시·로그**는 `title`과 `detail`을 쓰세요. 사람이 읽는 문장이며 예고 없이 다듬습니다 — **문자열 비교로 분기하지 마세요**. - **재시도**는 `Retry-After` 헤더가 있으면 그 값을, 없으면 `retryable`을, 그것도 없으면 `status`를 따르세요. - **문의**할 때는 `traceId`를 첨부하세요. - `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 별로 적혀 있습니다. ### 502와 4xx의 차이 - `502` `…/upstream-unavailable` — 조달플랫폼이 **일시적으로 처리하지 못했습니다.** 요청은 그대로 두고 backoff 후 재시도하세요. - `4xx` `…/upstream-*` — 조달플랫폼이 **요청을 거부했습니다.** 같은 요청을 다시 보내도 결과는 같습니다. `code`의 사유를 보고 요청을 고치세요. ### 멱등성 위반: 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` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
4
4
  *
5
- * The version of the OpenAPI document: 49.2.1
5
+ * The version of the OpenAPI document: 49.3.0
6
6
  * Contact: semo.io.kr@gmail.com
7
7
  *
8
8
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
package/dist/models/userinfo-response-dto.js CHANGED
@@ -3,9 +3,9 @@
3
3
  /* eslint-disable */
4
4
  /**
5
5
  * CMARKET V6 Partner API
6
- * 외부 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`입니다. **축이 여러 개라 어느 것을 읽어야 하는지 한 곳에서 정리합니다.** - **분기**는 `status` → `type` → `code` 순서로 좁혀 가세요. 앞의 둘만으로 충분한 연동이 대부분이고, `code`는 같은 status·type 안에서 사유를 가릅니다. - **표시·로그**는 `title`과 `detail`을 쓰세요. 사람이 읽는 문장이며 예고 없이 다듬습니다 — **문자열 비교로 분기하지 마세요**. - **재시도**는 `Retry-After` 헤더가 있으면 그 값을, 없으면 `retryable`을, 그것도 없으면 `status`를 따르세요. - **문의**할 때는 `traceId`를 첨부하세요. - `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` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
6
+ * 외부 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`입니다. **축이 여러 개라 어느 것을 읽어야 하는지 한 곳에서 정리합니다.** - **분기**는 `status` → `type` → `code` 순서로 좁혀 가세요. 앞의 둘만으로 충분한 연동이 대부분이고, `code`는 같은 status·type 안에서 사유를 가릅니다. - **표시·로그**는 `title`과 `detail`을 쓰세요. 사람이 읽는 문장이며 예고 없이 다듬습니다 — **문자열 비교로 분기하지 마세요**. - **재시도**는 `Retry-After` 헤더가 있으면 그 값을, 없으면 `retryable`을, 그것도 없으면 `status`를 따르세요. - **문의**할 때는 `traceId`를 첨부하세요. - `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 별로 적혀 있습니다. ### 502와 4xx의 차이 - `502` `…/upstream-unavailable` — 조달플랫폼이 **일시적으로 처리하지 못했습니다.** 요청은 그대로 두고 backoff 후 재시도하세요. - `4xx` `…/upstream-*` — 조달플랫폼이 **요청을 거부했습니다.** 같은 요청을 다시 보내도 결과는 같습니다. `code`의 사유를 보고 요청을 고치세요. ### 멱등성 위반: 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` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
7
7
  *
8
- * The version of the OpenAPI document: 49.2.1
8
+ * The version of the OpenAPI document: 49.3.0
9
9
  * Contact: semo.io.kr@gmail.com
10
10
  *
11
11
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
package/docs/EmbedApi.md CHANGED
@@ -61,7 +61,7 @@ const { status, data } = await apiInstance.createEmbedLaunch(
61
61
  |**422** | 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). | - |
62
62
  |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br> * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br> |
63
63
  |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. | - |
64
- |**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. | - |
64
+ |**502** | 조달플랫폼이 일시적으로 처리하지 못함(&#x60;…/upstream-unavailable&#x60;). 요청을 고칠 필요는 없습니다 — backoff 후 재시도하세요. &#x60;retryable: true&#x60;. | - |
65
65
  |**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> |
66
66
 
67
67
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
package/docs/PartnerApiApi.md CHANGED
@@ -83,7 +83,7 @@ const { status, data } = await apiInstance.completeAcceptance(
83
83
  |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. | - |
84
84
  |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br> * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br> |
85
85
  |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. | - |
86
- |**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. | - |
86
+ |**502** | 조달플랫폼이 일시적으로 처리하지 못함(&#x60;…/upstream-unavailable&#x60;). 요청을 고칠 필요는 없습니다 — backoff 후 재시도하세요. &#x60;retryable: true&#x60;. | - |
87
87
  |**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> |
88
88
 
89
89
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
@@ -147,7 +147,7 @@ const { status, data } = await apiInstance.createCardPayment(
147
147
  |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. | - |
148
148
  |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br> * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br> |
149
149
  |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. | - |
150
- |**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. | - |
150
+ |**502** | 조달플랫폼이 일시적으로 처리하지 못함(&#x60;…/upstream-unavailable&#x60;). 요청을 고칠 필요는 없습니다 — backoff 후 재시도하세요. &#x60;retryable: true&#x60;. | - |
151
151
  |**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> |
152
152
 
153
153
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
@@ -211,7 +211,7 @@ const { status, data } = await apiInstance.createExternalContractDocuments(
211
211
  |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. | - |
212
212
  |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br> * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br> |
213
213
  |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. | - |
214
- |**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. | - |
214
+ |**502** | 조달플랫폼이 일시적으로 처리하지 못함(&#x60;…/upstream-unavailable&#x60;). 요청을 고칠 필요는 없습니다 — backoff 후 재시도하세요. &#x60;retryable: true&#x60;. | - |
215
215
  |**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> |
216
216
 
217
217
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
@@ -328,7 +328,7 @@ const { status, data } = await apiInstance.getBidStatement(
328
328
  |**404** | 대상 없음(&#x60;…/upstream-not-found&#x60;). | - |
329
329
  |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br> * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br> |
330
330
  |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. | - |
331
- |**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. | - |
331
+ |**502** | 조달플랫폼이 일시적으로 처리하지 못함(&#x60;…/upstream-unavailable&#x60;). 요청을 고칠 필요는 없습니다 — backoff 후 재시도하세요. &#x60;retryable: true&#x60;. | - |
332
332
  |**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> |
333
333
 
334
334
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
@@ -442,7 +442,7 @@ const { status, data } = await apiInstance.getSupplierCardPayableV2(
442
442
  |**404** | 대상 없음(&#x60;…/upstream-not-found&#x60;). | - |
443
443
  |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br> * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br> |
444
444
  |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. | - |
445
- |**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. | - |
445
+ |**502** | 조달플랫폼이 일시적으로 처리하지 못함(&#x60;…/upstream-unavailable&#x60;). 요청을 고칠 필요는 없습니다 — backoff 후 재시도하세요. &#x60;retryable: true&#x60;. | - |
446
446
  |**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> |
447
447
 
448
448
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
@@ -559,7 +559,7 @@ const { status, data } = await apiInstance.listBidResults(
559
559
  |**404** | 대상 없음(&#x60;…/upstream-not-found&#x60;). | - |
560
560
  |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br> * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br> |
561
561
  |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. | - |
562
- |**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. | - |
562
+ |**502** | 조달플랫폼이 일시적으로 처리하지 못함(&#x60;…/upstream-unavailable&#x60;). 요청을 고칠 필요는 없습니다 — backoff 후 재시도하세요. &#x60;retryable: true&#x60;. | - |
563
563
  |**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> |
564
564
 
565
565
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
@@ -621,7 +621,7 @@ const { status, data } = await apiInstance.listExternalContractDocuments(
621
621
  |**404** | 대상 없음(&#x60;…/upstream-not-found&#x60;). | - |
622
622
  |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br> * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br> |
623
623
  |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. | - |
624
- |**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. | - |
624
+ |**502** | 조달플랫폼이 일시적으로 처리하지 못함(&#x60;…/upstream-unavailable&#x60;). 요청을 고칠 필요는 없습니다 — backoff 후 재시도하세요. &#x60;retryable: true&#x60;. | - |
625
625
  |**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> |
626
626
 
627
627
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
@@ -688,7 +688,7 @@ const { status, data } = await apiInstance.markBidFailed(
688
688
  |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. | - |
689
689
  |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br> * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br> |
690
690
  |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. | - |
691
- |**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. | - |
691
+ |**502** | 조달플랫폼이 일시적으로 처리하지 못함(&#x60;…/upstream-unavailable&#x60;). 요청을 고칠 필요는 없습니다 — backoff 후 재시도하세요. &#x60;retryable: true&#x60;. | - |
692
692
  |**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> |
693
693
 
694
694
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
@@ -755,7 +755,7 @@ const { status, data } = await apiInstance.registerAward(
755
755
  |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. | - |
756
756
  |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br> * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br> |
757
757
  |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. | - |
758
- |**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. | - |
758
+ |**502** | 조달플랫폼이 일시적으로 처리하지 못함(&#x60;…/upstream-unavailable&#x60;). 요청을 고칠 필요는 없습니다 — backoff 후 재시도하세요. &#x60;retryable: true&#x60;. | - |
759
759
  |**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> |
760
760
 
761
761
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
@@ -819,7 +819,7 @@ const { status, data } = await apiInstance.registerBid(
819
819
  |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. | - |
820
820
  |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br> * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br> |
821
821
  |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. | - |
822
- |**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. | - |
822
+ |**502** | 조달플랫폼이 일시적으로 처리하지 못함(&#x60;…/upstream-unavailable&#x60;). 요청을 고칠 필요는 없습니다 — backoff 후 재시도하세요. &#x60;retryable: true&#x60;. | - |
823
823
  |**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> |
824
824
 
825
825
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
@@ -883,7 +883,7 @@ const { status, data } = await apiInstance.registerSemoContract(
883
883
  |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. | - |
884
884
  |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br> * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br> |
885
885
  |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. | - |
886
- |**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. | - |
886
+ |**502** | 조달플랫폼이 일시적으로 처리하지 못함(&#x60;…/upstream-unavailable&#x60;). 요청을 고칠 필요는 없습니다 — backoff 후 재시도하세요. &#x60;retryable: true&#x60;. | - |
887
887
  |**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> |
888
888
 
889
889
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
@@ -950,7 +950,7 @@ const { status, data } = await apiInstance.requestInvoiceSplit(
950
950
  |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. | - |
951
951
  |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br> * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br> |
952
952
  |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. | - |
953
- |**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. | - |
953
+ |**502** | 조달플랫폼이 일시적으로 처리하지 못함(&#x60;…/upstream-unavailable&#x60;). 요청을 고칠 필요는 없습니다 — backoff 후 재시도하세요. &#x60;retryable: true&#x60;. | - |
954
954
  |**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> |
955
955
 
956
956
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
@@ -1015,7 +1015,7 @@ const { status, data } = await apiInstance.uploadFile(
1015
1015
  |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. | - |
1016
1016
  |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br> * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br> |
1017
1017
  |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. | - |
1018
- |**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. | - |
1018
+ |**502** | 조달플랫폼이 일시적으로 처리하지 못함(&#x60;…/upstream-unavailable&#x60;). 요청을 고칠 필요는 없습니다 — backoff 후 재시도하세요. &#x60;retryable: true&#x60;. | - |
1019
1019
  |**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> |
1020
1020
 
1021
1021
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
package/docs/ProductsApi.md CHANGED
@@ -66,7 +66,7 @@ const { status, data } = await apiInstance.acknowledgeProductReceipt(
66
66
  |**422** | 같은 &#x60;Idempotency-Key&#x60;를 다른 body로 재전송(&#x60;…/idempotency-key-reused&#x60;), 또는 내용상 처리 불가(&#x60;…/upstream-unprocessable&#x60;). 재시도해도 같은 실패이므로 새 키를 쓰거나 body를 되돌립니다. | - |
67
67
  |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br> * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br> |
68
68
  |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. | - |
69
- |**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. | - |
69
+ |**502** | 조달플랫폼이 일시적으로 처리하지 못함(&#x60;…/upstream-unavailable&#x60;). 요청을 고칠 필요는 없습니다 — backoff 후 재시도하세요. &#x60;retryable: true&#x60;. | - |
70
70
  |**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> |
71
71
 
72
72
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
@@ -129,7 +129,7 @@ const { status, data } = await apiInstance.listProducts(
129
129
  |**404** | 대상 없음(&#x60;…/upstream-not-found&#x60;). | - |
130
130
  |**429** | 요청 한도 초과(&#x60;…/too-many-requests&#x60;). 한도는 &#x60;client_id&#x60;당 분당 60회. 대기 시간은 &#x60;Retry-After&#x60;(초), 잔여 쿼터는 &#x60;RateLimit&#x60;·&#x60;RateLimit-Policy&#x60; 헤더에 실립니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> * RateLimit - 현재 창의 잔여 쿼터. 예: &#x60;\&quot;default\&quot;;r&#x3D;0;t&#x3D;42&#x60;. <br> * RateLimit-Policy - 적용 중인 쿼터 정책(&#x60;q&#x60; 요청 수 / &#x60;w&#x60; 창 크기(초)). 변하지 않으므로 한 번 읽어 두면 됩니다. <br> |
131
131
  |**500** | 서버 내부 오류(&#x60;…/internal-server-error&#x60;). &#x60;retryable: true&#x60;. | - |
132
- |**502** | 요청 처리 실패(&#x60;…/upstream-rejected&#x60;). &#x60;retryable: true&#x60;. | - |
132
+ |**502** | 조달플랫폼이 일시적으로 처리하지 못함(&#x60;…/upstream-unavailable&#x60;). 요청을 고칠 필요는 없습니다 — backoff 후 재시도하세요. &#x60;retryable: true&#x60;. | - |
133
133
  |**503** | 일시적 처리 불가(&#x60;…/service-unavailable&#x60;). &#x60;Retry-After&#x60; 헤더를 따릅니다. &#x60;retryable: true&#x60;. | * Retry-After - 재시도까지 대기할 초. <br> |
134
134
 
135
135
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
package/index.ts CHANGED
@@ -2,9 +2,9 @@
2
2
  /* eslint-disable */
3
3
  /**
4
4
  * CMARKET V6 Partner API
5
- * 외부 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`입니다. **축이 여러 개라 어느 것을 읽어야 하는지 한 곳에서 정리합니다.** - **분기**는 `status` → `type` → `code` 순서로 좁혀 가세요. 앞의 둘만으로 충분한 연동이 대부분이고, `code`는 같은 status·type 안에서 사유를 가릅니다. - **표시·로그**는 `title`과 `detail`을 쓰세요. 사람이 읽는 문장이며 예고 없이 다듬습니다 — **문자열 비교로 분기하지 마세요**. - **재시도**는 `Retry-After` 헤더가 있으면 그 값을, 없으면 `retryable`을, 그것도 없으면 `status`를 따르세요. - **문의**할 때는 `traceId`를 첨부하세요. - `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` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
5
+ * 외부 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`입니다. **축이 여러 개라 어느 것을 읽어야 하는지 한 곳에서 정리합니다.** - **분기**는 `status` → `type` → `code` 순서로 좁혀 가세요. 앞의 둘만으로 충분한 연동이 대부분이고, `code`는 같은 status·type 안에서 사유를 가릅니다. - **표시·로그**는 `title`과 `detail`을 쓰세요. 사람이 읽는 문장이며 예고 없이 다듬습니다 — **문자열 비교로 분기하지 마세요**. - **재시도**는 `Retry-After` 헤더가 있으면 그 값을, 없으면 `retryable`을, 그것도 없으면 `status`를 따르세요. - **문의**할 때는 `traceId`를 첨부하세요. - `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 별로 적혀 있습니다. ### 502와 4xx의 차이 - `502` `…/upstream-unavailable` — 조달플랫폼이 **일시적으로 처리하지 못했습니다.** 요청은 그대로 두고 backoff 후 재시도하세요. - `4xx` `…/upstream-*` — 조달플랫폼이 **요청을 거부했습니다.** 같은 요청을 다시 보내도 결과는 같습니다. `code`의 사유를 보고 요청을 고치세요. ### 멱등성 위반: 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` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
6
6
  *
7
- * The version of the OpenAPI document: 49.2.1
7
+ * The version of the OpenAPI document: 49.3.0
8
8
  * Contact: semo.io.kr@gmail.com
9
9
  *
10
10
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
package/models/acceptance-result-response-dto.ts CHANGED
@@ -2,9 +2,9 @@
2
2
  /* eslint-disable */
3
3
  /**
4
4
  * CMARKET V6 Partner API
5
- * 외부 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`입니다. **축이 여러 개라 어느 것을 읽어야 하는지 한 곳에서 정리합니다.** - **분기**는 `status` → `type` → `code` 순서로 좁혀 가세요. 앞의 둘만으로 충분한 연동이 대부분이고, `code`는 같은 status·type 안에서 사유를 가릅니다. - **표시·로그**는 `title`과 `detail`을 쓰세요. 사람이 읽는 문장이며 예고 없이 다듬습니다 — **문자열 비교로 분기하지 마세요**. - **재시도**는 `Retry-After` 헤더가 있으면 그 값을, 없으면 `retryable`을, 그것도 없으면 `status`를 따르세요. - **문의**할 때는 `traceId`를 첨부하세요. - `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` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
5
+ * 외부 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`입니다. **축이 여러 개라 어느 것을 읽어야 하는지 한 곳에서 정리합니다.** - **분기**는 `status` → `type` → `code` 순서로 좁혀 가세요. 앞의 둘만으로 충분한 연동이 대부분이고, `code`는 같은 status·type 안에서 사유를 가릅니다. - **표시·로그**는 `title`과 `detail`을 쓰세요. 사람이 읽는 문장이며 예고 없이 다듬습니다 — **문자열 비교로 분기하지 마세요**. - **재시도**는 `Retry-After` 헤더가 있으면 그 값을, 없으면 `retryable`을, 그것도 없으면 `status`를 따르세요. - **문의**할 때는 `traceId`를 첨부하세요. - `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 별로 적혀 있습니다. ### 502와 4xx의 차이 - `502` `…/upstream-unavailable` — 조달플랫폼이 **일시적으로 처리하지 못했습니다.** 요청은 그대로 두고 backoff 후 재시도하세요. - `4xx` `…/upstream-*` — 조달플랫폼이 **요청을 거부했습니다.** 같은 요청을 다시 보내도 결과는 같습니다. `code`의 사유를 보고 요청을 고치세요. ### 멱등성 위반: 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` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
6
6
  *
7
- * The version of the OpenAPI document: 49.2.1
7
+ * The version of the OpenAPI document: 49.3.0
8
8
  * Contact: semo.io.kr@gmail.com
9
9
  *
10
10
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
package/models/acknowledge-product-receipt200-response.ts CHANGED
@@ -2,9 +2,9 @@
2
2
  /* eslint-disable */
3
3
  /**
4
4
  * CMARKET V6 Partner API
5
- * 외부 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`입니다. **축이 여러 개라 어느 것을 읽어야 하는지 한 곳에서 정리합니다.** - **분기**는 `status` → `type` → `code` 순서로 좁혀 가세요. 앞의 둘만으로 충분한 연동이 대부분이고, `code`는 같은 status·type 안에서 사유를 가릅니다. - **표시·로그**는 `title`과 `detail`을 쓰세요. 사람이 읽는 문장이며 예고 없이 다듬습니다 — **문자열 비교로 분기하지 마세요**. - **재시도**는 `Retry-After` 헤더가 있으면 그 값을, 없으면 `retryable`을, 그것도 없으면 `status`를 따르세요. - **문의**할 때는 `traceId`를 첨부하세요. - `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` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
5
+ * 외부 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`입니다. **축이 여러 개라 어느 것을 읽어야 하는지 한 곳에서 정리합니다.** - **분기**는 `status` → `type` → `code` 순서로 좁혀 가세요. 앞의 둘만으로 충분한 연동이 대부분이고, `code`는 같은 status·type 안에서 사유를 가릅니다. - **표시·로그**는 `title`과 `detail`을 쓰세요. 사람이 읽는 문장이며 예고 없이 다듬습니다 — **문자열 비교로 분기하지 마세요**. - **재시도**는 `Retry-After` 헤더가 있으면 그 값을, 없으면 `retryable`을, 그것도 없으면 `status`를 따르세요. - **문의**할 때는 `traceId`를 첨부하세요. - `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 별로 적혀 있습니다. ### 502와 4xx의 차이 - `502` `…/upstream-unavailable` — 조달플랫폼이 **일시적으로 처리하지 못했습니다.** 요청은 그대로 두고 backoff 후 재시도하세요. - `4xx` `…/upstream-*` — 조달플랫폼이 **요청을 거부했습니다.** 같은 요청을 다시 보내도 결과는 같습니다. `code`의 사유를 보고 요청을 고치세요. ### 멱등성 위반: 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` 헤더로 통지합니다. 이 헤더를 모니터링하세요.
6
6
  *
7
- * The version of the OpenAPI document: 49.2.1
7
+ * The version of the OpenAPI document: 49.3.0
8
8
  * Contact: semo.io.kr@gmail.com
9
9
  *
10
10
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).