@cmarket/partner-sdk 22.6.0 β†’ 22.7.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 (605) hide show
  1. package/README.md +8 -4
  2. package/api/oauth-api.ts +1 -1
  3. package/api/partner-v1-api.ts +1 -1
  4. package/api/partner-v2-api.ts +1 -1
  5. package/api/well-known-api.ts +180 -0
  6. package/api.ts +2 -1
  7. package/base.ts +1 -1
  8. package/common.ts +1 -1
  9. package/configuration.ts +1 -1
  10. package/dist/api/oauth-api.d.ts +1 -1
  11. package/dist/api/oauth-api.js +1 -1
  12. package/dist/api/partner-v1-api.d.ts +1 -1
  13. package/dist/api/partner-v1-api.js +1 -1
  14. package/dist/api/partner-v2-api.d.ts +1 -1
  15. package/dist/api/partner-v2-api.js +1 -1
  16. package/dist/api/well-known-api.d.ts +92 -0
  17. package/dist/api/well-known-api.js +181 -0
  18. package/dist/api.d.ts +2 -1
  19. package/dist/api.js +2 -1
  20. package/dist/base.d.ts +1 -1
  21. package/dist/base.js +1 -1
  22. package/dist/common.d.ts +1 -1
  23. package/dist/common.js +1 -1
  24. package/dist/configuration.d.ts +1 -1
  25. package/dist/configuration.js +1 -1
  26. package/dist/esm/api/oauth-api.d.ts +1 -1
  27. package/dist/esm/api/oauth-api.js +1 -1
  28. package/dist/esm/api/partner-v1-api.d.ts +1 -1
  29. package/dist/esm/api/partner-v1-api.js +1 -1
  30. package/dist/esm/api/partner-v2-api.d.ts +1 -1
  31. package/dist/esm/api/partner-v2-api.js +1 -1
  32. package/dist/esm/api/well-known-api.d.ts +92 -0
  33. package/dist/esm/api/well-known-api.js +174 -0
  34. package/dist/esm/api.d.ts +2 -1
  35. package/dist/esm/api.js +2 -1
  36. package/dist/esm/base.d.ts +1 -1
  37. package/dist/esm/base.js +1 -1
  38. package/dist/esm/common.d.ts +1 -1
  39. package/dist/esm/common.js +1 -1
  40. package/dist/esm/configuration.d.ts +1 -1
  41. package/dist/esm/configuration.js +1 -1
  42. package/dist/esm/index.d.ts +1 -1
  43. package/dist/esm/index.js +1 -1
  44. package/dist/esm/models/acceptance-result-response-dto.d.ts +1 -1
  45. package/dist/esm/models/acceptance-result-response-dto.js +1 -1
  46. package/dist/esm/models/acceptance-result-v1-response-dto.d.ts +1 -1
  47. package/dist/esm/models/acceptance-result-v1-response-dto.js +1 -1
  48. package/dist/esm/models/acknowledge-products-v1-request-dto.d.ts +1 -1
  49. package/dist/esm/models/acknowledge-products-v1-request-dto.js +1 -1
  50. package/dist/esm/models/authorization-server-metadata-dto.d.ts +45 -0
  51. package/dist/esm/models/authorization-server-metadata-dto.js +14 -0
  52. package/dist/esm/models/award-method-public.d.ts +1 -1
  53. package/dist/esm/models/award-method-public.js +1 -1
  54. package/dist/esm/models/award-registered-response-dto.d.ts +1 -1
  55. package/dist/esm/models/award-registered-response-dto.js +1 -1
  56. package/dist/esm/models/award-registered-v2-response-dto.d.ts +1 -1
  57. package/dist/esm/models/award-registered-v2-response-dto.js +1 -1
  58. package/dist/esm/models/bid-attachment-v1-dto.d.ts +1 -1
  59. package/dist/esm/models/bid-attachment-v1-dto.js +1 -1
  60. package/dist/esm/models/bid-bond-dto.d.ts +1 -1
  61. package/dist/esm/models/bid-bond-dto.js +1 -1
  62. package/dist/esm/models/bid-bond-v1-dto.d.ts +1 -1
  63. package/dist/esm/models/bid-bond-v1-dto.js +1 -1
  64. package/dist/esm/models/bid-contract-documents-batch-v1-request-dto.d.ts +1 -1
  65. package/dist/esm/models/bid-contract-documents-batch-v1-request-dto.js +1 -1
  66. package/dist/esm/models/bid-contract-documents-v1-response-dto.d.ts +1 -1
  67. package/dist/esm/models/bid-contract-documents-v1-response-dto.js +1 -1
  68. package/dist/esm/models/bid-created-response-dto.d.ts +1 -1
  69. package/dist/esm/models/bid-created-response-dto.js +1 -1
  70. package/dist/esm/models/bid-detail-response-dto.d.ts +1 -1
  71. package/dist/esm/models/bid-detail-response-dto.js +1 -1
  72. package/dist/esm/models/bid-document-dto.d.ts +1 -1
  73. package/dist/esm/models/bid-document-dto.js +1 -1
  74. package/dist/esm/models/bid-document-v1-dto.d.ts +1 -1
  75. package/dist/esm/models/bid-document-v1-dto.js +1 -1
  76. package/dist/esm/models/bid-failed-response-dto.d.ts +1 -1
  77. package/dist/esm/models/bid-failed-response-dto.js +1 -1
  78. package/dist/esm/models/bid-failed-v2-response-dto.d.ts +1 -1
  79. package/dist/esm/models/bid-failed-v2-response-dto.js +1 -1
  80. package/dist/esm/models/bid-failure-reason.d.ts +1 -1
  81. package/dist/esm/models/bid-failure-reason.js +1 -1
  82. package/dist/esm/models/bid-item-dto.d.ts +1 -1
  83. package/dist/esm/models/bid-item-dto.js +1 -1
  84. package/dist/esm/models/bid-item-v1-dto.d.ts +1 -1
  85. package/dist/esm/models/bid-item-v1-dto.js +1 -1
  86. package/dist/esm/models/bid-lifecycle-dto.d.ts +1 -1
  87. package/dist/esm/models/bid-lifecycle-dto.js +1 -1
  88. package/dist/esm/models/bid-manager-dto.d.ts +1 -1
  89. package/dist/esm/models/bid-manager-dto.js +1 -1
  90. package/dist/esm/models/bid-manager-v1-dto.d.ts +1 -1
  91. package/dist/esm/models/bid-manager-v1-dto.js +1 -1
  92. package/dist/esm/models/bid-participant-summary-dto.d.ts +1 -1
  93. package/dist/esm/models/bid-participant-summary-dto.js +1 -1
  94. package/dist/esm/models/bid-public-status.d.ts +1 -1
  95. package/dist/esm/models/bid-public-status.js +1 -1
  96. package/dist/esm/models/bid-published-response-dto.d.ts +1 -1
  97. package/dist/esm/models/bid-published-response-dto.js +1 -1
  98. package/dist/esm/models/bid-registered-response-dto.d.ts +1 -1
  99. package/dist/esm/models/bid-registered-response-dto.js +1 -1
  100. package/dist/esm/models/bid-result-participant-attachment-dto.d.ts +1 -1
  101. package/dist/esm/models/bid-result-participant-attachment-dto.js +1 -1
  102. package/dist/esm/models/bid-result-participant-dto.d.ts +1 -1
  103. package/dist/esm/models/bid-result-participant-dto.js +1 -1
  104. package/dist/esm/models/bid-result-v1-attachment-dto.d.ts +1 -1
  105. package/dist/esm/models/bid-result-v1-attachment-dto.js +1 -1
  106. package/dist/esm/models/bid-result-v1-bid-product-info-dto.d.ts +1 -1
  107. package/dist/esm/models/bid-result-v1-bid-product-info-dto.js +1 -1
  108. package/dist/esm/models/bid-result-v1-participant-dto.d.ts +1 -1
  109. package/dist/esm/models/bid-result-v1-participant-dto.js +1 -1
  110. package/dist/esm/models/bid-result-v1-product-dto.d.ts +1 -1
  111. package/dist/esm/models/bid-result-v1-product-dto.js +1 -1
  112. package/dist/esm/models/bid-results-batch-v1-request-dto.d.ts +1 -1
  113. package/dist/esm/models/bid-results-batch-v1-request-dto.js +1 -1
  114. package/dist/esm/models/bid-results-response-dto.d.ts +1 -1
  115. package/dist/esm/models/bid-results-response-dto.js +1 -1
  116. package/dist/esm/models/bid-results-v1-response-dto.d.ts +1 -1
  117. package/dist/esm/models/bid-results-v1-response-dto.js +1 -1
  118. package/dist/esm/models/bid-settlement-line-item-dto.d.ts +1 -1
  119. package/dist/esm/models/bid-settlement-line-item-dto.js +1 -1
  120. package/dist/esm/models/bid-settlement-participant-dto.d.ts +1 -1
  121. package/dist/esm/models/bid-settlement-participant-dto.js +1 -1
  122. package/dist/esm/models/bid-settlement-response-dto.d.ts +1 -1
  123. package/dist/esm/models/bid-settlement-response-dto.js +1 -1
  124. package/dist/esm/models/bid-statement-response-dto.d.ts +1 -1
  125. package/dist/esm/models/bid-statement-response-dto.js +1 -1
  126. package/dist/esm/models/bid-statement-v1-response-dto.d.ts +1 -1
  127. package/dist/esm/models/bid-statement-v1-response-dto.js +1 -1
  128. package/dist/esm/models/bid-status.d.ts +1 -1
  129. package/dist/esm/models/bid-status.js +1 -1
  130. package/dist/esm/models/bid-summary-dto.d.ts +1 -1
  131. package/dist/esm/models/bid-summary-dto.js +1 -1
  132. package/dist/esm/models/bid-updated-response-dto.d.ts +1 -1
  133. package/dist/esm/models/bid-updated-response-dto.js +1 -1
  134. package/dist/esm/models/card-payment-request-response-dto.d.ts +1 -1
  135. package/dist/esm/models/card-payment-request-response-dto.js +1 -1
  136. package/dist/esm/models/close-sandbox-bid-response-dto.d.ts +1 -1
  137. package/dist/esm/models/close-sandbox-bid-response-dto.js +1 -1
  138. package/dist/esm/models/complete-acceptance-request-dto.d.ts +1 -1
  139. package/dist/esm/models/complete-acceptance-request-dto.js +1 -1
  140. package/dist/esm/models/complete-acceptance-v1-request-dto.d.ts +1 -1
  141. package/dist/esm/models/complete-acceptance-v1-request-dto.js +1 -1
  142. package/dist/esm/models/contract-document-item-dto.d.ts +1 -1
  143. package/dist/esm/models/contract-document-item-dto.js +1 -1
  144. package/dist/esm/models/contract-documents-regenerated-response-dto.d.ts +1 -1
  145. package/dist/esm/models/contract-documents-regenerated-response-dto.js +1 -1
  146. package/dist/esm/models/contract-restriction-confirm-input-dto.d.ts +1 -1
  147. package/dist/esm/models/contract-restriction-confirm-input-dto.js +1 -1
  148. package/dist/esm/models/create-bid-request-dto.d.ts +1 -1
  149. package/dist/esm/models/create-bid-request-dto.js +1 -1
  150. package/dist/esm/models/create-bid-v1-request-dto.d.ts +1 -1
  151. package/dist/esm/models/create-bid-v1-request-dto.js +1 -1
  152. package/dist/esm/models/create-card-payment-request-dto.d.ts +1 -1
  153. package/dist/esm/models/create-card-payment-request-dto.js +1 -1
  154. package/dist/esm/models/create-external-contract-documents-request-dto.d.ts +1 -1
  155. package/dist/esm/models/create-external-contract-documents-request-dto.js +1 -1
  156. package/dist/esm/models/create-external-contract-documents-response-dto.d.ts +1 -1
  157. package/dist/esm/models/create-external-contract-documents-response-dto.js +1 -1
  158. package/dist/esm/models/embed-launch-request-dto.d.ts +1 -1
  159. package/dist/esm/models/embed-launch-request-dto.js +1 -1
  160. package/dist/esm/models/embed-launch-response-dto.d.ts +1 -1
  161. package/dist/esm/models/embed-launch-response-dto.js +1 -1
  162. package/dist/esm/models/external-contract-document-item-dto.d.ts +1 -1
  163. package/dist/esm/models/external-contract-document-item-dto.js +1 -1
  164. package/dist/esm/models/external-contract-documents-response-dto.d.ts +1 -1
  165. package/dist/esm/models/external-contract-documents-response-dto.js +1 -1
  166. package/dist/esm/models/external-contract-item-dto.d.ts +1 -1
  167. package/dist/esm/models/external-contract-item-dto.js +1 -1
  168. package/dist/esm/models/external-contract-snapshot-dto.d.ts +1 -1
  169. package/dist/esm/models/external-contract-snapshot-dto.js +1 -1
  170. package/dist/esm/models/external-document-inputs-dto.d.ts +1 -1
  171. package/dist/esm/models/external-document-inputs-dto.js +1 -1
  172. package/dist/esm/models/file-uploaded-response-dto.d.ts +1 -1
  173. package/dist/esm/models/file-uploaded-response-dto.js +1 -1
  174. package/dist/esm/models/file-uploaded-v1-response-dto.d.ts +1 -1
  175. package/dist/esm/models/file-uploaded-v1-response-dto.js +1 -1
  176. package/dist/esm/models/generated-external-contract-document-dto.d.ts +1 -1
  177. package/dist/esm/models/generated-external-contract-document-dto.js +1 -1
  178. package/dist/esm/models/health-response-dto.d.ts +1 -1
  179. package/dist/esm/models/health-response-dto.js +1 -1
  180. package/dist/esm/models/hierarchical-region-dto.d.ts +1 -1
  181. package/dist/esm/models/hierarchical-region-dto.js +1 -1
  182. package/dist/esm/models/hierarchical-region-v1-dto.d.ts +1 -1
  183. package/dist/esm/models/hierarchical-region-v1-dto.js +1 -1
  184. package/dist/esm/models/index.d.ts +2 -0
  185. package/dist/esm/models/index.js +2 -0
  186. package/dist/esm/models/invalid-param-dto.d.ts +1 -1
  187. package/dist/esm/models/invalid-param-dto.js +1 -1
  188. package/dist/esm/models/invoice-completed-response-dto.d.ts +1 -1
  189. package/dist/esm/models/invoice-completed-response-dto.js +1 -1
  190. package/dist/esm/models/issue-tax-invoice-request-dto.d.ts +1 -1
  191. package/dist/esm/models/issue-tax-invoice-request-dto.js +1 -1
  192. package/dist/esm/models/list-bids-response-dto.d.ts +1 -1
  193. package/dist/esm/models/list-bids-response-dto.js +1 -1
  194. package/dist/esm/models/mark-bid-failed-request-dto.d.ts +1 -1
  195. package/dist/esm/models/mark-bid-failed-request-dto.js +1 -1
  196. package/dist/esm/models/mark-bid-failed-v1-request-dto.d.ts +1 -1
  197. package/dist/esm/models/mark-bid-failed-v1-request-dto.js +1 -1
  198. package/dist/esm/models/negotiation-score-dto.d.ts +1 -1
  199. package/dist/esm/models/negotiation-score-dto.js +1 -1
  200. package/dist/esm/models/negotiation-score-v1-dto.d.ts +1 -1
  201. package/dist/esm/models/negotiation-score-v1-dto.js +1 -1
  202. package/dist/esm/models/negotiation-scored-response-dto.d.ts +1 -1
  203. package/dist/esm/models/negotiation-scored-response-dto.js +1 -1
  204. package/dist/esm/models/negotiation-scored-v2-response-dto.d.ts +1 -1
  205. package/dist/esm/models/negotiation-scored-v2-response-dto.js +1 -1
  206. package/dist/esm/models/oauth-error-response-dto.d.ts +1 -1
  207. package/dist/esm/models/oauth-error-response-dto.js +1 -1
  208. package/dist/esm/models/preconditions-dto.d.ts +1 -1
  209. package/dist/esm/models/preconditions-dto.js +1 -1
  210. package/dist/esm/models/preconditions-v1-dto.d.ts +1 -1
  211. package/dist/esm/models/preconditions-v1-dto.js +1 -1
  212. package/dist/esm/models/problem-details-dto.d.ts +1 -1
  213. package/dist/esm/models/problem-details-dto.js +1 -1
  214. package/dist/esm/models/product-receipt-v1-response-dto.d.ts +1 -1
  215. package/dist/esm/models/product-receipt-v1-response-dto.js +1 -1
  216. package/dist/esm/models/product-v1-response-dto.d.ts +1 -1
  217. package/dist/esm/models/product-v1-response-dto.js +1 -1
  218. package/dist/esm/models/protected-resource-metadata-dto.d.ts +41 -0
  219. package/dist/esm/models/protected-resource-metadata-dto.js +14 -0
  220. package/dist/esm/models/register-award-request-dto.d.ts +1 -1
  221. package/dist/esm/models/register-award-request-dto.js +1 -1
  222. package/dist/esm/models/register-award-v1-request-dto.d.ts +1 -1
  223. package/dist/esm/models/register-award-v1-request-dto.js +1 -1
  224. package/dist/esm/models/register-semo-contract-request-dto.d.ts +1 -1
  225. package/dist/esm/models/register-semo-contract-request-dto.js +1 -1
  226. package/dist/esm/models/request-split-invoice-v1-request-dto.d.ts +1 -1
  227. package/dist/esm/models/request-split-invoice-v1-request-dto.js +1 -1
  228. package/dist/esm/models/retiree-roster-input-dto.d.ts +1 -1
  229. package/dist/esm/models/retiree-roster-input-dto.js +1 -1
  230. package/dist/esm/models/retiree-roster-row-dto.d.ts +1 -1
  231. package/dist/esm/models/retiree-roster-row-dto.js +1 -1
  232. package/dist/esm/models/semo-contract-registered-response-dto.d.ts +1 -1
  233. package/dist/esm/models/semo-contract-registered-response-dto.js +1 -1
  234. package/dist/esm/models/semo-contract-taxinvoice-status-response-dto.d.ts +1 -1
  235. package/dist/esm/models/semo-contract-taxinvoice-status-response-dto.js +1 -1
  236. package/dist/esm/models/split-invoice-v1-response-dto.d.ts +1 -1
  237. package/dist/esm/models/split-invoice-v1-response-dto.js +1 -1
  238. package/dist/esm/models/statement-document-dto.d.ts +1 -1
  239. package/dist/esm/models/statement-document-dto.js +1 -1
  240. package/dist/esm/models/statement-product-dto.d.ts +1 -1
  241. package/dist/esm/models/statement-product-dto.js +1 -1
  242. package/dist/esm/models/statement-v1-document-dto.d.ts +1 -1
  243. package/dist/esm/models/statement-v1-document-dto.js +1 -1
  244. package/dist/esm/models/statement-v1-product-dto.d.ts +1 -1
  245. package/dist/esm/models/statement-v1-product-dto.js +1 -1
  246. package/dist/esm/models/submit-negotiation-scores-request-dto.d.ts +1 -1
  247. package/dist/esm/models/submit-negotiation-scores-request-dto.js +1 -1
  248. package/dist/esm/models/submit-negotiation-scores-v1-request-dto.d.ts +1 -1
  249. package/dist/esm/models/submit-negotiation-scores-v1-request-dto.js +1 -1
  250. package/dist/esm/models/supplier-card-payable-response-dto.d.ts +1 -1
  251. package/dist/esm/models/supplier-card-payable-response-dto.js +1 -1
  252. package/dist/esm/models/supplier-tax-type.d.ts +1 -1
  253. package/dist/esm/models/supplier-tax-type.js +1 -1
  254. package/dist/esm/models/tax-invoice-issued-response-dto.d.ts +1 -1
  255. package/dist/esm/models/tax-invoice-issued-response-dto.js +1 -1
  256. package/dist/esm/models/token-request-dto.d.ts +1 -1
  257. package/dist/esm/models/token-request-dto.js +1 -1
  258. package/dist/esm/models/token-response-dto.d.ts +1 -1
  259. package/dist/esm/models/token-response-dto.js +1 -1
  260. package/dist/esm/models/update-bid-request-dto.d.ts +1 -1
  261. package/dist/esm/models/update-bid-request-dto.js +1 -1
  262. package/dist/esm/models/upload-file-request-dto.d.ts +1 -1
  263. package/dist/esm/models/upload-file-request-dto.js +1 -1
  264. package/dist/esm/models/upload-file-v1-request-dto.d.ts +1 -1
  265. package/dist/esm/models/upload-file-v1-request-dto.js +1 -1
  266. package/dist/index.d.ts +1 -1
  267. package/dist/index.js +1 -1
  268. package/dist/models/acceptance-result-response-dto.d.ts +1 -1
  269. package/dist/models/acceptance-result-response-dto.js +1 -1
  270. package/dist/models/acceptance-result-v1-response-dto.d.ts +1 -1
  271. package/dist/models/acceptance-result-v1-response-dto.js +1 -1
  272. package/dist/models/acknowledge-products-v1-request-dto.d.ts +1 -1
  273. package/dist/models/acknowledge-products-v1-request-dto.js +1 -1
  274. package/dist/models/authorization-server-metadata-dto.d.ts +45 -0
  275. package/dist/models/authorization-server-metadata-dto.js +15 -0
  276. package/dist/models/award-method-public.d.ts +1 -1
  277. package/dist/models/award-method-public.js +1 -1
  278. package/dist/models/award-registered-response-dto.d.ts +1 -1
  279. package/dist/models/award-registered-response-dto.js +1 -1
  280. package/dist/models/award-registered-v2-response-dto.d.ts +1 -1
  281. package/dist/models/award-registered-v2-response-dto.js +1 -1
  282. package/dist/models/bid-attachment-v1-dto.d.ts +1 -1
  283. package/dist/models/bid-attachment-v1-dto.js +1 -1
  284. package/dist/models/bid-bond-dto.d.ts +1 -1
  285. package/dist/models/bid-bond-dto.js +1 -1
  286. package/dist/models/bid-bond-v1-dto.d.ts +1 -1
  287. package/dist/models/bid-bond-v1-dto.js +1 -1
  288. package/dist/models/bid-contract-documents-batch-v1-request-dto.d.ts +1 -1
  289. package/dist/models/bid-contract-documents-batch-v1-request-dto.js +1 -1
  290. package/dist/models/bid-contract-documents-v1-response-dto.d.ts +1 -1
  291. package/dist/models/bid-contract-documents-v1-response-dto.js +1 -1
  292. package/dist/models/bid-created-response-dto.d.ts +1 -1
  293. package/dist/models/bid-created-response-dto.js +1 -1
  294. package/dist/models/bid-detail-response-dto.d.ts +1 -1
  295. package/dist/models/bid-detail-response-dto.js +1 -1
  296. package/dist/models/bid-document-dto.d.ts +1 -1
  297. package/dist/models/bid-document-dto.js +1 -1
  298. package/dist/models/bid-document-v1-dto.d.ts +1 -1
  299. package/dist/models/bid-document-v1-dto.js +1 -1
  300. package/dist/models/bid-failed-response-dto.d.ts +1 -1
  301. package/dist/models/bid-failed-response-dto.js +1 -1
  302. package/dist/models/bid-failed-v2-response-dto.d.ts +1 -1
  303. package/dist/models/bid-failed-v2-response-dto.js +1 -1
  304. package/dist/models/bid-failure-reason.d.ts +1 -1
  305. package/dist/models/bid-failure-reason.js +1 -1
  306. package/dist/models/bid-item-dto.d.ts +1 -1
  307. package/dist/models/bid-item-dto.js +1 -1
  308. package/dist/models/bid-item-v1-dto.d.ts +1 -1
  309. package/dist/models/bid-item-v1-dto.js +1 -1
  310. package/dist/models/bid-lifecycle-dto.d.ts +1 -1
  311. package/dist/models/bid-lifecycle-dto.js +1 -1
  312. package/dist/models/bid-manager-dto.d.ts +1 -1
  313. package/dist/models/bid-manager-dto.js +1 -1
  314. package/dist/models/bid-manager-v1-dto.d.ts +1 -1
  315. package/dist/models/bid-manager-v1-dto.js +1 -1
  316. package/dist/models/bid-participant-summary-dto.d.ts +1 -1
  317. package/dist/models/bid-participant-summary-dto.js +1 -1
  318. package/dist/models/bid-public-status.d.ts +1 -1
  319. package/dist/models/bid-public-status.js +1 -1
  320. package/dist/models/bid-published-response-dto.d.ts +1 -1
  321. package/dist/models/bid-published-response-dto.js +1 -1
  322. package/dist/models/bid-registered-response-dto.d.ts +1 -1
  323. package/dist/models/bid-registered-response-dto.js +1 -1
  324. package/dist/models/bid-result-participant-attachment-dto.d.ts +1 -1
  325. package/dist/models/bid-result-participant-attachment-dto.js +1 -1
  326. package/dist/models/bid-result-participant-dto.d.ts +1 -1
  327. package/dist/models/bid-result-participant-dto.js +1 -1
  328. package/dist/models/bid-result-v1-attachment-dto.d.ts +1 -1
  329. package/dist/models/bid-result-v1-attachment-dto.js +1 -1
  330. package/dist/models/bid-result-v1-bid-product-info-dto.d.ts +1 -1
  331. package/dist/models/bid-result-v1-bid-product-info-dto.js +1 -1
  332. package/dist/models/bid-result-v1-participant-dto.d.ts +1 -1
  333. package/dist/models/bid-result-v1-participant-dto.js +1 -1
  334. package/dist/models/bid-result-v1-product-dto.d.ts +1 -1
  335. package/dist/models/bid-result-v1-product-dto.js +1 -1
  336. package/dist/models/bid-results-batch-v1-request-dto.d.ts +1 -1
  337. package/dist/models/bid-results-batch-v1-request-dto.js +1 -1
  338. package/dist/models/bid-results-response-dto.d.ts +1 -1
  339. package/dist/models/bid-results-response-dto.js +1 -1
  340. package/dist/models/bid-results-v1-response-dto.d.ts +1 -1
  341. package/dist/models/bid-results-v1-response-dto.js +1 -1
  342. package/dist/models/bid-settlement-line-item-dto.d.ts +1 -1
  343. package/dist/models/bid-settlement-line-item-dto.js +1 -1
  344. package/dist/models/bid-settlement-participant-dto.d.ts +1 -1
  345. package/dist/models/bid-settlement-participant-dto.js +1 -1
  346. package/dist/models/bid-settlement-response-dto.d.ts +1 -1
  347. package/dist/models/bid-settlement-response-dto.js +1 -1
  348. package/dist/models/bid-statement-response-dto.d.ts +1 -1
  349. package/dist/models/bid-statement-response-dto.js +1 -1
  350. package/dist/models/bid-statement-v1-response-dto.d.ts +1 -1
  351. package/dist/models/bid-statement-v1-response-dto.js +1 -1
  352. package/dist/models/bid-status.d.ts +1 -1
  353. package/dist/models/bid-status.js +1 -1
  354. package/dist/models/bid-summary-dto.d.ts +1 -1
  355. package/dist/models/bid-summary-dto.js +1 -1
  356. package/dist/models/bid-updated-response-dto.d.ts +1 -1
  357. package/dist/models/bid-updated-response-dto.js +1 -1
  358. package/dist/models/card-payment-request-response-dto.d.ts +1 -1
  359. package/dist/models/card-payment-request-response-dto.js +1 -1
  360. package/dist/models/close-sandbox-bid-response-dto.d.ts +1 -1
  361. package/dist/models/close-sandbox-bid-response-dto.js +1 -1
  362. package/dist/models/complete-acceptance-request-dto.d.ts +1 -1
  363. package/dist/models/complete-acceptance-request-dto.js +1 -1
  364. package/dist/models/complete-acceptance-v1-request-dto.d.ts +1 -1
  365. package/dist/models/complete-acceptance-v1-request-dto.js +1 -1
  366. package/dist/models/contract-document-item-dto.d.ts +1 -1
  367. package/dist/models/contract-document-item-dto.js +1 -1
  368. package/dist/models/contract-documents-regenerated-response-dto.d.ts +1 -1
  369. package/dist/models/contract-documents-regenerated-response-dto.js +1 -1
  370. package/dist/models/contract-restriction-confirm-input-dto.d.ts +1 -1
  371. package/dist/models/contract-restriction-confirm-input-dto.js +1 -1
  372. package/dist/models/create-bid-request-dto.d.ts +1 -1
  373. package/dist/models/create-bid-request-dto.js +1 -1
  374. package/dist/models/create-bid-v1-request-dto.d.ts +1 -1
  375. package/dist/models/create-bid-v1-request-dto.js +1 -1
  376. package/dist/models/create-card-payment-request-dto.d.ts +1 -1
  377. package/dist/models/create-card-payment-request-dto.js +1 -1
  378. package/dist/models/create-external-contract-documents-request-dto.d.ts +1 -1
  379. package/dist/models/create-external-contract-documents-request-dto.js +1 -1
  380. package/dist/models/create-external-contract-documents-response-dto.d.ts +1 -1
  381. package/dist/models/create-external-contract-documents-response-dto.js +1 -1
  382. package/dist/models/embed-launch-request-dto.d.ts +1 -1
  383. package/dist/models/embed-launch-request-dto.js +1 -1
  384. package/dist/models/embed-launch-response-dto.d.ts +1 -1
  385. package/dist/models/embed-launch-response-dto.js +1 -1
  386. package/dist/models/external-contract-document-item-dto.d.ts +1 -1
  387. package/dist/models/external-contract-document-item-dto.js +1 -1
  388. package/dist/models/external-contract-documents-response-dto.d.ts +1 -1
  389. package/dist/models/external-contract-documents-response-dto.js +1 -1
  390. package/dist/models/external-contract-item-dto.d.ts +1 -1
  391. package/dist/models/external-contract-item-dto.js +1 -1
  392. package/dist/models/external-contract-snapshot-dto.d.ts +1 -1
  393. package/dist/models/external-contract-snapshot-dto.js +1 -1
  394. package/dist/models/external-document-inputs-dto.d.ts +1 -1
  395. package/dist/models/external-document-inputs-dto.js +1 -1
  396. package/dist/models/file-uploaded-response-dto.d.ts +1 -1
  397. package/dist/models/file-uploaded-response-dto.js +1 -1
  398. package/dist/models/file-uploaded-v1-response-dto.d.ts +1 -1
  399. package/dist/models/file-uploaded-v1-response-dto.js +1 -1
  400. package/dist/models/generated-external-contract-document-dto.d.ts +1 -1
  401. package/dist/models/generated-external-contract-document-dto.js +1 -1
  402. package/dist/models/health-response-dto.d.ts +1 -1
  403. package/dist/models/health-response-dto.js +1 -1
  404. package/dist/models/hierarchical-region-dto.d.ts +1 -1
  405. package/dist/models/hierarchical-region-dto.js +1 -1
  406. package/dist/models/hierarchical-region-v1-dto.d.ts +1 -1
  407. package/dist/models/hierarchical-region-v1-dto.js +1 -1
  408. package/dist/models/index.d.ts +2 -0
  409. package/dist/models/index.js +2 -0
  410. package/dist/models/invalid-param-dto.d.ts +1 -1
  411. package/dist/models/invalid-param-dto.js +1 -1
  412. package/dist/models/invoice-completed-response-dto.d.ts +1 -1
  413. package/dist/models/invoice-completed-response-dto.js +1 -1
  414. package/dist/models/issue-tax-invoice-request-dto.d.ts +1 -1
  415. package/dist/models/issue-tax-invoice-request-dto.js +1 -1
  416. package/dist/models/list-bids-response-dto.d.ts +1 -1
  417. package/dist/models/list-bids-response-dto.js +1 -1
  418. package/dist/models/mark-bid-failed-request-dto.d.ts +1 -1
  419. package/dist/models/mark-bid-failed-request-dto.js +1 -1
  420. package/dist/models/mark-bid-failed-v1-request-dto.d.ts +1 -1
  421. package/dist/models/mark-bid-failed-v1-request-dto.js +1 -1
  422. package/dist/models/negotiation-score-dto.d.ts +1 -1
  423. package/dist/models/negotiation-score-dto.js +1 -1
  424. package/dist/models/negotiation-score-v1-dto.d.ts +1 -1
  425. package/dist/models/negotiation-score-v1-dto.js +1 -1
  426. package/dist/models/negotiation-scored-response-dto.d.ts +1 -1
  427. package/dist/models/negotiation-scored-response-dto.js +1 -1
  428. package/dist/models/negotiation-scored-v2-response-dto.d.ts +1 -1
  429. package/dist/models/negotiation-scored-v2-response-dto.js +1 -1
  430. package/dist/models/oauth-error-response-dto.d.ts +1 -1
  431. package/dist/models/oauth-error-response-dto.js +1 -1
  432. package/dist/models/preconditions-dto.d.ts +1 -1
  433. package/dist/models/preconditions-dto.js +1 -1
  434. package/dist/models/preconditions-v1-dto.d.ts +1 -1
  435. package/dist/models/preconditions-v1-dto.js +1 -1
  436. package/dist/models/problem-details-dto.d.ts +1 -1
  437. package/dist/models/problem-details-dto.js +1 -1
  438. package/dist/models/product-receipt-v1-response-dto.d.ts +1 -1
  439. package/dist/models/product-receipt-v1-response-dto.js +1 -1
  440. package/dist/models/product-v1-response-dto.d.ts +1 -1
  441. package/dist/models/product-v1-response-dto.js +1 -1
  442. package/dist/models/protected-resource-metadata-dto.d.ts +41 -0
  443. package/dist/models/protected-resource-metadata-dto.js +15 -0
  444. package/dist/models/register-award-request-dto.d.ts +1 -1
  445. package/dist/models/register-award-request-dto.js +1 -1
  446. package/dist/models/register-award-v1-request-dto.d.ts +1 -1
  447. package/dist/models/register-award-v1-request-dto.js +1 -1
  448. package/dist/models/register-semo-contract-request-dto.d.ts +1 -1
  449. package/dist/models/register-semo-contract-request-dto.js +1 -1
  450. package/dist/models/request-split-invoice-v1-request-dto.d.ts +1 -1
  451. package/dist/models/request-split-invoice-v1-request-dto.js +1 -1
  452. package/dist/models/retiree-roster-input-dto.d.ts +1 -1
  453. package/dist/models/retiree-roster-input-dto.js +1 -1
  454. package/dist/models/retiree-roster-row-dto.d.ts +1 -1
  455. package/dist/models/retiree-roster-row-dto.js +1 -1
  456. package/dist/models/semo-contract-registered-response-dto.d.ts +1 -1
  457. package/dist/models/semo-contract-registered-response-dto.js +1 -1
  458. package/dist/models/semo-contract-taxinvoice-status-response-dto.d.ts +1 -1
  459. package/dist/models/semo-contract-taxinvoice-status-response-dto.js +1 -1
  460. package/dist/models/split-invoice-v1-response-dto.d.ts +1 -1
  461. package/dist/models/split-invoice-v1-response-dto.js +1 -1
  462. package/dist/models/statement-document-dto.d.ts +1 -1
  463. package/dist/models/statement-document-dto.js +1 -1
  464. package/dist/models/statement-product-dto.d.ts +1 -1
  465. package/dist/models/statement-product-dto.js +1 -1
  466. package/dist/models/statement-v1-document-dto.d.ts +1 -1
  467. package/dist/models/statement-v1-document-dto.js +1 -1
  468. package/dist/models/statement-v1-product-dto.d.ts +1 -1
  469. package/dist/models/statement-v1-product-dto.js +1 -1
  470. package/dist/models/submit-negotiation-scores-request-dto.d.ts +1 -1
  471. package/dist/models/submit-negotiation-scores-request-dto.js +1 -1
  472. package/dist/models/submit-negotiation-scores-v1-request-dto.d.ts +1 -1
  473. package/dist/models/submit-negotiation-scores-v1-request-dto.js +1 -1
  474. package/dist/models/supplier-card-payable-response-dto.d.ts +1 -1
  475. package/dist/models/supplier-card-payable-response-dto.js +1 -1
  476. package/dist/models/supplier-tax-type.d.ts +1 -1
  477. package/dist/models/supplier-tax-type.js +1 -1
  478. package/dist/models/tax-invoice-issued-response-dto.d.ts +1 -1
  479. package/dist/models/tax-invoice-issued-response-dto.js +1 -1
  480. package/dist/models/token-request-dto.d.ts +1 -1
  481. package/dist/models/token-request-dto.js +1 -1
  482. package/dist/models/token-response-dto.d.ts +1 -1
  483. package/dist/models/token-response-dto.js +1 -1
  484. package/dist/models/update-bid-request-dto.d.ts +1 -1
  485. package/dist/models/update-bid-request-dto.js +1 -1
  486. package/dist/models/upload-file-request-dto.d.ts +1 -1
  487. package/dist/models/upload-file-request-dto.js +1 -1
  488. package/dist/models/upload-file-v1-request-dto.d.ts +1 -1
  489. package/dist/models/upload-file-v1-request-dto.js +1 -1
  490. package/docs/AuthorizationServerMetadataDto.md +34 -0
  491. package/docs/ProtectedResourceMetadataDto.md +32 -0
  492. package/docs/WellKnownApi.md +97 -0
  493. package/index.ts +1 -1
  494. package/models/acceptance-result-response-dto.ts +1 -1
  495. package/models/acceptance-result-v1-response-dto.ts +1 -1
  496. package/models/acknowledge-products-v1-request-dto.ts +1 -1
  497. package/models/authorization-server-metadata-dto.ts +51 -0
  498. package/models/award-method-public.ts +1 -1
  499. package/models/award-registered-response-dto.ts +1 -1
  500. package/models/award-registered-v2-response-dto.ts +1 -1
  501. package/models/bid-attachment-v1-dto.ts +1 -1
  502. package/models/bid-bond-dto.ts +1 -1
  503. package/models/bid-bond-v1-dto.ts +1 -1
  504. package/models/bid-contract-documents-batch-v1-request-dto.ts +1 -1
  505. package/models/bid-contract-documents-v1-response-dto.ts +1 -1
  506. package/models/bid-created-response-dto.ts +1 -1
  507. package/models/bid-detail-response-dto.ts +1 -1
  508. package/models/bid-document-dto.ts +1 -1
  509. package/models/bid-document-v1-dto.ts +1 -1
  510. package/models/bid-failed-response-dto.ts +1 -1
  511. package/models/bid-failed-v2-response-dto.ts +1 -1
  512. package/models/bid-failure-reason.ts +1 -1
  513. package/models/bid-item-dto.ts +1 -1
  514. package/models/bid-item-v1-dto.ts +1 -1
  515. package/models/bid-lifecycle-dto.ts +1 -1
  516. package/models/bid-manager-dto.ts +1 -1
  517. package/models/bid-manager-v1-dto.ts +1 -1
  518. package/models/bid-participant-summary-dto.ts +1 -1
  519. package/models/bid-public-status.ts +1 -1
  520. package/models/bid-published-response-dto.ts +1 -1
  521. package/models/bid-registered-response-dto.ts +1 -1
  522. package/models/bid-result-participant-attachment-dto.ts +1 -1
  523. package/models/bid-result-participant-dto.ts +1 -1
  524. package/models/bid-result-v1-attachment-dto.ts +1 -1
  525. package/models/bid-result-v1-bid-product-info-dto.ts +1 -1
  526. package/models/bid-result-v1-participant-dto.ts +1 -1
  527. package/models/bid-result-v1-product-dto.ts +1 -1
  528. package/models/bid-results-batch-v1-request-dto.ts +1 -1
  529. package/models/bid-results-response-dto.ts +1 -1
  530. package/models/bid-results-v1-response-dto.ts +1 -1
  531. package/models/bid-settlement-line-item-dto.ts +1 -1
  532. package/models/bid-settlement-participant-dto.ts +1 -1
  533. package/models/bid-settlement-response-dto.ts +1 -1
  534. package/models/bid-statement-response-dto.ts +1 -1
  535. package/models/bid-statement-v1-response-dto.ts +1 -1
  536. package/models/bid-status.ts +1 -1
  537. package/models/bid-summary-dto.ts +1 -1
  538. package/models/bid-updated-response-dto.ts +1 -1
  539. package/models/card-payment-request-response-dto.ts +1 -1
  540. package/models/close-sandbox-bid-response-dto.ts +1 -1
  541. package/models/complete-acceptance-request-dto.ts +1 -1
  542. package/models/complete-acceptance-v1-request-dto.ts +1 -1
  543. package/models/contract-document-item-dto.ts +1 -1
  544. package/models/contract-documents-regenerated-response-dto.ts +1 -1
  545. package/models/contract-restriction-confirm-input-dto.ts +1 -1
  546. package/models/create-bid-request-dto.ts +1 -1
  547. package/models/create-bid-v1-request-dto.ts +1 -1
  548. package/models/create-card-payment-request-dto.ts +1 -1
  549. package/models/create-external-contract-documents-request-dto.ts +1 -1
  550. package/models/create-external-contract-documents-response-dto.ts +1 -1
  551. package/models/embed-launch-request-dto.ts +1 -1
  552. package/models/embed-launch-response-dto.ts +1 -1
  553. package/models/external-contract-document-item-dto.ts +1 -1
  554. package/models/external-contract-documents-response-dto.ts +1 -1
  555. package/models/external-contract-item-dto.ts +1 -1
  556. package/models/external-contract-snapshot-dto.ts +1 -1
  557. package/models/external-document-inputs-dto.ts +1 -1
  558. package/models/file-uploaded-response-dto.ts +1 -1
  559. package/models/file-uploaded-v1-response-dto.ts +1 -1
  560. package/models/generated-external-contract-document-dto.ts +1 -1
  561. package/models/health-response-dto.ts +1 -1
  562. package/models/hierarchical-region-dto.ts +1 -1
  563. package/models/hierarchical-region-v1-dto.ts +1 -1
  564. package/models/index.ts +2 -0
  565. package/models/invalid-param-dto.ts +1 -1
  566. package/models/invoice-completed-response-dto.ts +1 -1
  567. package/models/issue-tax-invoice-request-dto.ts +1 -1
  568. package/models/list-bids-response-dto.ts +1 -1
  569. package/models/mark-bid-failed-request-dto.ts +1 -1
  570. package/models/mark-bid-failed-v1-request-dto.ts +1 -1
  571. package/models/negotiation-score-dto.ts +1 -1
  572. package/models/negotiation-score-v1-dto.ts +1 -1
  573. package/models/negotiation-scored-response-dto.ts +1 -1
  574. package/models/negotiation-scored-v2-response-dto.ts +1 -1
  575. package/models/oauth-error-response-dto.ts +1 -1
  576. package/models/preconditions-dto.ts +1 -1
  577. package/models/preconditions-v1-dto.ts +1 -1
  578. package/models/problem-details-dto.ts +1 -1
  579. package/models/product-receipt-v1-response-dto.ts +1 -1
  580. package/models/product-v1-response-dto.ts +1 -1
  581. package/models/protected-resource-metadata-dto.ts +47 -0
  582. package/models/register-award-request-dto.ts +1 -1
  583. package/models/register-award-v1-request-dto.ts +1 -1
  584. package/models/register-semo-contract-request-dto.ts +1 -1
  585. package/models/request-split-invoice-v1-request-dto.ts +1 -1
  586. package/models/retiree-roster-input-dto.ts +1 -1
  587. package/models/retiree-roster-row-dto.ts +1 -1
  588. package/models/semo-contract-registered-response-dto.ts +1 -1
  589. package/models/semo-contract-taxinvoice-status-response-dto.ts +1 -1
  590. package/models/split-invoice-v1-response-dto.ts +1 -1
  591. package/models/statement-document-dto.ts +1 -1
  592. package/models/statement-product-dto.ts +1 -1
  593. package/models/statement-v1-document-dto.ts +1 -1
  594. package/models/statement-v1-product-dto.ts +1 -1
  595. package/models/submit-negotiation-scores-request-dto.ts +1 -1
  596. package/models/submit-negotiation-scores-v1-request-dto.ts +1 -1
  597. package/models/supplier-card-payable-response-dto.ts +1 -1
  598. package/models/supplier-tax-type.ts +1 -1
  599. package/models/tax-invoice-issued-response-dto.ts +1 -1
  600. package/models/token-request-dto.ts +1 -1
  601. package/models/token-response-dto.ts +1 -1
  602. package/models/update-bid-request-dto.ts +1 -1
  603. package/models/upload-file-request-dto.ts +1 -1
  604. package/models/upload-file-v1-request-dto.ts +1 -1
  605. package/package.json +1 -1
@@ -0,0 +1,181 @@
1
+ "use strict";
2
+ /* tslint:disable */
3
+ /* eslint-disable */
4
+ /**
5
+ * CMARKET V6 Partner API
6
+ * μ™ΈλΆ€ ERP μ—°λ™μš© RESTful API. ## 버전별 인증 - **_/v2** β€” OAuth2 Bearer JWT (`client_credentials` ν”Œλ‘œμš°). `/oauth/token` μ—μ„œ 토큰 λ°œκΈ‰ ν›„ `Authorization: Bearer <token>` 헀더. - **_/v1** β€” V5 μΆ©μ‹€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν—€λ”λ‘œ 전솑. ## κΆŒν•œ β€” 두 개의 λ…λ¦½λœ μΆ• `403` 을 λ§Œλ‚¬λ‹€λ©΄ λ‘˜ 쀑 μ–΄λŠ 좕에 κ±Έλ¦° 것인지 λ¨Όμ € ꡬ뢄할 것. - **μŠ€μ½”ν”„** = *무엇을 ν•  수 μžˆλ‚˜*. 토큰에 λΆ€μ—¬λœ `bids:read`Β·`contracts:write` λ“±. 미보유 μ‹œ `…/insufficient-scope`. - **λŒ€ν–‰ λ²”μœ„** = *λˆ„κ΅¬μ˜ 데이터λ₯Ό λ‹€λ£° 수 μžˆλ‚˜*. API ν‚€ 섀정이며 μŠ€μ½”ν”„λ‘œ ν‘œν˜„λ˜μ§€ μ•ŠλŠ”λ‹€. λ²”μœ„ 밖이면 μŠ€μ½”ν”„μ™€ λ¬΄κ΄€ν•˜κ²Œ 403 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
7
+ *
8
+ * The version of the OpenAPI document: 22.7.0
9
+ * Contact: semo.io.kr@gmail.com
10
+ *
11
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
12
+ * https://openapi-generator.tech
13
+ * Do not edit the class manually.
14
+ */
15
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
16
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
17
+ return new (P || (P = Promise))(function (resolve, reject) {
18
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
19
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
20
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
21
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
22
+ });
23
+ };
24
+ Object.defineProperty(exports, "__esModule", { value: true });
25
+ exports.WellKnownApi = exports.WellKnownApiFactory = exports.WellKnownApiFp = exports.WellKnownApiAxiosParamCreator = void 0;
26
+ const axios_1 = require("axios");
27
+ // Some imports not used depending on template conditions
28
+ // @ts-ignore
29
+ const common_1 = require("../common");
30
+ // @ts-ignore
31
+ const base_1 = require("../base");
32
+ /**
33
+ * WellKnownApi - axios parameter creator
34
+ */
35
+ const WellKnownApiAxiosParamCreator = function (configuration) {
36
+ return {
37
+ /**
38
+ * 이 배포의 token endpoint·지원 grant/scope/μ•Œκ³ λ¦¬μ¦˜μ„ 기계가 μ½λŠ” ν˜•μ‹μœΌλ‘œ κ³΅κ°œν•©λ‹ˆλ‹€. 인증이 ν•„μš” μ—†μŠ΅λ‹ˆλ‹€.
39
+ * @summary OAuth 2.0 μΈκ°€μ„œλ²„ 메타데이터 (Authorization Server Metadata, RFC 8414)
40
+ * @param {*} [options] Override http request option.
41
+ * @throws {RequiredError}
42
+ */
43
+ authorizationServerMetadata: (...args_1) => __awaiter(this, [...args_1], void 0, function* (options = {}) {
44
+ const localVarPath = `/.well-known/oauth-authorization-server`;
45
+ // use dummy base URL string because the URL constructor only accepts absolute URLs.
46
+ const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
47
+ let baseOptions;
48
+ if (configuration) {
49
+ baseOptions = configuration.baseOptions;
50
+ }
51
+ const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
52
+ const localVarHeaderParameter = {};
53
+ const localVarQueryParameter = {};
54
+ localVarHeaderParameter['Accept'] = 'application/json';
55
+ (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
56
+ let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
57
+ localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
58
+ return {
59
+ url: (0, common_1.toPathString)(localVarUrlObj),
60
+ options: localVarRequestOptions,
61
+ };
62
+ }),
63
+ /**
64
+ * 이 API λ₯Ό λ³΄ν˜Έν•˜λŠ” authorization server 와 지원 scope λ₯Ό κ³΅κ°œν•©λ‹ˆλ‹€. 401 μ‘λ‹΅μ˜ WWW-Authenticate 헀더가 이 λ¬Έμ„œλ₯Ό κ°€λ¦¬ν‚΅λ‹ˆλ‹€. 인증이 ν•„μš” μ—†μŠ΅λ‹ˆλ‹€.
65
+ * @summary OAuth 2.0 λ³΄ν˜Έμžμ› 메타데이터 (Protected Resource Metadata, RFC 9728)
66
+ * @param {*} [options] Override http request option.
67
+ * @throws {RequiredError}
68
+ */
69
+ protectedResourceMetadata: (...args_1) => __awaiter(this, [...args_1], void 0, function* (options = {}) {
70
+ const localVarPath = `/.well-known/oauth-protected-resource`;
71
+ // use dummy base URL string because the URL constructor only accepts absolute URLs.
72
+ const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
73
+ let baseOptions;
74
+ if (configuration) {
75
+ baseOptions = configuration.baseOptions;
76
+ }
77
+ const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
78
+ const localVarHeaderParameter = {};
79
+ const localVarQueryParameter = {};
80
+ localVarHeaderParameter['Accept'] = 'application/json';
81
+ (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
82
+ let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
83
+ localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
84
+ return {
85
+ url: (0, common_1.toPathString)(localVarUrlObj),
86
+ options: localVarRequestOptions,
87
+ };
88
+ }),
89
+ };
90
+ };
91
+ exports.WellKnownApiAxiosParamCreator = WellKnownApiAxiosParamCreator;
92
+ /**
93
+ * WellKnownApi - functional programming interface
94
+ */
95
+ const WellKnownApiFp = function (configuration) {
96
+ const localVarAxiosParamCreator = (0, exports.WellKnownApiAxiosParamCreator)(configuration);
97
+ return {
98
+ /**
99
+ * 이 배포의 token endpoint·지원 grant/scope/μ•Œκ³ λ¦¬μ¦˜μ„ 기계가 μ½λŠ” ν˜•μ‹μœΌλ‘œ κ³΅κ°œν•©λ‹ˆλ‹€. 인증이 ν•„μš” μ—†μŠ΅λ‹ˆλ‹€.
100
+ * @summary OAuth 2.0 μΈκ°€μ„œλ²„ 메타데이터 (Authorization Server Metadata, RFC 8414)
101
+ * @param {*} [options] Override http request option.
102
+ * @throws {RequiredError}
103
+ */
104
+ authorizationServerMetadata(options) {
105
+ return __awaiter(this, void 0, void 0, function* () {
106
+ var _a, _b, _c;
107
+ const localVarAxiosArgs = yield localVarAxiosParamCreator.authorizationServerMetadata(options);
108
+ const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
109
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['WellKnownApi.authorizationServerMetadata']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
110
+ return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
111
+ });
112
+ },
113
+ /**
114
+ * 이 API λ₯Ό λ³΄ν˜Έν•˜λŠ” authorization server 와 지원 scope λ₯Ό κ³΅κ°œν•©λ‹ˆλ‹€. 401 μ‘λ‹΅μ˜ WWW-Authenticate 헀더가 이 λ¬Έμ„œλ₯Ό κ°€λ¦¬ν‚΅λ‹ˆλ‹€. 인증이 ν•„μš” μ—†μŠ΅λ‹ˆλ‹€.
115
+ * @summary OAuth 2.0 λ³΄ν˜Έμžμ› 메타데이터 (Protected Resource Metadata, RFC 9728)
116
+ * @param {*} [options] Override http request option.
117
+ * @throws {RequiredError}
118
+ */
119
+ protectedResourceMetadata(options) {
120
+ return __awaiter(this, void 0, void 0, function* () {
121
+ var _a, _b, _c;
122
+ const localVarAxiosArgs = yield localVarAxiosParamCreator.protectedResourceMetadata(options);
123
+ const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
124
+ const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['WellKnownApi.protectedResourceMetadata']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
125
+ return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
126
+ });
127
+ },
128
+ };
129
+ };
130
+ exports.WellKnownApiFp = WellKnownApiFp;
131
+ /**
132
+ * WellKnownApi - factory interface
133
+ */
134
+ const WellKnownApiFactory = function (configuration, basePath, axios) {
135
+ const localVarFp = (0, exports.WellKnownApiFp)(configuration);
136
+ return {
137
+ /**
138
+ * 이 배포의 token endpoint·지원 grant/scope/μ•Œκ³ λ¦¬μ¦˜μ„ 기계가 μ½λŠ” ν˜•μ‹μœΌλ‘œ κ³΅κ°œν•©λ‹ˆλ‹€. 인증이 ν•„μš” μ—†μŠ΅λ‹ˆλ‹€.
139
+ * @summary OAuth 2.0 μΈκ°€μ„œλ²„ 메타데이터 (Authorization Server Metadata, RFC 8414)
140
+ * @param {*} [options] Override http request option.
141
+ * @throws {RequiredError}
142
+ */
143
+ authorizationServerMetadata(options) {
144
+ return localVarFp.authorizationServerMetadata(options).then((request) => request(axios, basePath));
145
+ },
146
+ /**
147
+ * 이 API λ₯Ό λ³΄ν˜Έν•˜λŠ” authorization server 와 지원 scope λ₯Ό κ³΅κ°œν•©λ‹ˆλ‹€. 401 μ‘λ‹΅μ˜ WWW-Authenticate 헀더가 이 λ¬Έμ„œλ₯Ό κ°€λ¦¬ν‚΅λ‹ˆλ‹€. 인증이 ν•„μš” μ—†μŠ΅λ‹ˆλ‹€.
148
+ * @summary OAuth 2.0 λ³΄ν˜Έμžμ› 메타데이터 (Protected Resource Metadata, RFC 9728)
149
+ * @param {*} [options] Override http request option.
150
+ * @throws {RequiredError}
151
+ */
152
+ protectedResourceMetadata(options) {
153
+ return localVarFp.protectedResourceMetadata(options).then((request) => request(axios, basePath));
154
+ },
155
+ };
156
+ };
157
+ exports.WellKnownApiFactory = WellKnownApiFactory;
158
+ /**
159
+ * WellKnownApi - object-oriented interface
160
+ */
161
+ class WellKnownApi extends base_1.BaseAPI {
162
+ /**
163
+ * 이 배포의 token endpoint·지원 grant/scope/μ•Œκ³ λ¦¬μ¦˜μ„ 기계가 μ½λŠ” ν˜•μ‹μœΌλ‘œ κ³΅κ°œν•©λ‹ˆλ‹€. 인증이 ν•„μš” μ—†μŠ΅λ‹ˆλ‹€.
164
+ * @summary OAuth 2.0 μΈκ°€μ„œλ²„ 메타데이터 (Authorization Server Metadata, RFC 8414)
165
+ * @param {*} [options] Override http request option.
166
+ * @throws {RequiredError}
167
+ */
168
+ authorizationServerMetadata(options) {
169
+ return (0, exports.WellKnownApiFp)(this.configuration).authorizationServerMetadata(options).then((request) => request(this.axios, this.basePath));
170
+ }
171
+ /**
172
+ * 이 API λ₯Ό λ³΄ν˜Έν•˜λŠ” authorization server 와 지원 scope λ₯Ό κ³΅κ°œν•©λ‹ˆλ‹€. 401 μ‘λ‹΅μ˜ WWW-Authenticate 헀더가 이 λ¬Έμ„œλ₯Ό κ°€λ¦¬ν‚΅λ‹ˆλ‹€. 인증이 ν•„μš” μ—†μŠ΅λ‹ˆλ‹€.
173
+ * @summary OAuth 2.0 λ³΄ν˜Έμžμ› 메타데이터 (Protected Resource Metadata, RFC 9728)
174
+ * @param {*} [options] Override http request option.
175
+ * @throws {RequiredError}
176
+ */
177
+ protectedResourceMetadata(options) {
178
+ return (0, exports.WellKnownApiFp)(this.configuration).protectedResourceMetadata(options).then((request) => request(this.axios, this.basePath));
179
+ }
180
+ }
181
+ exports.WellKnownApi = WellKnownApi;
package/dist/api.d.ts CHANGED
@@ -2,7 +2,7 @@
2
2
  * CMARKET V6 Partner API
3
3
  * μ™ΈλΆ€ ERP μ—°λ™μš© RESTful API. ## 버전별 인증 - **_/v2** β€” OAuth2 Bearer JWT (`client_credentials` ν”Œλ‘œμš°). `/oauth/token` μ—μ„œ 토큰 λ°œκΈ‰ ν›„ `Authorization: Bearer <token>` 헀더. - **_/v1** β€” V5 μΆ©μ‹€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν—€λ”λ‘œ 전솑. ## κΆŒν•œ β€” 두 개의 λ…λ¦½λœ μΆ• `403` 을 λ§Œλ‚¬λ‹€λ©΄ λ‘˜ 쀑 μ–΄λŠ 좕에 κ±Έλ¦° 것인지 λ¨Όμ € ꡬ뢄할 것. - **μŠ€μ½”ν”„** = *무엇을 ν•  수 μžˆλ‚˜*. 토큰에 λΆ€μ—¬λœ `bids:read`Β·`contracts:write` λ“±. 미보유 μ‹œ `…/insufficient-scope`. - **λŒ€ν–‰ λ²”μœ„** = *λˆ„κ΅¬μ˜ 데이터λ₯Ό λ‹€λ£° 수 μžˆλ‚˜*. API ν‚€ 섀정이며 μŠ€μ½”ν”„λ‘œ ν‘œν˜„λ˜μ§€ μ•ŠλŠ”λ‹€. λ²”μœ„ 밖이면 μŠ€μ½”ν”„μ™€ λ¬΄κ΄€ν•˜κ²Œ 403 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
4
4
  *
5
- * The version of the OpenAPI document: 22.6.0
5
+ * The version of the OpenAPI document: 22.7.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).
@@ -12,3 +12,4 @@
12
12
  export * from './api/oauth-api';
13
13
  export * from './api/partner-v1-api';
14
14
  export * from './api/partner-v2-api';
15
+ export * from './api/well-known-api';
package/dist/api.js CHANGED
@@ -5,7 +5,7 @@
5
5
  * CMARKET V6 Partner API
6
6
  * μ™ΈλΆ€ ERP μ—°λ™μš© RESTful API. ## 버전별 인증 - **_/v2** β€” OAuth2 Bearer JWT (`client_credentials` ν”Œλ‘œμš°). `/oauth/token` μ—μ„œ 토큰 λ°œκΈ‰ ν›„ `Authorization: Bearer <token>` 헀더. - **_/v1** β€” V5 μΆ©μ‹€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν—€λ”λ‘œ 전솑. ## κΆŒν•œ β€” 두 개의 λ…λ¦½λœ μΆ• `403` 을 λ§Œλ‚¬λ‹€λ©΄ λ‘˜ 쀑 μ–΄λŠ 좕에 κ±Έλ¦° 것인지 λ¨Όμ € ꡬ뢄할 것. - **μŠ€μ½”ν”„** = *무엇을 ν•  수 μžˆλ‚˜*. 토큰에 λΆ€μ—¬λœ `bids:read`Β·`contracts:write` λ“±. 미보유 μ‹œ `…/insufficient-scope`. - **λŒ€ν–‰ λ²”μœ„** = *λˆ„κ΅¬μ˜ 데이터λ₯Ό λ‹€λ£° 수 μžˆλ‚˜*. API ν‚€ 섀정이며 μŠ€μ½”ν”„λ‘œ ν‘œν˜„λ˜μ§€ μ•ŠλŠ”λ‹€. λ²”μœ„ 밖이면 μŠ€μ½”ν”„μ™€ λ¬΄κ΄€ν•˜κ²Œ 403 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
7
7
  *
8
- * The version of the OpenAPI document: 22.6.0
8
+ * The version of the OpenAPI document: 22.7.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).
@@ -30,3 +30,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
30
30
  __exportStar(require("./api/oauth-api"), exports);
31
31
  __exportStar(require("./api/partner-v1-api"), exports);
32
32
  __exportStar(require("./api/partner-v2-api"), exports);
33
+ __exportStar(require("./api/well-known-api"), exports);
package/dist/base.d.ts CHANGED
@@ -2,7 +2,7 @@
2
2
  * CMARKET V6 Partner API
3
3
  * μ™ΈλΆ€ ERP μ—°λ™μš© RESTful API. ## 버전별 인증 - **_/v2** β€” OAuth2 Bearer JWT (`client_credentials` ν”Œλ‘œμš°). `/oauth/token` μ—μ„œ 토큰 λ°œκΈ‰ ν›„ `Authorization: Bearer <token>` 헀더. - **_/v1** β€” V5 μΆ©μ‹€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν—€λ”λ‘œ 전솑. ## κΆŒν•œ β€” 두 개의 λ…λ¦½λœ μΆ• `403` 을 λ§Œλ‚¬λ‹€λ©΄ λ‘˜ 쀑 μ–΄λŠ 좕에 κ±Έλ¦° 것인지 λ¨Όμ € ꡬ뢄할 것. - **μŠ€μ½”ν”„** = *무엇을 ν•  수 μžˆλ‚˜*. 토큰에 λΆ€μ—¬λœ `bids:read`Β·`contracts:write` λ“±. 미보유 μ‹œ `…/insufficient-scope`. - **λŒ€ν–‰ λ²”μœ„** = *λˆ„κ΅¬μ˜ 데이터λ₯Ό λ‹€λ£° 수 μžˆλ‚˜*. API ν‚€ 섀정이며 μŠ€μ½”ν”„λ‘œ ν‘œν˜„λ˜μ§€ μ•ŠλŠ”λ‹€. λ²”μœ„ 밖이면 μŠ€μ½”ν”„μ™€ λ¬΄κ΄€ν•˜κ²Œ 403 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
4
4
  *
5
- * The version of the OpenAPI document: 22.6.0
5
+ * The version of the OpenAPI document: 22.7.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/base.js CHANGED
@@ -5,7 +5,7 @@
5
5
  * CMARKET V6 Partner API
6
6
  * μ™ΈλΆ€ ERP μ—°λ™μš© RESTful API. ## 버전별 인증 - **_/v2** β€” OAuth2 Bearer JWT (`client_credentials` ν”Œλ‘œμš°). `/oauth/token` μ—μ„œ 토큰 λ°œκΈ‰ ν›„ `Authorization: Bearer <token>` 헀더. - **_/v1** β€” V5 μΆ©μ‹€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν—€λ”λ‘œ 전솑. ## κΆŒν•œ β€” 두 개의 λ…λ¦½λœ μΆ• `403` 을 λ§Œλ‚¬λ‹€λ©΄ λ‘˜ 쀑 μ–΄λŠ 좕에 κ±Έλ¦° 것인지 λ¨Όμ € ꡬ뢄할 것. - **μŠ€μ½”ν”„** = *무엇을 ν•  수 μžˆλ‚˜*. 토큰에 λΆ€μ—¬λœ `bids:read`Β·`contracts:write` λ“±. 미보유 μ‹œ `…/insufficient-scope`. - **λŒ€ν–‰ λ²”μœ„** = *λˆ„κ΅¬μ˜ 데이터λ₯Ό λ‹€λ£° 수 μžˆλ‚˜*. API ν‚€ 섀정이며 μŠ€μ½”ν”„λ‘œ ν‘œν˜„λ˜μ§€ μ•ŠλŠ”λ‹€. λ²”μœ„ 밖이면 μŠ€μ½”ν”„μ™€ λ¬΄κ΄€ν•˜κ²Œ 403 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
7
7
  *
8
- * The version of the OpenAPI document: 22.6.0
8
+ * The version of the OpenAPI document: 22.7.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/common.d.ts CHANGED
@@ -2,7 +2,7 @@
2
2
  * CMARKET V6 Partner API
3
3
  * μ™ΈλΆ€ ERP μ—°λ™μš© RESTful API. ## 버전별 인증 - **_/v2** β€” OAuth2 Bearer JWT (`client_credentials` ν”Œλ‘œμš°). `/oauth/token` μ—μ„œ 토큰 λ°œκΈ‰ ν›„ `Authorization: Bearer <token>` 헀더. - **_/v1** β€” V5 μΆ©μ‹€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν—€λ”λ‘œ 전솑. ## κΆŒν•œ β€” 두 개의 λ…λ¦½λœ μΆ• `403` 을 λ§Œλ‚¬λ‹€λ©΄ λ‘˜ 쀑 μ–΄λŠ 좕에 κ±Έλ¦° 것인지 λ¨Όμ € ꡬ뢄할 것. - **μŠ€μ½”ν”„** = *무엇을 ν•  수 μžˆλ‚˜*. 토큰에 λΆ€μ—¬λœ `bids:read`Β·`contracts:write` λ“±. 미보유 μ‹œ `…/insufficient-scope`. - **λŒ€ν–‰ λ²”μœ„** = *λˆ„κ΅¬μ˜ 데이터λ₯Ό λ‹€λ£° 수 μžˆλ‚˜*. API ν‚€ 섀정이며 μŠ€μ½”ν”„λ‘œ ν‘œν˜„λ˜μ§€ μ•ŠλŠ”λ‹€. λ²”μœ„ 밖이면 μŠ€μ½”ν”„μ™€ λ¬΄κ΄€ν•˜κ²Œ 403 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
4
4
  *
5
- * The version of the OpenAPI document: 22.6.0
5
+ * The version of the OpenAPI document: 22.7.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/common.js CHANGED
@@ -5,7 +5,7 @@
5
5
  * CMARKET V6 Partner API
6
6
  * μ™ΈλΆ€ ERP μ—°λ™μš© RESTful API. ## 버전별 인증 - **_/v2** β€” OAuth2 Bearer JWT (`client_credentials` ν”Œλ‘œμš°). `/oauth/token` μ—μ„œ 토큰 λ°œκΈ‰ ν›„ `Authorization: Bearer <token>` 헀더. - **_/v1** β€” V5 μΆ©μ‹€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν—€λ”λ‘œ 전솑. ## κΆŒν•œ β€” 두 개의 λ…λ¦½λœ μΆ• `403` 을 λ§Œλ‚¬λ‹€λ©΄ λ‘˜ 쀑 μ–΄λŠ 좕에 κ±Έλ¦° 것인지 λ¨Όμ € ꡬ뢄할 것. - **μŠ€μ½”ν”„** = *무엇을 ν•  수 μžˆλ‚˜*. 토큰에 λΆ€μ—¬λœ `bids:read`Β·`contracts:write` λ“±. 미보유 μ‹œ `…/insufficient-scope`. - **λŒ€ν–‰ λ²”μœ„** = *λˆ„κ΅¬μ˜ 데이터λ₯Ό λ‹€λ£° 수 μžˆλ‚˜*. API ν‚€ 섀정이며 μŠ€μ½”ν”„λ‘œ ν‘œν˜„λ˜μ§€ μ•ŠλŠ”λ‹€. λ²”μœ„ 밖이면 μŠ€μ½”ν”„μ™€ λ¬΄κ΄€ν•˜κ²Œ 403 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
7
7
  *
8
- * The version of the OpenAPI document: 22.6.0
8
+ * The version of the OpenAPI document: 22.7.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).
@@ -2,7 +2,7 @@
2
2
  * CMARKET V6 Partner API
3
3
  * μ™ΈλΆ€ ERP μ—°λ™μš© RESTful API. ## 버전별 인증 - **_/v2** β€” OAuth2 Bearer JWT (`client_credentials` ν”Œλ‘œμš°). `/oauth/token` μ—μ„œ 토큰 λ°œκΈ‰ ν›„ `Authorization: Bearer <token>` 헀더. - **_/v1** β€” V5 μΆ©μ‹€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν—€λ”λ‘œ 전솑. ## κΆŒν•œ β€” 두 개의 λ…λ¦½λœ μΆ• `403` 을 λ§Œλ‚¬λ‹€λ©΄ λ‘˜ 쀑 μ–΄λŠ 좕에 κ±Έλ¦° 것인지 λ¨Όμ € ꡬ뢄할 것. - **μŠ€μ½”ν”„** = *무엇을 ν•  수 μžˆλ‚˜*. 토큰에 λΆ€μ—¬λœ `bids:read`Β·`contracts:write` λ“±. 미보유 μ‹œ `…/insufficient-scope`. - **λŒ€ν–‰ λ²”μœ„** = *λˆ„κ΅¬μ˜ 데이터λ₯Ό λ‹€λ£° 수 μžˆλ‚˜*. API ν‚€ 섀정이며 μŠ€μ½”ν”„λ‘œ ν‘œν˜„λ˜μ§€ μ•ŠλŠ”λ‹€. λ²”μœ„ 밖이면 μŠ€μ½”ν”„μ™€ λ¬΄κ΄€ν•˜κ²Œ 403 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
4
4
  *
5
- * The version of the OpenAPI document: 22.6.0
5
+ * The version of the OpenAPI document: 22.7.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).
@@ -4,7 +4,7 @@
4
4
  * CMARKET V6 Partner API
5
5
  * μ™ΈλΆ€ ERP μ—°λ™μš© RESTful API. ## 버전별 인증 - **_/v2** β€” OAuth2 Bearer JWT (`client_credentials` ν”Œλ‘œμš°). `/oauth/token` μ—μ„œ 토큰 λ°œκΈ‰ ν›„ `Authorization: Bearer <token>` 헀더. - **_/v1** β€” V5 μΆ©μ‹€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν—€λ”λ‘œ 전솑. ## κΆŒν•œ β€” 두 개의 λ…λ¦½λœ μΆ• `403` 을 λ§Œλ‚¬λ‹€λ©΄ λ‘˜ 쀑 μ–΄λŠ 좕에 κ±Έλ¦° 것인지 λ¨Όμ € ꡬ뢄할 것. - **μŠ€μ½”ν”„** = *무엇을 ν•  수 μžˆλ‚˜*. 토큰에 λΆ€μ—¬λœ `bids:read`Β·`contracts:write` λ“±. 미보유 μ‹œ `…/insufficient-scope`. - **λŒ€ν–‰ λ²”μœ„** = *λˆ„κ΅¬μ˜ 데이터λ₯Ό λ‹€λ£° 수 μžˆλ‚˜*. API ν‚€ 섀정이며 μŠ€μ½”ν”„λ‘œ ν‘œν˜„λ˜μ§€ μ•ŠλŠ”λ‹€. λ²”μœ„ 밖이면 μŠ€μ½”ν”„μ™€ λ¬΄κ΄€ν•˜κ²Œ 403 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
6
6
  *
7
- * The version of the OpenAPI document: 22.6.0
7
+ * The version of the OpenAPI document: 22.7.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).
@@ -2,7 +2,7 @@
2
2
  * CMARKET V6 Partner API
3
3
  * μ™ΈλΆ€ ERP μ—°λ™μš© RESTful API. ## 버전별 인증 - **_/v2** β€” OAuth2 Bearer JWT (`client_credentials` ν”Œλ‘œμš°). `/oauth/token` μ—μ„œ 토큰 λ°œκΈ‰ ν›„ `Authorization: Bearer <token>` 헀더. - **_/v1** β€” V5 μΆ©μ‹€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν—€λ”λ‘œ 전솑. ## κΆŒν•œ β€” 두 개의 λ…λ¦½λœ μΆ• `403` 을 λ§Œλ‚¬λ‹€λ©΄ λ‘˜ 쀑 μ–΄λŠ 좕에 κ±Έλ¦° 것인지 λ¨Όμ € ꡬ뢄할 것. - **μŠ€μ½”ν”„** = *무엇을 ν•  수 μžˆλ‚˜*. 토큰에 λΆ€μ—¬λœ `bids:read`Β·`contracts:write` λ“±. 미보유 μ‹œ `…/insufficient-scope`. - **λŒ€ν–‰ λ²”μœ„** = *λˆ„κ΅¬μ˜ 데이터λ₯Ό λ‹€λ£° 수 μžˆλ‚˜*. API ν‚€ 섀정이며 μŠ€μ½”ν”„λ‘œ ν‘œν˜„λ˜μ§€ μ•ŠλŠ”λ‹€. λ²”μœ„ 밖이면 μŠ€μ½”ν”„μ™€ λ¬΄κ΄€ν•˜κ²Œ 403 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
4
4
  *
5
- * The version of the OpenAPI document: 22.6.0
5
+ * The version of the OpenAPI document: 22.7.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).
@@ -4,7 +4,7 @@
4
4
  * CMARKET V6 Partner API
5
5
  * μ™ΈλΆ€ ERP μ—°λ™μš© RESTful API. ## 버전별 인증 - **_/v2** β€” OAuth2 Bearer JWT (`client_credentials` ν”Œλ‘œμš°). `/oauth/token` μ—μ„œ 토큰 λ°œκΈ‰ ν›„ `Authorization: Bearer <token>` 헀더. - **_/v1** β€” V5 μΆ©μ‹€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν—€λ”λ‘œ 전솑. ## κΆŒν•œ β€” 두 개의 λ…λ¦½λœ μΆ• `403` 을 λ§Œλ‚¬λ‹€λ©΄ λ‘˜ 쀑 μ–΄λŠ 좕에 κ±Έλ¦° 것인지 λ¨Όμ € ꡬ뢄할 것. - **μŠ€μ½”ν”„** = *무엇을 ν•  수 μžˆλ‚˜*. 토큰에 λΆ€μ—¬λœ `bids:read`Β·`contracts:write` λ“±. 미보유 μ‹œ `…/insufficient-scope`. - **λŒ€ν–‰ λ²”μœ„** = *λˆ„κ΅¬μ˜ 데이터λ₯Ό λ‹€λ£° 수 μžˆλ‚˜*. API ν‚€ 섀정이며 μŠ€μ½”ν”„λ‘œ ν‘œν˜„λ˜μ§€ μ•ŠλŠ”λ‹€. λ²”μœ„ 밖이면 μŠ€μ½”ν”„μ™€ λ¬΄κ΄€ν•˜κ²Œ 403 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
6
6
  *
7
- * The version of the OpenAPI document: 22.6.0
7
+ * The version of the OpenAPI document: 22.7.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).
@@ -2,7 +2,7 @@
2
2
  * CMARKET V6 Partner API
3
3
  * μ™ΈλΆ€ ERP μ—°λ™μš© RESTful API. ## 버전별 인증 - **_/v2** β€” OAuth2 Bearer JWT (`client_credentials` ν”Œλ‘œμš°). `/oauth/token` μ—μ„œ 토큰 λ°œκΈ‰ ν›„ `Authorization: Bearer <token>` 헀더. - **_/v1** β€” V5 μΆ©μ‹€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν—€λ”λ‘œ 전솑. ## κΆŒν•œ β€” 두 개의 λ…λ¦½λœ μΆ• `403` 을 λ§Œλ‚¬λ‹€λ©΄ λ‘˜ 쀑 μ–΄λŠ 좕에 κ±Έλ¦° 것인지 λ¨Όμ € ꡬ뢄할 것. - **μŠ€μ½”ν”„** = *무엇을 ν•  수 μžˆλ‚˜*. 토큰에 λΆ€μ—¬λœ `bids:read`Β·`contracts:write` λ“±. 미보유 μ‹œ `…/insufficient-scope`. - **λŒ€ν–‰ λ²”μœ„** = *λˆ„κ΅¬μ˜ 데이터λ₯Ό λ‹€λ£° 수 μžˆλ‚˜*. API ν‚€ 섀정이며 μŠ€μ½”ν”„λ‘œ ν‘œν˜„λ˜μ§€ μ•ŠλŠ”λ‹€. λ²”μœ„ 밖이면 μŠ€μ½”ν”„μ™€ λ¬΄κ΄€ν•˜κ²Œ 403 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
4
4
  *
5
- * The version of the OpenAPI document: 22.6.0
5
+ * The version of the OpenAPI document: 22.7.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).
@@ -4,7 +4,7 @@
4
4
  * CMARKET V6 Partner API
5
5
  * μ™ΈλΆ€ ERP μ—°λ™μš© RESTful API. ## 버전별 인증 - **_/v2** β€” OAuth2 Bearer JWT (`client_credentials` ν”Œλ‘œμš°). `/oauth/token` μ—μ„œ 토큰 λ°œκΈ‰ ν›„ `Authorization: Bearer <token>` 헀더. - **_/v1** β€” V5 μΆ©μ‹€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν—€λ”λ‘œ 전솑. ## κΆŒν•œ β€” 두 개의 λ…λ¦½λœ μΆ• `403` 을 λ§Œλ‚¬λ‹€λ©΄ λ‘˜ 쀑 μ–΄λŠ 좕에 κ±Έλ¦° 것인지 λ¨Όμ € ꡬ뢄할 것. - **μŠ€μ½”ν”„** = *무엇을 ν•  수 μžˆλ‚˜*. 토큰에 λΆ€μ—¬λœ `bids:read`Β·`contracts:write` λ“±. 미보유 μ‹œ `…/insufficient-scope`. - **λŒ€ν–‰ λ²”μœ„** = *λˆ„κ΅¬μ˜ 데이터λ₯Ό λ‹€λ£° 수 μžˆλ‚˜*. API ν‚€ 섀정이며 μŠ€μ½”ν”„λ‘œ ν‘œν˜„λ˜μ§€ μ•ŠλŠ”λ‹€. λ²”μœ„ 밖이면 μŠ€μ½”ν”„μ™€ λ¬΄κ΄€ν•˜κ²Œ 403 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
6
6
  *
7
- * The version of the OpenAPI document: 22.6.0
7
+ * The version of the OpenAPI document: 22.7.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).
@@ -2,7 +2,7 @@
2
2
  * CMARKET V6 Partner API
3
3
  * μ™ΈλΆ€ ERP μ—°λ™μš© RESTful API. ## 버전별 인증 - **_/v2** β€” OAuth2 Bearer JWT (`client_credentials` ν”Œλ‘œμš°). `/oauth/token` μ—μ„œ 토큰 λ°œκΈ‰ ν›„ `Authorization: Bearer <token>` 헀더. - **_/v1** β€” V5 μΆ©μ‹€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν—€λ”λ‘œ 전솑. ## κΆŒν•œ β€” 두 개의 λ…λ¦½λœ μΆ• `403` 을 λ§Œλ‚¬λ‹€λ©΄ λ‘˜ 쀑 μ–΄λŠ 좕에 κ±Έλ¦° 것인지 λ¨Όμ € ꡬ뢄할 것. - **μŠ€μ½”ν”„** = *무엇을 ν•  수 μžˆλ‚˜*. 토큰에 λΆ€μ—¬λœ `bids:read`Β·`contracts:write` λ“±. 미보유 μ‹œ `…/insufficient-scope`. - **λŒ€ν–‰ λ²”μœ„** = *λˆ„κ΅¬μ˜ 데이터λ₯Ό λ‹€λ£° 수 μžˆλ‚˜*. API ν‚€ 섀정이며 μŠ€μ½”ν”„λ‘œ ν‘œν˜„λ˜μ§€ μ•ŠλŠ”λ‹€. λ²”μœ„ 밖이면 μŠ€μ½”ν”„μ™€ λ¬΄κ΄€ν•˜κ²Œ 403 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
4
4
  *
5
- * The version of the OpenAPI document: 22.6.0
5
+ * The version of the OpenAPI document: 22.7.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).
@@ -4,7 +4,7 @@
4
4
  * CMARKET V6 Partner API
5
5
  * μ™ΈλΆ€ ERP μ—°λ™μš© RESTful API. ## 버전별 인증 - **_/v2** β€” OAuth2 Bearer JWT (`client_credentials` ν”Œλ‘œμš°). `/oauth/token` μ—μ„œ 토큰 λ°œκΈ‰ ν›„ `Authorization: Bearer <token>` 헀더. - **_/v1** β€” V5 μΆ©μ‹€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν—€λ”λ‘œ 전솑. ## κΆŒν•œ β€” 두 개의 λ…λ¦½λœ μΆ• `403` 을 λ§Œλ‚¬λ‹€λ©΄ λ‘˜ 쀑 μ–΄λŠ 좕에 κ±Έλ¦° 것인지 λ¨Όμ € ꡬ뢄할 것. - **μŠ€μ½”ν”„** = *무엇을 ν•  수 μžˆλ‚˜*. 토큰에 λΆ€μ—¬λœ `bids:read`Β·`contracts:write` λ“±. 미보유 μ‹œ `…/insufficient-scope`. - **λŒ€ν–‰ λ²”μœ„** = *λˆ„κ΅¬μ˜ 데이터λ₯Ό λ‹€λ£° 수 μžˆλ‚˜*. API ν‚€ 섀정이며 μŠ€μ½”ν”„λ‘œ ν‘œν˜„λ˜μ§€ μ•ŠλŠ”λ‹€. λ²”μœ„ 밖이면 μŠ€μ½”ν”„μ™€ λ¬΄κ΄€ν•˜κ²Œ 403 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
6
6
  *
7
- * The version of the OpenAPI document: 22.6.0
7
+ * The version of the OpenAPI document: 22.7.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).
@@ -0,0 +1,92 @@
1
+ /**
2
+ * CMARKET V6 Partner API
3
+ * μ™ΈλΆ€ ERP μ—°λ™μš© RESTful API. ## 버전별 인증 - **_/v2** β€” OAuth2 Bearer JWT (`client_credentials` ν”Œλ‘œμš°). `/oauth/token` μ—μ„œ 토큰 λ°œκΈ‰ ν›„ `Authorization: Bearer <token>` 헀더. - **_/v1** β€” V5 μΆ©μ‹€ platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) ν—€λ”λ‘œ 전솑. ## κΆŒν•œ β€” 두 개의 λ…λ¦½λœ μΆ• `403` 을 λ§Œλ‚¬λ‹€λ©΄ λ‘˜ 쀑 μ–΄λŠ 좕에 κ±Έλ¦° 것인지 λ¨Όμ € ꡬ뢄할 것. - **μŠ€μ½”ν”„** = *무엇을 ν•  수 μžˆλ‚˜*. 토큰에 λΆ€μ—¬λœ `bids:read`Β·`contracts:write` λ“±. 미보유 μ‹œ `…/insufficient-scope`. - **λŒ€ν–‰ λ²”μœ„** = *λˆ„κ΅¬μ˜ 데이터λ₯Ό λ‹€λ£° 수 μžˆλ‚˜*. API ν‚€ 섀정이며 μŠ€μ½”ν”„λ‘œ ν‘œν˜„λ˜μ§€ μ•ŠλŠ”λ‹€. λ²”μœ„ 밖이면 μŠ€μ½”ν”„μ™€ λ¬΄κ΄€ν•˜κ²Œ 403 이닀. λŒ€ν–‰ λ²”μœ„λŠ” ν‚€λ§ˆλ‹€ λ‘˜ 쀑 ν•˜λ‚˜λ‘œ μ„€μ •λœλ‹€ β€” **μ†Œμ† κ·Έλ£Ή 전원**(κΈ°κ΄€ ν‚€. μ‚¬μ—…μ²˜Β·λΆ€μ„œ 계정이 μƒˆλ‘œ 생겨도 μžλ™ 포함) λ˜λŠ” **μ§€μ • 발주처 λͺ©λ‘**(κ³„μ•½μœΌλ‘œ ν•©μ˜λœ λͺ©λ‘). λ²”μœ„λ₯Ό λ„“ν˜€μ•Ό ν•˜λ©΄ μŠ€μ½”ν”„κ°€ μ•„λ‹ˆλΌ ν‚€ μ„€μ • 변경을 μš”μ²­ν•  것. ## μ—λŸ¬ (RFC 9457 problem+json) λͺ¨λ“  μ—λŸ¬ 응닡은 `application/problem+json`. μ†ŒλΉ„μžλŠ” **HTTP status + `type` URI** 둜 λΆ„κΈ°ν•œλ‹€. - `retryable`(boolean): μžλ™ μž¬μ‹œλ„ μ•ˆμ „ μ—¬λΆ€. `true`(429Β·5xx transient)λ©΄ backoff ν›„ μž¬μ‹œλ„, `false`λ©΄ μš”μ²­μ„ 고쳐야 ν•œλ‹€. - `correlationId`: μš”μ²­ 좔적 id. `X-Correlation-Id` 응닡 헀더와 동일 β€” 문의 μ‹œ 이 값을 첨뢀. - `invalid-params`: 검증 μ‹€νŒ¨(400 `…/validation-failed`) μ‹œ μœ„λ°˜ ν•„λ“œ 경둜 λͺ©λ‘(RFC 9457 ν™•μž₯, κ°’ μ—†μŒ). ## 레이트 리밋 μ „μ—­ **60 μš”μ²­/λΆ„ per `client_id`**, 토큰 λ°œκΈ‰(`/oauth/token`)은 **5 μš”μ²­/λΆ„**. 초과 μ‹œ `429`(`type: …/too-many-requests`). `Retry-After` 헀더가 μž¬μ‹œλ„ λŒ€κΈ°(초)λ₯Ό, `X-RateLimit-Limit`/`X-RateLimit-Remaining`/`X-RateLimit-Reset` 헀더가 ν˜„μž¬ μΏΌν„°λ₯Ό μ•ˆλ‚΄ν•œλ‹€. λŒ€λŸ‰ 동기화(ν’ˆλͺ© λ‹¨μœ„ 반볡 등둝 λ“±)λŠ” 429 λ₯Ό λ§Œλ‚˜λ©΄ `Retry-After` 만큼 backoff ν›„ μž¬μ‹œλ„ν•  것. ## 좔적 μš”μ²­μ— `X-Correlation-Id` 헀더λ₯Ό μ‹€μœΌλ©΄ κ·ΈλŒ€λ‘œ echo 되고, μ—†μœΌλ©΄ μ„œλ²„κ°€ λ°œκΈ‰ν•œλ‹€. λͺ¨λ“  응닡(성곡/μ—λŸ¬)에 `X-Correlation-Id` κ°€ μ‹€λ¦°λ‹€. ## 버전 수λͺ…(deprecation/sunset) - **_/v1** 은 λ ˆκ±°μ‹œ V5 cutover μ™„λ£Œ μ‹œμ κΉŒμ§€ μœ μ§€λ˜λŠ” μΆ©μ‹€ ν”„λ‘μ‹œλ‹€. 이후 `Deprecation`/`Sunset` 응닡 ν—€λ”λ‘œ 폐지 일정을 사전 ν†΅μ§€ν•œλ‹€. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` ν—€λ”λ‘œ ν†΅μ§€ν•œλ‹€. μ†ŒλΉ„μžλŠ” 이 헀더λ₯Ό λͺ¨λ‹ˆν„°λ§ν•  것.
4
+ *
5
+ * The version of the OpenAPI document: 22.7.0
6
+ * Contact: semo.io.kr@gmail.com
7
+ *
8
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
9
+ * https://openapi-generator.tech
10
+ * Do not edit the class manually.
11
+ */
12
+ import type { Configuration } from '../configuration';
13
+ import type { AxiosPromise, AxiosInstance, RawAxiosRequestConfig } from 'axios';
14
+ import { type RequestArgs, BaseAPI } from '../base';
15
+ import type { AuthorizationServerMetadataDto } from '../models';
16
+ import type { ProtectedResourceMetadataDto } from '../models';
17
+ /**
18
+ * WellKnownApi - axios parameter creator
19
+ */
20
+ export declare const WellKnownApiAxiosParamCreator: (configuration?: Configuration) => {
21
+ /**
22
+ * 이 배포의 token endpoint·지원 grant/scope/μ•Œκ³ λ¦¬μ¦˜μ„ 기계가 μ½λŠ” ν˜•μ‹μœΌλ‘œ κ³΅κ°œν•©λ‹ˆλ‹€. 인증이 ν•„μš” μ—†μŠ΅λ‹ˆλ‹€.
23
+ * @summary OAuth 2.0 μΈκ°€μ„œλ²„ 메타데이터 (Authorization Server Metadata, RFC 8414)
24
+ * @param {*} [options] Override http request option.
25
+ * @throws {RequiredError}
26
+ */
27
+ authorizationServerMetadata: (options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
28
+ /**
29
+ * 이 API λ₯Ό λ³΄ν˜Έν•˜λŠ” authorization server 와 지원 scope λ₯Ό κ³΅κ°œν•©λ‹ˆλ‹€. 401 μ‘λ‹΅μ˜ WWW-Authenticate 헀더가 이 λ¬Έμ„œλ₯Ό κ°€λ¦¬ν‚΅λ‹ˆλ‹€. 인증이 ν•„μš” μ—†μŠ΅λ‹ˆλ‹€.
30
+ * @summary OAuth 2.0 λ³΄ν˜Έμžμ› 메타데이터 (Protected Resource Metadata, RFC 9728)
31
+ * @param {*} [options] Override http request option.
32
+ * @throws {RequiredError}
33
+ */
34
+ protectedResourceMetadata: (options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
35
+ };
36
+ /**
37
+ * WellKnownApi - functional programming interface
38
+ */
39
+ export declare const WellKnownApiFp: (configuration?: Configuration) => {
40
+ /**
41
+ * 이 배포의 token endpoint·지원 grant/scope/μ•Œκ³ λ¦¬μ¦˜μ„ 기계가 μ½λŠ” ν˜•μ‹μœΌλ‘œ κ³΅κ°œν•©λ‹ˆλ‹€. 인증이 ν•„μš” μ—†μŠ΅λ‹ˆλ‹€.
42
+ * @summary OAuth 2.0 μΈκ°€μ„œλ²„ 메타데이터 (Authorization Server Metadata, RFC 8414)
43
+ * @param {*} [options] Override http request option.
44
+ * @throws {RequiredError}
45
+ */
46
+ authorizationServerMetadata(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AuthorizationServerMetadataDto>>;
47
+ /**
48
+ * 이 API λ₯Ό λ³΄ν˜Έν•˜λŠ” authorization server 와 지원 scope λ₯Ό κ³΅κ°œν•©λ‹ˆλ‹€. 401 μ‘λ‹΅μ˜ WWW-Authenticate 헀더가 이 λ¬Έμ„œλ₯Ό κ°€λ¦¬ν‚΅λ‹ˆλ‹€. 인증이 ν•„μš” μ—†μŠ΅λ‹ˆλ‹€.
49
+ * @summary OAuth 2.0 λ³΄ν˜Έμžμ› 메타데이터 (Protected Resource Metadata, RFC 9728)
50
+ * @param {*} [options] Override http request option.
51
+ * @throws {RequiredError}
52
+ */
53
+ protectedResourceMetadata(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ProtectedResourceMetadataDto>>;
54
+ };
55
+ /**
56
+ * WellKnownApi - factory interface
57
+ */
58
+ export declare const WellKnownApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
59
+ /**
60
+ * 이 배포의 token endpoint·지원 grant/scope/μ•Œκ³ λ¦¬μ¦˜μ„ 기계가 μ½λŠ” ν˜•μ‹μœΌλ‘œ κ³΅κ°œν•©λ‹ˆλ‹€. 인증이 ν•„μš” μ—†μŠ΅λ‹ˆλ‹€.
61
+ * @summary OAuth 2.0 μΈκ°€μ„œλ²„ 메타데이터 (Authorization Server Metadata, RFC 8414)
62
+ * @param {*} [options] Override http request option.
63
+ * @throws {RequiredError}
64
+ */
65
+ authorizationServerMetadata(options?: RawAxiosRequestConfig): AxiosPromise<AuthorizationServerMetadataDto>;
66
+ /**
67
+ * 이 API λ₯Ό λ³΄ν˜Έν•˜λŠ” authorization server 와 지원 scope λ₯Ό κ³΅κ°œν•©λ‹ˆλ‹€. 401 μ‘λ‹΅μ˜ WWW-Authenticate 헀더가 이 λ¬Έμ„œλ₯Ό κ°€λ¦¬ν‚΅λ‹ˆλ‹€. 인증이 ν•„μš” μ—†μŠ΅λ‹ˆλ‹€.
68
+ * @summary OAuth 2.0 λ³΄ν˜Έμžμ› 메타데이터 (Protected Resource Metadata, RFC 9728)
69
+ * @param {*} [options] Override http request option.
70
+ * @throws {RequiredError}
71
+ */
72
+ protectedResourceMetadata(options?: RawAxiosRequestConfig): AxiosPromise<ProtectedResourceMetadataDto>;
73
+ };
74
+ /**
75
+ * WellKnownApi - object-oriented interface
76
+ */
77
+ export declare class WellKnownApi extends BaseAPI {
78
+ /**
79
+ * 이 배포의 token endpoint·지원 grant/scope/μ•Œκ³ λ¦¬μ¦˜μ„ 기계가 μ½λŠ” ν˜•μ‹μœΌλ‘œ κ³΅κ°œν•©λ‹ˆλ‹€. 인증이 ν•„μš” μ—†μŠ΅λ‹ˆλ‹€.
80
+ * @summary OAuth 2.0 μΈκ°€μ„œλ²„ 메타데이터 (Authorization Server Metadata, RFC 8414)
81
+ * @param {*} [options] Override http request option.
82
+ * @throws {RequiredError}
83
+ */
84
+ authorizationServerMetadata(options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<AuthorizationServerMetadataDto, any, {}>>;
85
+ /**
86
+ * 이 API λ₯Ό λ³΄ν˜Έν•˜λŠ” authorization server 와 지원 scope λ₯Ό κ³΅κ°œν•©λ‹ˆλ‹€. 401 μ‘λ‹΅μ˜ WWW-Authenticate 헀더가 이 λ¬Έμ„œλ₯Ό κ°€λ¦¬ν‚΅λ‹ˆλ‹€. 인증이 ν•„μš” μ—†μŠ΅λ‹ˆλ‹€.
87
+ * @summary OAuth 2.0 λ³΄ν˜Έμžμ› 메타데이터 (Protected Resource Metadata, RFC 9728)
88
+ * @param {*} [options] Override http request option.
89
+ * @throws {RequiredError}
90
+ */
91
+ protectedResourceMetadata(options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ProtectedResourceMetadataDto, any, {}>>;
92
+ }