@cmarket/partner-sdk 36.1.0 β 36.1.1
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.
- package/README.md +4 -4
- package/api/oauth-api.ts +1 -1
- package/api/partner-api-api.ts +69 -78
- package/api/products-api.ts +5 -5
- package/api/well-known-api.ts +1 -1
- package/api.ts +1 -1
- package/base.ts +1 -1
- package/common.ts +1 -1
- package/configuration.ts +1 -1
- package/dist/api/oauth-api.d.ts +1 -1
- package/dist/api/oauth-api.js +1 -1
- package/dist/api/partner-api-api.d.ts +65 -69
- package/dist/api/partner-api-api.js +69 -78
- package/dist/api/products-api.d.ts +5 -5
- package/dist/api/products-api.js +5 -5
- package/dist/api/well-known-api.d.ts +1 -1
- package/dist/api/well-known-api.js +1 -1
- package/dist/api.d.ts +1 -1
- package/dist/api.js +1 -1
- package/dist/base.d.ts +1 -1
- package/dist/base.js +1 -1
- package/dist/common.d.ts +1 -1
- package/dist/common.js +1 -1
- package/dist/configuration.d.ts +1 -1
- package/dist/configuration.js +1 -1
- package/dist/esm/api/oauth-api.d.ts +1 -1
- package/dist/esm/api/oauth-api.js +1 -1
- package/dist/esm/api/partner-api-api.d.ts +65 -69
- package/dist/esm/api/partner-api-api.js +69 -78
- package/dist/esm/api/products-api.d.ts +5 -5
- package/dist/esm/api/products-api.js +5 -5
- package/dist/esm/api/well-known-api.d.ts +1 -1
- package/dist/esm/api/well-known-api.js +1 -1
- package/dist/esm/api.d.ts +1 -1
- package/dist/esm/api.js +1 -1
- package/dist/esm/base.d.ts +1 -1
- package/dist/esm/base.js +1 -1
- package/dist/esm/common.d.ts +1 -1
- package/dist/esm/common.js +1 -1
- package/dist/esm/configuration.d.ts +1 -1
- package/dist/esm/configuration.js +1 -1
- package/dist/esm/index.d.ts +1 -1
- package/dist/esm/index.js +1 -1
- package/dist/esm/models/acceptance-result-response-dto.d.ts +1 -1
- package/dist/esm/models/acceptance-result-response-dto.js +1 -1
- package/dist/esm/models/acknowledge-product-receipt200-response.d.ts +1 -1
- package/dist/esm/models/acknowledge-product-receipt200-response.js +1 -1
- package/dist/esm/models/acknowledge-products-request-dto.d.ts +1 -1
- package/dist/esm/models/acknowledge-products-request-dto.js +1 -1
- package/dist/esm/models/api-catalog-dto.d.ts +1 -1
- package/dist/esm/models/api-catalog-dto.js +1 -1
- package/dist/esm/models/api-catalog-entry-dto.d.ts +1 -1
- package/dist/esm/models/api-catalog-entry-dto.js +1 -1
- package/dist/esm/models/api-catalog-link-dto.d.ts +1 -1
- package/dist/esm/models/api-catalog-link-dto.js +1 -1
- package/dist/esm/models/authorization-server-metadata-dto.d.ts +1 -1
- package/dist/esm/models/authorization-server-metadata-dto.js +1 -1
- package/dist/esm/models/award-method-public.d.ts +1 -1
- package/dist/esm/models/award-method-public.js +1 -1
- package/dist/esm/models/award-registered-v2-response-dto.d.ts +1 -1
- package/dist/esm/models/award-registered-v2-response-dto.js +1 -1
- package/dist/esm/models/award-reverted-v2-response-dto.d.ts +1 -1
- package/dist/esm/models/award-reverted-v2-response-dto.js +1 -1
- package/dist/esm/models/bid-acceptance-dto.d.ts +1 -1
- package/dist/esm/models/bid-acceptance-dto.js +1 -1
- package/dist/esm/models/bid-bond-dto.d.ts +1 -1
- package/dist/esm/models/bid-bond-dto.js +1 -1
- package/dist/esm/models/bid-cancelled-response-dto.d.ts +1 -1
- package/dist/esm/models/bid-cancelled-response-dto.js +1 -1
- package/dist/esm/models/bid-contact-dto.d.ts +1 -1
- package/dist/esm/models/bid-contact-dto.js +1 -1
- package/dist/esm/models/bid-contacts-dto.d.ts +1 -1
- package/dist/esm/models/bid-contacts-dto.js +1 -1
- package/dist/esm/models/bid-contract-document-dto.d.ts +1 -1
- package/dist/esm/models/bid-contract-document-dto.js +1 -1
- package/dist/esm/models/bid-delivery-terms-dto.d.ts +1 -1
- package/dist/esm/models/bid-delivery-terms-dto.js +1 -1
- package/dist/esm/models/bid-detail-response-dto.d.ts +1 -1
- package/dist/esm/models/bid-detail-response-dto.js +1 -1
- package/dist/esm/models/bid-document-dto.d.ts +1 -1
- package/dist/esm/models/bid-document-dto.js +1 -1
- package/dist/esm/models/bid-failed-v2-response-dto.d.ts +1 -1
- package/dist/esm/models/bid-failed-v2-response-dto.js +1 -1
- package/dist/esm/models/bid-item-dto.d.ts +1 -1
- package/dist/esm/models/bid-item-dto.js +1 -1
- package/dist/esm/models/bid-lifecycle-dto.d.ts +1 -1
- package/dist/esm/models/bid-lifecycle-dto.js +1 -1
- package/dist/esm/models/bid-manager-dto.d.ts +1 -1
- package/dist/esm/models/bid-manager-dto.js +1 -1
- package/dist/esm/models/bid-payment-terms-dto.d.ts +1 -1
- package/dist/esm/models/bid-payment-terms-dto.js +1 -1
- package/dist/esm/models/bid-product-dto.d.ts +1 -1
- package/dist/esm/models/bid-product-dto.js +1 -1
- package/dist/esm/models/bid-public-status.d.ts +1 -1
- package/dist/esm/models/bid-public-status.js +1 -1
- package/dist/esm/models/bid-registered-response-dto.d.ts +1 -1
- package/dist/esm/models/bid-registered-response-dto.js +1 -1
- package/dist/esm/models/bid-result-participant-attachment-dto.d.ts +1 -1
- package/dist/esm/models/bid-result-participant-attachment-dto.js +1 -1
- package/dist/esm/models/bid-result-participant-dto.d.ts +1 -1
- package/dist/esm/models/bid-result-participant-dto.js +1 -1
- package/dist/esm/models/bid-results-response-dto.d.ts +1 -1
- package/dist/esm/models/bid-results-response-dto.js +1 -1
- package/dist/esm/models/bid-settlement-line-item-dto.d.ts +1 -1
- package/dist/esm/models/bid-settlement-line-item-dto.js +1 -1
- package/dist/esm/models/bid-settlement-participant-dto.d.ts +1 -1
- package/dist/esm/models/bid-settlement-participant-dto.js +1 -1
- package/dist/esm/models/bid-settlement-response-dto.d.ts +1 -1
- package/dist/esm/models/bid-settlement-response-dto.js +1 -1
- package/dist/esm/models/bid-statement-response-dto.d.ts +1 -1
- package/dist/esm/models/bid-statement-response-dto.js +1 -1
- package/dist/esm/models/bid-summary-dto.d.ts +1 -1
- package/dist/esm/models/bid-summary-dto.js +1 -1
- package/dist/esm/models/bid-type-public.d.ts +1 -1
- package/dist/esm/models/bid-type-public.js +1 -1
- package/dist/esm/models/bid-updated-response-dto.d.ts +1 -1
- package/dist/esm/models/bid-updated-response-dto.js +1 -1
- package/dist/esm/models/cancel-bid-request-dto.d.ts +1 -1
- package/dist/esm/models/cancel-bid-request-dto.js +1 -1
- package/dist/esm/models/cancel-bid200-response.d.ts +1 -1
- package/dist/esm/models/cancel-bid200-response.js +1 -1
- package/dist/esm/models/card-payment-request-response-dto.d.ts +1 -1
- package/dist/esm/models/card-payment-request-response-dto.js +1 -1
- package/dist/esm/models/complete-acceptance-request-dto.d.ts +1 -1
- package/dist/esm/models/complete-acceptance-request-dto.js +1 -1
- package/dist/esm/models/complete-acceptance200-response.d.ts +1 -1
- package/dist/esm/models/complete-acceptance200-response.js +1 -1
- package/dist/esm/models/complete-invoice200-response.d.ts +1 -1
- package/dist/esm/models/complete-invoice200-response.js +1 -1
- package/dist/esm/models/contract-restriction-confirm-input-dto.d.ts +1 -1
- package/dist/esm/models/contract-restriction-confirm-input-dto.js +1 -1
- package/dist/esm/models/create-bid-request-dto.d.ts +1 -1
- package/dist/esm/models/create-bid-request-dto.js +1 -1
- package/dist/esm/models/create-card-payment-dto.d.ts +1 -1
- package/dist/esm/models/create-card-payment-dto.js +1 -1
- package/dist/esm/models/create-card-payment-request-dto.d.ts +1 -1
- package/dist/esm/models/create-card-payment-request-dto.js +1 -1
- package/dist/esm/models/create-card-payment200-response.d.ts +1 -1
- package/dist/esm/models/create-card-payment200-response.js +1 -1
- package/dist/esm/models/create-external-contract-documents-request-dto.d.ts +1 -1
- package/dist/esm/models/create-external-contract-documents-request-dto.js +1 -1
- package/dist/esm/models/create-external-contract-documents-response-dto.d.ts +1 -1
- package/dist/esm/models/create-external-contract-documents-response-dto.js +1 -1
- package/dist/esm/models/delivery-date-type-public.d.ts +1 -1
- package/dist/esm/models/delivery-date-type-public.js +1 -1
- package/dist/esm/models/delivery-method-public.d.ts +1 -1
- package/dist/esm/models/delivery-method-public.js +1 -1
- package/dist/esm/models/excellent-procurement-public.d.ts +1 -1
- package/dist/esm/models/excellent-procurement-public.js +1 -1
- package/dist/esm/models/external-contract-document-item-dto.d.ts +1 -1
- package/dist/esm/models/external-contract-document-item-dto.js +1 -1
- package/dist/esm/models/external-contract-documents-response-dto.d.ts +1 -1
- package/dist/esm/models/external-contract-documents-response-dto.js +1 -1
- package/dist/esm/models/external-contract-item-dto.d.ts +1 -1
- package/dist/esm/models/external-contract-item-dto.js +1 -1
- package/dist/esm/models/external-contract-snapshot-dto.d.ts +1 -1
- package/dist/esm/models/external-contract-snapshot-dto.js +1 -1
- package/dist/esm/models/external-document-inputs-dto.d.ts +1 -1
- package/dist/esm/models/external-document-inputs-dto.js +1 -1
- package/dist/esm/models/file-meta-response-dto.d.ts +1 -1
- package/dist/esm/models/file-meta-response-dto.js +1 -1
- package/dist/esm/models/file-uploaded-response-dto.d.ts +1 -1
- package/dist/esm/models/file-uploaded-response-dto.js +1 -1
- package/dist/esm/models/generated-external-contract-document-dto.d.ts +1 -1
- package/dist/esm/models/generated-external-contract-document-dto.js +1 -1
- package/dist/esm/models/get-bid-settlement200-response.d.ts +1 -1
- package/dist/esm/models/get-bid-settlement200-response.js +1 -1
- package/dist/esm/models/get-bid-statement200-response.d.ts +1 -1
- package/dist/esm/models/get-bid-statement200-response.js +1 -1
- package/dist/esm/models/get-bid200-response.d.ts +1 -1
- package/dist/esm/models/get-bid200-response.js +1 -1
- package/dist/esm/models/get-file-meta200-response.d.ts +1 -1
- package/dist/esm/models/get-file-meta200-response.js +1 -1
- package/dist/esm/models/get-supplier-card-payable-v2200-response.d.ts +1 -1
- package/dist/esm/models/get-supplier-card-payable-v2200-response.js +1 -1
- package/dist/esm/models/green-product-public.d.ts +1 -1
- package/dist/esm/models/green-product-public.js +1 -1
- package/dist/esm/models/health-controller-check200-response.d.ts +1 -1
- package/dist/esm/models/health-controller-check200-response.js +1 -1
- package/dist/esm/models/health-response-dto.d.ts +1 -1
- package/dist/esm/models/health-response-dto.js +1 -1
- package/dist/esm/models/hierarchical-region-dto.d.ts +1 -1
- package/dist/esm/models/hierarchical-region-dto.js +1 -1
- package/dist/esm/models/introspect-request-dto.d.ts +1 -1
- package/dist/esm/models/introspect-request-dto.js +1 -1
- package/dist/esm/models/introspection-response-dto.d.ts +1 -1
- package/dist/esm/models/introspection-response-dto.js +1 -1
- package/dist/esm/models/invalid-param-dto.d.ts +1 -1
- package/dist/esm/models/invalid-param-dto.js +1 -1
- package/dist/esm/models/invoice-completed-response-dto.d.ts +1 -1
- package/dist/esm/models/invoice-completed-response-dto.js +1 -1
- package/dist/esm/models/invoice-split-response-dto.d.ts +1 -1
- package/dist/esm/models/invoice-split-response-dto.js +1 -1
- package/dist/esm/models/legal-mandatory-public.d.ts +1 -1
- package/dist/esm/models/legal-mandatory-public.js +1 -1
- package/dist/esm/models/list-bid-results200-response.d.ts +1 -1
- package/dist/esm/models/list-bid-results200-response.js +1 -1
- package/dist/esm/models/list-bids-response-dto.d.ts +1 -1
- package/dist/esm/models/list-bids-response-dto.js +1 -1
- package/dist/esm/models/list-bids200-response.d.ts +1 -1
- package/dist/esm/models/list-bids200-response.js +1 -1
- package/dist/esm/models/list-products200-response.d.ts +1 -1
- package/dist/esm/models/list-products200-response.js +1 -1
- package/dist/esm/models/mark-bid-failed-request-dto.d.ts +1 -1
- package/dist/esm/models/mark-bid-failed-request-dto.js +1 -1
- package/dist/esm/models/mark-bid-failed201-response.d.ts +1 -1
- package/dist/esm/models/mark-bid-failed201-response.js +1 -1
- package/dist/esm/models/negotiation-score-dto.d.ts +1 -1
- package/dist/esm/models/negotiation-score-dto.js +1 -1
- package/dist/esm/models/negotiation-scored-v2-response-dto.d.ts +1 -1
- package/dist/esm/models/negotiation-scored-v2-response-dto.js +1 -1
- package/dist/esm/models/oauth-error-response-dto.d.ts +1 -1
- package/dist/esm/models/oauth-error-response-dto.js +1 -1
- package/dist/esm/models/payment-method-public.d.ts +1 -1
- package/dist/esm/models/payment-method-public.js +1 -1
- package/dist/esm/models/preconditions-dto.d.ts +1 -1
- package/dist/esm/models/preconditions-dto.js +1 -1
- package/dist/esm/models/problem-details-dto.d.ts +1 -1
- package/dist/esm/models/problem-details-dto.js +1 -1
- package/dist/esm/models/product-receipt-response-dto.d.ts +1 -1
- package/dist/esm/models/product-receipt-response-dto.js +1 -1
- package/dist/esm/models/product-response-dto.d.ts +1 -1
- package/dist/esm/models/product-response-dto.js +1 -1
- package/dist/esm/models/protected-resource-metadata-dto.d.ts +1 -1
- package/dist/esm/models/protected-resource-metadata-dto.js +1 -1
- package/dist/esm/models/register-award-request-dto.d.ts +1 -1
- package/dist/esm/models/register-award-request-dto.js +1 -1
- package/dist/esm/models/register-award201-response.d.ts +1 -1
- package/dist/esm/models/register-award201-response.js +1 -1
- package/dist/esm/models/register-bid201-response.d.ts +1 -1
- package/dist/esm/models/register-bid201-response.js +1 -1
- package/dist/esm/models/register-semo-contract-request-dto.d.ts +1 -1
- package/dist/esm/models/register-semo-contract-request-dto.js +1 -1
- package/dist/esm/models/request-invoice-split-request-dto.d.ts +1 -1
- package/dist/esm/models/request-invoice-split-request-dto.js +1 -1
- package/dist/esm/models/request-invoice-split200-response.d.ts +1 -1
- package/dist/esm/models/request-invoice-split200-response.js +1 -1
- package/dist/esm/models/retiree-roster-input-dto.d.ts +1 -1
- package/dist/esm/models/retiree-roster-input-dto.js +1 -1
- package/dist/esm/models/retiree-roster-row-dto.d.ts +1 -1
- package/dist/esm/models/retiree-roster-row-dto.js +1 -1
- package/dist/esm/models/revert-award-request-dto.d.ts +1 -1
- package/dist/esm/models/revert-award-request-dto.js +1 -1
- package/dist/esm/models/revert-award200-response.d.ts +1 -1
- package/dist/esm/models/revert-award200-response.js +1 -1
- package/dist/esm/models/revoke-request-dto.d.ts +1 -1
- package/dist/esm/models/revoke-request-dto.js +1 -1
- package/dist/esm/models/semo-contract-registered-response-dto.d.ts +1 -1
- package/dist/esm/models/semo-contract-registered-response-dto.js +1 -1
- package/dist/esm/models/semo-contract-taxinvoice-status-response-dto.d.ts +1 -1
- package/dist/esm/models/semo-contract-taxinvoice-status-response-dto.js +1 -1
- package/dist/esm/models/statement-document-dto.d.ts +1 -1
- package/dist/esm/models/statement-document-dto.js +1 -1
- package/dist/esm/models/statement-product-dto.d.ts +1 -1
- package/dist/esm/models/statement-product-dto.js +1 -1
- package/dist/esm/models/submit-negotiation-scores-request-dto.d.ts +1 -1
- package/dist/esm/models/submit-negotiation-scores-request-dto.js +1 -1
- package/dist/esm/models/submit-negotiation-scores201-response.d.ts +1 -1
- package/dist/esm/models/submit-negotiation-scores201-response.js +1 -1
- package/dist/esm/models/supplier-card-payable-response-dto.d.ts +1 -1
- package/dist/esm/models/supplier-card-payable-response-dto.js +1 -1
- package/dist/esm/models/supplier-tax-type.d.ts +1 -1
- package/dist/esm/models/supplier-tax-type.js +1 -1
- package/dist/esm/models/token-request-dto.d.ts +1 -1
- package/dist/esm/models/token-request-dto.js +1 -1
- package/dist/esm/models/token-response-dto.d.ts +1 -1
- package/dist/esm/models/token-response-dto.js +1 -1
- package/dist/esm/models/update-bid-request-dto.d.ts +1 -1
- package/dist/esm/models/update-bid-request-dto.js +1 -1
- package/dist/esm/models/update-bid200-response.d.ts +1 -1
- package/dist/esm/models/update-bid200-response.js +1 -1
- package/dist/esm/models/upload-file-request-dto.d.ts +1 -1
- package/dist/esm/models/upload-file-request-dto.js +1 -1
- package/dist/esm/models/upload-file201-response.d.ts +1 -1
- package/dist/esm/models/upload-file201-response.js +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js +1 -1
- package/dist/models/acceptance-result-response-dto.d.ts +1 -1
- package/dist/models/acceptance-result-response-dto.js +1 -1
- package/dist/models/acknowledge-product-receipt200-response.d.ts +1 -1
- package/dist/models/acknowledge-product-receipt200-response.js +1 -1
- package/dist/models/acknowledge-products-request-dto.d.ts +1 -1
- package/dist/models/acknowledge-products-request-dto.js +1 -1
- package/dist/models/api-catalog-dto.d.ts +1 -1
- package/dist/models/api-catalog-dto.js +1 -1
- package/dist/models/api-catalog-entry-dto.d.ts +1 -1
- package/dist/models/api-catalog-entry-dto.js +1 -1
- package/dist/models/api-catalog-link-dto.d.ts +1 -1
- package/dist/models/api-catalog-link-dto.js +1 -1
- package/dist/models/authorization-server-metadata-dto.d.ts +1 -1
- package/dist/models/authorization-server-metadata-dto.js +1 -1
- package/dist/models/award-method-public.d.ts +1 -1
- package/dist/models/award-method-public.js +1 -1
- package/dist/models/award-registered-v2-response-dto.d.ts +1 -1
- package/dist/models/award-registered-v2-response-dto.js +1 -1
- package/dist/models/award-reverted-v2-response-dto.d.ts +1 -1
- package/dist/models/award-reverted-v2-response-dto.js +1 -1
- package/dist/models/bid-acceptance-dto.d.ts +1 -1
- package/dist/models/bid-acceptance-dto.js +1 -1
- package/dist/models/bid-bond-dto.d.ts +1 -1
- package/dist/models/bid-bond-dto.js +1 -1
- package/dist/models/bid-cancelled-response-dto.d.ts +1 -1
- package/dist/models/bid-cancelled-response-dto.js +1 -1
- package/dist/models/bid-contact-dto.d.ts +1 -1
- package/dist/models/bid-contact-dto.js +1 -1
- package/dist/models/bid-contacts-dto.d.ts +1 -1
- package/dist/models/bid-contacts-dto.js +1 -1
- package/dist/models/bid-contract-document-dto.d.ts +1 -1
- package/dist/models/bid-contract-document-dto.js +1 -1
- package/dist/models/bid-delivery-terms-dto.d.ts +1 -1
- package/dist/models/bid-delivery-terms-dto.js +1 -1
- package/dist/models/bid-detail-response-dto.d.ts +1 -1
- package/dist/models/bid-detail-response-dto.js +1 -1
- package/dist/models/bid-document-dto.d.ts +1 -1
- package/dist/models/bid-document-dto.js +1 -1
- package/dist/models/bid-failed-v2-response-dto.d.ts +1 -1
- package/dist/models/bid-failed-v2-response-dto.js +1 -1
- package/dist/models/bid-item-dto.d.ts +1 -1
- package/dist/models/bid-item-dto.js +1 -1
- package/dist/models/bid-lifecycle-dto.d.ts +1 -1
- package/dist/models/bid-lifecycle-dto.js +1 -1
- package/dist/models/bid-manager-dto.d.ts +1 -1
- package/dist/models/bid-manager-dto.js +1 -1
- package/dist/models/bid-payment-terms-dto.d.ts +1 -1
- package/dist/models/bid-payment-terms-dto.js +1 -1
- package/dist/models/bid-product-dto.d.ts +1 -1
- package/dist/models/bid-product-dto.js +1 -1
- package/dist/models/bid-public-status.d.ts +1 -1
- package/dist/models/bid-public-status.js +1 -1
- package/dist/models/bid-registered-response-dto.d.ts +1 -1
- package/dist/models/bid-registered-response-dto.js +1 -1
- package/dist/models/bid-result-participant-attachment-dto.d.ts +1 -1
- package/dist/models/bid-result-participant-attachment-dto.js +1 -1
- package/dist/models/bid-result-participant-dto.d.ts +1 -1
- package/dist/models/bid-result-participant-dto.js +1 -1
- package/dist/models/bid-results-response-dto.d.ts +1 -1
- package/dist/models/bid-results-response-dto.js +1 -1
- package/dist/models/bid-settlement-line-item-dto.d.ts +1 -1
- package/dist/models/bid-settlement-line-item-dto.js +1 -1
- package/dist/models/bid-settlement-participant-dto.d.ts +1 -1
- package/dist/models/bid-settlement-participant-dto.js +1 -1
- package/dist/models/bid-settlement-response-dto.d.ts +1 -1
- package/dist/models/bid-settlement-response-dto.js +1 -1
- package/dist/models/bid-statement-response-dto.d.ts +1 -1
- package/dist/models/bid-statement-response-dto.js +1 -1
- package/dist/models/bid-summary-dto.d.ts +1 -1
- package/dist/models/bid-summary-dto.js +1 -1
- package/dist/models/bid-type-public.d.ts +1 -1
- package/dist/models/bid-type-public.js +1 -1
- package/dist/models/bid-updated-response-dto.d.ts +1 -1
- package/dist/models/bid-updated-response-dto.js +1 -1
- package/dist/models/cancel-bid-request-dto.d.ts +1 -1
- package/dist/models/cancel-bid-request-dto.js +1 -1
- package/dist/models/cancel-bid200-response.d.ts +1 -1
- package/dist/models/cancel-bid200-response.js +1 -1
- package/dist/models/card-payment-request-response-dto.d.ts +1 -1
- package/dist/models/card-payment-request-response-dto.js +1 -1
- package/dist/models/complete-acceptance-request-dto.d.ts +1 -1
- package/dist/models/complete-acceptance-request-dto.js +1 -1
- package/dist/models/complete-acceptance200-response.d.ts +1 -1
- package/dist/models/complete-acceptance200-response.js +1 -1
- package/dist/models/complete-invoice200-response.d.ts +1 -1
- package/dist/models/complete-invoice200-response.js +1 -1
- package/dist/models/contract-restriction-confirm-input-dto.d.ts +1 -1
- package/dist/models/contract-restriction-confirm-input-dto.js +1 -1
- package/dist/models/create-bid-request-dto.d.ts +1 -1
- package/dist/models/create-bid-request-dto.js +1 -1
- package/dist/models/create-card-payment-dto.d.ts +1 -1
- package/dist/models/create-card-payment-dto.js +1 -1
- package/dist/models/create-card-payment-request-dto.d.ts +1 -1
- package/dist/models/create-card-payment-request-dto.js +1 -1
- package/dist/models/create-card-payment200-response.d.ts +1 -1
- package/dist/models/create-card-payment200-response.js +1 -1
- package/dist/models/create-external-contract-documents-request-dto.d.ts +1 -1
- package/dist/models/create-external-contract-documents-request-dto.js +1 -1
- package/dist/models/create-external-contract-documents-response-dto.d.ts +1 -1
- package/dist/models/create-external-contract-documents-response-dto.js +1 -1
- package/dist/models/delivery-date-type-public.d.ts +1 -1
- package/dist/models/delivery-date-type-public.js +1 -1
- package/dist/models/delivery-method-public.d.ts +1 -1
- package/dist/models/delivery-method-public.js +1 -1
- package/dist/models/excellent-procurement-public.d.ts +1 -1
- package/dist/models/excellent-procurement-public.js +1 -1
- package/dist/models/external-contract-document-item-dto.d.ts +1 -1
- package/dist/models/external-contract-document-item-dto.js +1 -1
- package/dist/models/external-contract-documents-response-dto.d.ts +1 -1
- package/dist/models/external-contract-documents-response-dto.js +1 -1
- package/dist/models/external-contract-item-dto.d.ts +1 -1
- package/dist/models/external-contract-item-dto.js +1 -1
- package/dist/models/external-contract-snapshot-dto.d.ts +1 -1
- package/dist/models/external-contract-snapshot-dto.js +1 -1
- package/dist/models/external-document-inputs-dto.d.ts +1 -1
- package/dist/models/external-document-inputs-dto.js +1 -1
- package/dist/models/file-meta-response-dto.d.ts +1 -1
- package/dist/models/file-meta-response-dto.js +1 -1
- package/dist/models/file-uploaded-response-dto.d.ts +1 -1
- package/dist/models/file-uploaded-response-dto.js +1 -1
- package/dist/models/generated-external-contract-document-dto.d.ts +1 -1
- package/dist/models/generated-external-contract-document-dto.js +1 -1
- package/dist/models/get-bid-settlement200-response.d.ts +1 -1
- package/dist/models/get-bid-settlement200-response.js +1 -1
- package/dist/models/get-bid-statement200-response.d.ts +1 -1
- package/dist/models/get-bid-statement200-response.js +1 -1
- package/dist/models/get-bid200-response.d.ts +1 -1
- package/dist/models/get-bid200-response.js +1 -1
- package/dist/models/get-file-meta200-response.d.ts +1 -1
- package/dist/models/get-file-meta200-response.js +1 -1
- package/dist/models/get-supplier-card-payable-v2200-response.d.ts +1 -1
- package/dist/models/get-supplier-card-payable-v2200-response.js +1 -1
- package/dist/models/green-product-public.d.ts +1 -1
- package/dist/models/green-product-public.js +1 -1
- package/dist/models/health-controller-check200-response.d.ts +1 -1
- package/dist/models/health-controller-check200-response.js +1 -1
- package/dist/models/health-response-dto.d.ts +1 -1
- package/dist/models/health-response-dto.js +1 -1
- package/dist/models/hierarchical-region-dto.d.ts +1 -1
- package/dist/models/hierarchical-region-dto.js +1 -1
- package/dist/models/introspect-request-dto.d.ts +1 -1
- package/dist/models/introspect-request-dto.js +1 -1
- package/dist/models/introspection-response-dto.d.ts +1 -1
- package/dist/models/introspection-response-dto.js +1 -1
- package/dist/models/invalid-param-dto.d.ts +1 -1
- package/dist/models/invalid-param-dto.js +1 -1
- package/dist/models/invoice-completed-response-dto.d.ts +1 -1
- package/dist/models/invoice-completed-response-dto.js +1 -1
- package/dist/models/invoice-split-response-dto.d.ts +1 -1
- package/dist/models/invoice-split-response-dto.js +1 -1
- package/dist/models/legal-mandatory-public.d.ts +1 -1
- package/dist/models/legal-mandatory-public.js +1 -1
- package/dist/models/list-bid-results200-response.d.ts +1 -1
- package/dist/models/list-bid-results200-response.js +1 -1
- package/dist/models/list-bids-response-dto.d.ts +1 -1
- package/dist/models/list-bids-response-dto.js +1 -1
- package/dist/models/list-bids200-response.d.ts +1 -1
- package/dist/models/list-bids200-response.js +1 -1
- package/dist/models/list-products200-response.d.ts +1 -1
- package/dist/models/list-products200-response.js +1 -1
- package/dist/models/mark-bid-failed-request-dto.d.ts +1 -1
- package/dist/models/mark-bid-failed-request-dto.js +1 -1
- package/dist/models/mark-bid-failed201-response.d.ts +1 -1
- package/dist/models/mark-bid-failed201-response.js +1 -1
- package/dist/models/negotiation-score-dto.d.ts +1 -1
- package/dist/models/negotiation-score-dto.js +1 -1
- package/dist/models/negotiation-scored-v2-response-dto.d.ts +1 -1
- package/dist/models/negotiation-scored-v2-response-dto.js +1 -1
- package/dist/models/oauth-error-response-dto.d.ts +1 -1
- package/dist/models/oauth-error-response-dto.js +1 -1
- package/dist/models/payment-method-public.d.ts +1 -1
- package/dist/models/payment-method-public.js +1 -1
- package/dist/models/preconditions-dto.d.ts +1 -1
- package/dist/models/preconditions-dto.js +1 -1
- package/dist/models/problem-details-dto.d.ts +1 -1
- package/dist/models/problem-details-dto.js +1 -1
- package/dist/models/product-receipt-response-dto.d.ts +1 -1
- package/dist/models/product-receipt-response-dto.js +1 -1
- package/dist/models/product-response-dto.d.ts +1 -1
- package/dist/models/product-response-dto.js +1 -1
- package/dist/models/protected-resource-metadata-dto.d.ts +1 -1
- package/dist/models/protected-resource-metadata-dto.js +1 -1
- package/dist/models/register-award-request-dto.d.ts +1 -1
- package/dist/models/register-award-request-dto.js +1 -1
- package/dist/models/register-award201-response.d.ts +1 -1
- package/dist/models/register-award201-response.js +1 -1
- package/dist/models/register-bid201-response.d.ts +1 -1
- package/dist/models/register-bid201-response.js +1 -1
- package/dist/models/register-semo-contract-request-dto.d.ts +1 -1
- package/dist/models/register-semo-contract-request-dto.js +1 -1
- package/dist/models/request-invoice-split-request-dto.d.ts +1 -1
- package/dist/models/request-invoice-split-request-dto.js +1 -1
- package/dist/models/request-invoice-split200-response.d.ts +1 -1
- package/dist/models/request-invoice-split200-response.js +1 -1
- package/dist/models/retiree-roster-input-dto.d.ts +1 -1
- package/dist/models/retiree-roster-input-dto.js +1 -1
- package/dist/models/retiree-roster-row-dto.d.ts +1 -1
- package/dist/models/retiree-roster-row-dto.js +1 -1
- package/dist/models/revert-award-request-dto.d.ts +1 -1
- package/dist/models/revert-award-request-dto.js +1 -1
- package/dist/models/revert-award200-response.d.ts +1 -1
- package/dist/models/revert-award200-response.js +1 -1
- package/dist/models/revoke-request-dto.d.ts +1 -1
- package/dist/models/revoke-request-dto.js +1 -1
- package/dist/models/semo-contract-registered-response-dto.d.ts +1 -1
- package/dist/models/semo-contract-registered-response-dto.js +1 -1
- package/dist/models/semo-contract-taxinvoice-status-response-dto.d.ts +1 -1
- package/dist/models/semo-contract-taxinvoice-status-response-dto.js +1 -1
- package/dist/models/statement-document-dto.d.ts +1 -1
- package/dist/models/statement-document-dto.js +1 -1
- package/dist/models/statement-product-dto.d.ts +1 -1
- package/dist/models/statement-product-dto.js +1 -1
- package/dist/models/submit-negotiation-scores-request-dto.d.ts +1 -1
- package/dist/models/submit-negotiation-scores-request-dto.js +1 -1
- package/dist/models/submit-negotiation-scores201-response.d.ts +1 -1
- package/dist/models/submit-negotiation-scores201-response.js +1 -1
- package/dist/models/supplier-card-payable-response-dto.d.ts +1 -1
- package/dist/models/supplier-card-payable-response-dto.js +1 -1
- package/dist/models/supplier-tax-type.d.ts +1 -1
- package/dist/models/supplier-tax-type.js +1 -1
- package/dist/models/token-request-dto.d.ts +1 -1
- package/dist/models/token-request-dto.js +1 -1
- package/dist/models/token-response-dto.d.ts +1 -1
- package/dist/models/token-response-dto.js +1 -1
- package/dist/models/update-bid-request-dto.d.ts +1 -1
- package/dist/models/update-bid-request-dto.js +1 -1
- package/dist/models/update-bid200-response.d.ts +1 -1
- package/dist/models/update-bid200-response.js +1 -1
- package/dist/models/upload-file-request-dto.d.ts +1 -1
- package/dist/models/upload-file-request-dto.js +1 -1
- package/dist/models/upload-file201-response.d.ts +1 -1
- package/dist/models/upload-file201-response.js +1 -1
- package/docs/PartnerApiApi.md +30 -33
- package/docs/ProductsApi.md +2 -2
- package/index.ts +1 -1
- package/models/acceptance-result-response-dto.ts +1 -1
- package/models/acknowledge-product-receipt200-response.ts +1 -1
- package/models/acknowledge-products-request-dto.ts +1 -1
- package/models/api-catalog-dto.ts +1 -1
- package/models/api-catalog-entry-dto.ts +1 -1
- package/models/api-catalog-link-dto.ts +1 -1
- package/models/authorization-server-metadata-dto.ts +1 -1
- package/models/award-method-public.ts +1 -1
- package/models/award-registered-v2-response-dto.ts +1 -1
- package/models/award-reverted-v2-response-dto.ts +1 -1
- package/models/bid-acceptance-dto.ts +1 -1
- package/models/bid-bond-dto.ts +1 -1
- package/models/bid-cancelled-response-dto.ts +1 -1
- package/models/bid-contact-dto.ts +1 -1
- package/models/bid-contacts-dto.ts +1 -1
- package/models/bid-contract-document-dto.ts +1 -1
- package/models/bid-delivery-terms-dto.ts +1 -1
- package/models/bid-detail-response-dto.ts +1 -1
- package/models/bid-document-dto.ts +1 -1
- package/models/bid-failed-v2-response-dto.ts +1 -1
- package/models/bid-item-dto.ts +1 -1
- package/models/bid-lifecycle-dto.ts +1 -1
- package/models/bid-manager-dto.ts +1 -1
- package/models/bid-payment-terms-dto.ts +1 -1
- package/models/bid-product-dto.ts +1 -1
- package/models/bid-public-status.ts +1 -1
- package/models/bid-registered-response-dto.ts +1 -1
- package/models/bid-result-participant-attachment-dto.ts +1 -1
- package/models/bid-result-participant-dto.ts +1 -1
- package/models/bid-results-response-dto.ts +1 -1
- package/models/bid-settlement-line-item-dto.ts +1 -1
- package/models/bid-settlement-participant-dto.ts +1 -1
- package/models/bid-settlement-response-dto.ts +1 -1
- package/models/bid-statement-response-dto.ts +1 -1
- package/models/bid-summary-dto.ts +1 -1
- package/models/bid-type-public.ts +1 -1
- package/models/bid-updated-response-dto.ts +1 -1
- package/models/cancel-bid-request-dto.ts +1 -1
- package/models/cancel-bid200-response.ts +1 -1
- package/models/card-payment-request-response-dto.ts +1 -1
- package/models/complete-acceptance-request-dto.ts +1 -1
- package/models/complete-acceptance200-response.ts +1 -1
- package/models/complete-invoice200-response.ts +1 -1
- package/models/contract-restriction-confirm-input-dto.ts +1 -1
- package/models/create-bid-request-dto.ts +1 -1
- package/models/create-card-payment-dto.ts +1 -1
- package/models/create-card-payment-request-dto.ts +1 -1
- package/models/create-card-payment200-response.ts +1 -1
- package/models/create-external-contract-documents-request-dto.ts +1 -1
- package/models/create-external-contract-documents-response-dto.ts +1 -1
- package/models/delivery-date-type-public.ts +1 -1
- package/models/delivery-method-public.ts +1 -1
- package/models/excellent-procurement-public.ts +1 -1
- package/models/external-contract-document-item-dto.ts +1 -1
- package/models/external-contract-documents-response-dto.ts +1 -1
- package/models/external-contract-item-dto.ts +1 -1
- package/models/external-contract-snapshot-dto.ts +1 -1
- package/models/external-document-inputs-dto.ts +1 -1
- package/models/file-meta-response-dto.ts +1 -1
- package/models/file-uploaded-response-dto.ts +1 -1
- package/models/generated-external-contract-document-dto.ts +1 -1
- package/models/get-bid-settlement200-response.ts +1 -1
- package/models/get-bid-statement200-response.ts +1 -1
- package/models/get-bid200-response.ts +1 -1
- package/models/get-file-meta200-response.ts +1 -1
- package/models/get-supplier-card-payable-v2200-response.ts +1 -1
- package/models/green-product-public.ts +1 -1
- package/models/health-controller-check200-response.ts +1 -1
- package/models/health-response-dto.ts +1 -1
- package/models/hierarchical-region-dto.ts +1 -1
- package/models/introspect-request-dto.ts +1 -1
- package/models/introspection-response-dto.ts +1 -1
- package/models/invalid-param-dto.ts +1 -1
- package/models/invoice-completed-response-dto.ts +1 -1
- package/models/invoice-split-response-dto.ts +1 -1
- package/models/legal-mandatory-public.ts +1 -1
- package/models/list-bid-results200-response.ts +1 -1
- package/models/list-bids-response-dto.ts +1 -1
- package/models/list-bids200-response.ts +1 -1
- package/models/list-products200-response.ts +1 -1
- package/models/mark-bid-failed-request-dto.ts +1 -1
- package/models/mark-bid-failed201-response.ts +1 -1
- package/models/negotiation-score-dto.ts +1 -1
- package/models/negotiation-scored-v2-response-dto.ts +1 -1
- package/models/oauth-error-response-dto.ts +1 -1
- package/models/payment-method-public.ts +1 -1
- package/models/preconditions-dto.ts +1 -1
- package/models/problem-details-dto.ts +1 -1
- package/models/product-receipt-response-dto.ts +1 -1
- package/models/product-response-dto.ts +1 -1
- package/models/protected-resource-metadata-dto.ts +1 -1
- package/models/register-award-request-dto.ts +1 -1
- package/models/register-award201-response.ts +1 -1
- package/models/register-bid201-response.ts +1 -1
- package/models/register-semo-contract-request-dto.ts +1 -1
- package/models/request-invoice-split-request-dto.ts +1 -1
- package/models/request-invoice-split200-response.ts +1 -1
- package/models/retiree-roster-input-dto.ts +1 -1
- package/models/retiree-roster-row-dto.ts +1 -1
- package/models/revert-award-request-dto.ts +1 -1
- package/models/revert-award200-response.ts +1 -1
- package/models/revoke-request-dto.ts +1 -1
- package/models/semo-contract-registered-response-dto.ts +1 -1
- package/models/semo-contract-taxinvoice-status-response-dto.ts +1 -1
- package/models/statement-document-dto.ts +1 -1
- package/models/statement-product-dto.ts +1 -1
- package/models/submit-negotiation-scores-request-dto.ts +1 -1
- package/models/submit-negotiation-scores201-response.ts +1 -1
- package/models/supplier-card-payable-response-dto.ts +1 -1
- package/models/supplier-tax-type.ts +1 -1
- package/models/token-request-dto.ts +1 -1
- package/models/token-response-dto.ts +1 -1
- package/models/update-bid-request-dto.ts +1 -1
- package/models/update-bid200-response.ts +1 -1
- package/models/upload-file-request-dto.ts +1 -1
- package/models/upload-file201-response.ts +1 -1
- package/package.json +1 -1
package/docs/PartnerApiApi.md
CHANGED
|
@@ -48,7 +48,7 @@ const configuration = new Configuration();
|
|
|
48
48
|
const apiInstance = new PartnerApiApi(configuration);
|
|
49
49
|
|
|
50
50
|
let bidRef: string; //λ°μ£ΌκΈ°κ΄ μ체 ꡬ맀λ²νΈ(κΆμ₯) λλ c-market κ³΅κ³ λ²νΈ. ꡬ맀λ²νΈλ ν€μ λ°μΈλ©λ λ°μ£Όμ² λ²μμμ μ΅μ λΌμ΄λ κ³΅κ³ λ‘ ν΄μλ©λλ€. (default to undefined)
|
|
51
|
-
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
51
|
+
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. (default to undefined)
|
|
52
52
|
let cancelBidRequestDto: CancelBidRequestDto; //
|
|
53
53
|
|
|
54
54
|
const { status, data } = await apiInstance.cancelBid(
|
|
@@ -64,7 +64,7 @@ const { status, data } = await apiInstance.cancelBid(
|
|
|
64
64
|
|------------- | ------------- | ------------- | -------------|
|
|
65
65
|
| **cancelBidRequestDto** | **CancelBidRequestDto**| | |
|
|
66
66
|
| **bidRef** | [**string**] | λ°μ£ΌκΈ°κ΄ μ체 ꡬ맀λ²νΈ(κΆμ₯) λλ c-market κ³΅κ³ λ²νΈ. ꡬ맀λ²νΈλ ν€μ λ°μΈλ©λ λ°μ£Όμ² λ²μμμ μ΅μ λΌμ΄λ κ³΅κ³ λ‘ ν΄μλ©λλ€. | defaults to undefined|
|
|
67
|
-
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
67
|
+
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. | defaults to undefined|
|
|
68
68
|
|
|
69
69
|
|
|
70
70
|
### Return type
|
|
@@ -115,7 +115,7 @@ const configuration = new Configuration();
|
|
|
115
115
|
const apiInstance = new PartnerApiApi(configuration);
|
|
116
116
|
|
|
117
117
|
let bidRef: string; //λ°μ£ΌκΈ°κ΄ μ체 ꡬ맀λ²νΈ(κΆμ₯) λλ c-market κ³΅κ³ λ²νΈ. ꡬ맀λ²νΈλ ν€μ λ°μΈλ©λ λ°μ£Όμ² λ²μμμ μ΅μ λΌμ΄λ κ³΅κ³ λ‘ ν΄μλ©λλ€. (default to undefined)
|
|
118
|
-
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
118
|
+
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. (default to undefined)
|
|
119
119
|
let completeAcceptanceRequestDto: CompleteAcceptanceRequestDto; //
|
|
120
120
|
|
|
121
121
|
const { status, data } = await apiInstance.completeAcceptance(
|
|
@@ -131,7 +131,7 @@ const { status, data } = await apiInstance.completeAcceptance(
|
|
|
131
131
|
|------------- | ------------- | ------------- | -------------|
|
|
132
132
|
| **completeAcceptanceRequestDto** | **CompleteAcceptanceRequestDto**| | |
|
|
133
133
|
| **bidRef** | [**string**] | λ°μ£ΌκΈ°κ΄ μ체 ꡬ맀λ²νΈ(κΆμ₯) λλ c-market κ³΅κ³ λ²νΈ. ꡬ맀λ²νΈλ ν€μ λ°μΈλ©λ λ°μ£Όμ² λ²μμμ μ΅μ λΌμ΄λ κ³΅κ³ λ‘ ν΄μλ©λλ€. | defaults to undefined|
|
|
134
|
-
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
134
|
+
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. | defaults to undefined|
|
|
135
135
|
|
|
136
136
|
|
|
137
137
|
### Return type
|
|
@@ -181,7 +181,7 @@ const configuration = new Configuration();
|
|
|
181
181
|
const apiInstance = new PartnerApiApi(configuration);
|
|
182
182
|
|
|
183
183
|
let bidRef: string; //λ°μ£ΌκΈ°κ΄ μ체 ꡬ맀λ²νΈ(κΆμ₯) λλ c-market κ³΅κ³ λ²νΈ. ꡬ맀λ²νΈλ ν€μ λ°μΈλ©λ λ°μ£Όμ² λ²μμμ μ΅μ λΌμ΄λ κ³΅κ³ λ‘ ν΄μλ©λλ€. (default to undefined)
|
|
184
|
-
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
184
|
+
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. (default to undefined)
|
|
185
185
|
|
|
186
186
|
const { status, data } = await apiInstance.completeInvoice(
|
|
187
187
|
bidRef,
|
|
@@ -194,7 +194,7 @@ const { status, data } = await apiInstance.completeInvoice(
|
|
|
194
194
|
|Name | Type | Description | Notes|
|
|
195
195
|
|------------- | ------------- | ------------- | -------------|
|
|
196
196
|
| **bidRef** | [**string**] | λ°μ£ΌκΈ°κ΄ μ체 ꡬ맀λ²νΈ(κΆμ₯) λλ c-market κ³΅κ³ λ²νΈ. ꡬ맀λ²νΈλ ν€μ λ°μΈλ©λ λ°μ£Όμ² λ²μμμ μ΅μ λΌμ΄λ κ³΅κ³ λ‘ ν΄μλ©λλ€. | defaults to undefined|
|
|
197
|
-
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
197
|
+
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. | defaults to undefined|
|
|
198
198
|
|
|
199
199
|
|
|
200
200
|
### Return type
|
|
@@ -244,7 +244,7 @@ import {
|
|
|
244
244
|
const configuration = new Configuration();
|
|
245
245
|
const apiInstance = new PartnerApiApi(configuration);
|
|
246
246
|
|
|
247
|
-
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
247
|
+
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. (default to undefined)
|
|
248
248
|
let createCardPaymentDto: CreateCardPaymentDto; //
|
|
249
249
|
|
|
250
250
|
const { status, data } = await apiInstance.createCardPayment(
|
|
@@ -258,7 +258,7 @@ const { status, data } = await apiInstance.createCardPayment(
|
|
|
258
258
|
|Name | Type | Description | Notes|
|
|
259
259
|
|------------- | ------------- | ------------- | -------------|
|
|
260
260
|
| **createCardPaymentDto** | **CreateCardPaymentDto**| | |
|
|
261
|
-
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
261
|
+
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. | defaults to undefined|
|
|
262
262
|
|
|
263
263
|
|
|
264
264
|
### Return type
|
|
@@ -308,7 +308,7 @@ import {
|
|
|
308
308
|
const configuration = new Configuration();
|
|
309
309
|
const apiInstance = new PartnerApiApi(configuration);
|
|
310
310
|
|
|
311
|
-
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
311
|
+
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. (default to undefined)
|
|
312
312
|
let createExternalContractDocumentsRequestDto: CreateExternalContractDocumentsRequestDto; //
|
|
313
313
|
|
|
314
314
|
const { status, data } = await apiInstance.createExternalContractDocuments(
|
|
@@ -322,7 +322,7 @@ const { status, data } = await apiInstance.createExternalContractDocuments(
|
|
|
322
322
|
|Name | Type | Description | Notes|
|
|
323
323
|
|------------- | ------------- | ------------- | -------------|
|
|
324
324
|
| **createExternalContractDocumentsRequestDto** | **CreateExternalContractDocumentsRequestDto**| | |
|
|
325
|
-
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
325
|
+
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. | defaults to undefined|
|
|
326
326
|
|
|
327
327
|
|
|
328
328
|
### Return type
|
|
@@ -1003,7 +1003,7 @@ const configuration = new Configuration();
|
|
|
1003
1003
|
const apiInstance = new PartnerApiApi(configuration);
|
|
1004
1004
|
|
|
1005
1005
|
let bidRef: string; //λ°μ£ΌκΈ°κ΄ μ체 ꡬ맀λ²νΈ(κΆμ₯) λλ c-market κ³΅κ³ λ²νΈ. ꡬ맀λ²νΈλ ν€μ λ°μΈλ©λ λ°μ£Όμ² λ²μμμ μ΅μ λΌμ΄λ κ³΅κ³ λ‘ ν΄μλ©λλ€. (default to undefined)
|
|
1006
|
-
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
1006
|
+
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. (default to undefined)
|
|
1007
1007
|
let markBidFailedRequestDto: MarkBidFailedRequestDto; //
|
|
1008
1008
|
|
|
1009
1009
|
const { status, data } = await apiInstance.markBidFailed(
|
|
@@ -1019,7 +1019,7 @@ const { status, data } = await apiInstance.markBidFailed(
|
|
|
1019
1019
|
|------------- | ------------- | ------------- | -------------|
|
|
1020
1020
|
| **markBidFailedRequestDto** | **MarkBidFailedRequestDto**| | |
|
|
1021
1021
|
| **bidRef** | [**string**] | λ°μ£ΌκΈ°κ΄ μ체 ꡬ맀λ²νΈ(κΆμ₯) λλ c-market κ³΅κ³ λ²νΈ. ꡬ맀λ²νΈλ ν€μ λ°μΈλ©λ λ°μ£Όμ² λ²μμμ μ΅μ λΌμ΄λ κ³΅κ³ λ‘ ν΄μλ©λλ€. | defaults to undefined|
|
|
1022
|
-
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
1022
|
+
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. | defaults to undefined|
|
|
1023
1023
|
|
|
1024
1024
|
|
|
1025
1025
|
### Return type
|
|
@@ -1070,7 +1070,7 @@ const configuration = new Configuration();
|
|
|
1070
1070
|
const apiInstance = new PartnerApiApi(configuration);
|
|
1071
1071
|
|
|
1072
1072
|
let bidRef: string; //λ°μ£ΌκΈ°κ΄ μ체 ꡬ맀λ²νΈ(κΆμ₯) λλ c-market κ³΅κ³ λ²νΈ. ꡬ맀λ²νΈλ ν€μ λ°μΈλ©λ λ°μ£Όμ² λ²μμμ μ΅μ λΌμ΄λ κ³΅κ³ λ‘ ν΄μλ©λλ€. (default to undefined)
|
|
1073
|
-
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
1073
|
+
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. (default to undefined)
|
|
1074
1074
|
let registerAwardRequestDto: RegisterAwardRequestDto; //
|
|
1075
1075
|
|
|
1076
1076
|
const { status, data } = await apiInstance.registerAward(
|
|
@@ -1086,7 +1086,7 @@ const { status, data } = await apiInstance.registerAward(
|
|
|
1086
1086
|
|------------- | ------------- | ------------- | -------------|
|
|
1087
1087
|
| **registerAwardRequestDto** | **RegisterAwardRequestDto**| | |
|
|
1088
1088
|
| **bidRef** | [**string**] | λ°μ£ΌκΈ°κ΄ μ체 ꡬ맀λ²νΈ(κΆμ₯) λλ c-market κ³΅κ³ λ²νΈ. ꡬ맀λ²νΈλ ν€μ λ°μΈλ©λ λ°μ£Όμ² λ²μμμ μ΅μ λΌμ΄λ κ³΅κ³ λ‘ ν΄μλ©λλ€. | defaults to undefined|
|
|
1089
|
-
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
1089
|
+
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. | defaults to undefined|
|
|
1090
1090
|
|
|
1091
1091
|
|
|
1092
1092
|
### Return type
|
|
@@ -1136,7 +1136,7 @@ import {
|
|
|
1136
1136
|
const configuration = new Configuration();
|
|
1137
1137
|
const apiInstance = new PartnerApiApi(configuration);
|
|
1138
1138
|
|
|
1139
|
-
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
1139
|
+
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. (default to undefined)
|
|
1140
1140
|
let createBidRequestDto: CreateBidRequestDto; //
|
|
1141
1141
|
|
|
1142
1142
|
const { status, data } = await apiInstance.registerBid(
|
|
@@ -1150,7 +1150,7 @@ const { status, data } = await apiInstance.registerBid(
|
|
|
1150
1150
|
|Name | Type | Description | Notes|
|
|
1151
1151
|
|------------- | ------------- | ------------- | -------------|
|
|
1152
1152
|
| **createBidRequestDto** | **CreateBidRequestDto**| | |
|
|
1153
|
-
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
1153
|
+
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. | defaults to undefined|
|
|
1154
1154
|
|
|
1155
1155
|
|
|
1156
1156
|
### Return type
|
|
@@ -1200,7 +1200,7 @@ import {
|
|
|
1200
1200
|
const configuration = new Configuration();
|
|
1201
1201
|
const apiInstance = new PartnerApiApi(configuration);
|
|
1202
1202
|
|
|
1203
|
-
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
1203
|
+
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. (default to undefined)
|
|
1204
1204
|
let registerSemoContractRequestDto: RegisterSemoContractRequestDto; //
|
|
1205
1205
|
|
|
1206
1206
|
const { status, data } = await apiInstance.registerSemoContract(
|
|
@@ -1214,7 +1214,7 @@ const { status, data } = await apiInstance.registerSemoContract(
|
|
|
1214
1214
|
|Name | Type | Description | Notes|
|
|
1215
1215
|
|------------- | ------------- | ------------- | -------------|
|
|
1216
1216
|
| **registerSemoContractRequestDto** | **RegisterSemoContractRequestDto**| | |
|
|
1217
|
-
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
1217
|
+
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. | defaults to undefined|
|
|
1218
1218
|
|
|
1219
1219
|
|
|
1220
1220
|
### Return type
|
|
@@ -1265,7 +1265,7 @@ const configuration = new Configuration();
|
|
|
1265
1265
|
const apiInstance = new PartnerApiApi(configuration);
|
|
1266
1266
|
|
|
1267
1267
|
let bidRef: string; //λ°μ£ΌκΈ°κ΄ μ체 ꡬ맀λ²νΈ(κΆμ₯) λλ c-market κ³΅κ³ λ²νΈ. ꡬ맀λ²νΈλ ν€μ λ°μΈλ©λ λ°μ£Όμ² λ²μμμ μ΅μ λΌμ΄λ κ³΅κ³ λ‘ ν΄μλ©λλ€. (default to undefined)
|
|
1268
|
-
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
1268
|
+
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. (default to undefined)
|
|
1269
1269
|
let requestInvoiceSplitRequestDto: RequestInvoiceSplitRequestDto; //
|
|
1270
1270
|
|
|
1271
1271
|
const { status, data } = await apiInstance.requestInvoiceSplit(
|
|
@@ -1281,7 +1281,7 @@ const { status, data } = await apiInstance.requestInvoiceSplit(
|
|
|
1281
1281
|
|------------- | ------------- | ------------- | -------------|
|
|
1282
1282
|
| **requestInvoiceSplitRequestDto** | **RequestInvoiceSplitRequestDto**| | |
|
|
1283
1283
|
| **bidRef** | [**string**] | λ°μ£ΌκΈ°κ΄ μ체 ꡬ맀λ²νΈ(κΆμ₯) λλ c-market κ³΅κ³ λ²νΈ. ꡬ맀λ²νΈλ ν€μ λ°μΈλ©λ λ°μ£Όμ² λ²μμμ μ΅μ λΌμ΄λ κ³΅κ³ λ‘ ν΄μλ©λλ€. | defaults to undefined|
|
|
1284
|
-
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
1284
|
+
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. | defaults to undefined|
|
|
1285
1285
|
|
|
1286
1286
|
|
|
1287
1287
|
### Return type
|
|
@@ -1332,7 +1332,7 @@ const configuration = new Configuration();
|
|
|
1332
1332
|
const apiInstance = new PartnerApiApi(configuration);
|
|
1333
1333
|
|
|
1334
1334
|
let bidRef: string; //λ°μ£ΌκΈ°κ΄ μ체 ꡬ맀λ²νΈ(κΆμ₯) λλ c-market κ³΅κ³ λ²νΈ. ꡬ맀λ²νΈλ ν€μ λ°μΈλ©λ λ°μ£Όμ² λ²μμμ μ΅μ λΌμ΄λ κ³΅κ³ λ‘ ν΄μλ©λλ€. (default to undefined)
|
|
1335
|
-
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
1335
|
+
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. (default to undefined)
|
|
1336
1336
|
let revertAwardRequestDto: RevertAwardRequestDto; //
|
|
1337
1337
|
|
|
1338
1338
|
const { status, data } = await apiInstance.revertAward(
|
|
@@ -1348,7 +1348,7 @@ const { status, data } = await apiInstance.revertAward(
|
|
|
1348
1348
|
|------------- | ------------- | ------------- | -------------|
|
|
1349
1349
|
| **revertAwardRequestDto** | **RevertAwardRequestDto**| | |
|
|
1350
1350
|
| **bidRef** | [**string**] | λ°μ£ΌκΈ°κ΄ μ체 ꡬ맀λ²νΈ(κΆμ₯) λλ c-market κ³΅κ³ λ²νΈ. ꡬ맀λ²νΈλ ν€μ λ°μΈλ©λ λ°μ£Όμ² λ²μμμ μ΅μ λΌμ΄λ κ³΅κ³ λ‘ ν΄μλ©λλ€. | defaults to undefined|
|
|
1351
|
-
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
1351
|
+
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. | defaults to undefined|
|
|
1352
1352
|
|
|
1353
1353
|
|
|
1354
1354
|
### Return type
|
|
@@ -1399,7 +1399,7 @@ const configuration = new Configuration();
|
|
|
1399
1399
|
const apiInstance = new PartnerApiApi(configuration);
|
|
1400
1400
|
|
|
1401
1401
|
let bidRef: string; //λ°μ£ΌκΈ°κ΄ μ체 ꡬ맀λ²νΈ(κΆμ₯) λλ c-market κ³΅κ³ λ²νΈ. ꡬ맀λ²νΈλ ν€μ λ°μΈλ©λ λ°μ£Όμ² λ²μμμ μ΅μ λΌμ΄λ κ³΅κ³ λ‘ ν΄μλ©λλ€. (default to undefined)
|
|
1402
|
-
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
1402
|
+
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. (default to undefined)
|
|
1403
1403
|
let submitNegotiationScoresRequestDto: SubmitNegotiationScoresRequestDto; //
|
|
1404
1404
|
|
|
1405
1405
|
const { status, data } = await apiInstance.submitNegotiationScores(
|
|
@@ -1415,7 +1415,7 @@ const { status, data } = await apiInstance.submitNegotiationScores(
|
|
|
1415
1415
|
|------------- | ------------- | ------------- | -------------|
|
|
1416
1416
|
| **submitNegotiationScoresRequestDto** | **SubmitNegotiationScoresRequestDto**| | |
|
|
1417
1417
|
| **bidRef** | [**string**] | λ°μ£ΌκΈ°κ΄ μ체 ꡬ맀λ²νΈ(κΆμ₯) λλ c-market κ³΅κ³ λ²νΈ. ꡬ맀λ²νΈλ ν€μ λ°μΈλ©λ λ°μ£Όμ² λ²μμμ μ΅μ λΌμ΄λ κ³΅κ³ λ‘ ν΄μλ©λλ€. | defaults to undefined|
|
|
1418
|
-
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
1418
|
+
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. | defaults to undefined|
|
|
1419
1419
|
|
|
1420
1420
|
|
|
1421
1421
|
### Return type
|
|
@@ -1466,15 +1466,13 @@ const configuration = new Configuration();
|
|
|
1466
1466
|
const apiInstance = new PartnerApiApi(configuration);
|
|
1467
1467
|
|
|
1468
1468
|
let bidRef: string; //λ°μ£ΌκΈ°κ΄ μ체 ꡬ맀λ²νΈ(κΆμ₯) λλ c-market κ³΅κ³ λ²νΈ. ꡬ맀λ²νΈλ ν€μ λ°μΈλ©λ λ°μ£Όμ² λ²μμμ μ΅μ λΌμ΄λ κ³΅κ³ λ‘ ν΄μλ©λλ€. (default to undefined)
|
|
1469
|
-
let ifMatch: string;
|
|
1470
|
-
let
|
|
1471
|
-
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body λ‘ μ¬μ μ‘νλ©΄ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λ°μ΅λλ€. UUID v4 λ₯Ό κΆμ₯ν©λλ€. (default to undefined)
|
|
1469
|
+
let ifMatch: string; //μμ νλ €λ κ³΅κ³ μ ETag(νμ). μ§μ `GET /v2/bids/{bidRef}` μλ΅μ `ETag` ν€λ κ°μ κ·Έλλ‘ μ€μ΄ 보λ΄μΈμ. λλ½νλ©΄ 428, κ·Έ μ¬μ΄ κ³΅κ³ κ° λ°λμμΌλ©΄ 412 λ‘ κ±°μ λλ©° μ무κ²λ μμ λμ§ μμ΅λλ€. (default to undefined)
|
|
1470
|
+
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. (default to undefined)
|
|
1472
1471
|
let updateBidRequestDto: UpdateBidRequestDto; //
|
|
1473
1472
|
|
|
1474
1473
|
const { status, data } = await apiInstance.updateBid(
|
|
1475
1474
|
bidRef,
|
|
1476
1475
|
ifMatch,
|
|
1477
|
-
ifMatch2,
|
|
1478
1476
|
idempotencyKey,
|
|
1479
1477
|
updateBidRequestDto
|
|
1480
1478
|
);
|
|
@@ -1486,9 +1484,8 @@ const { status, data } = await apiInstance.updateBid(
|
|
|
1486
1484
|
|------------- | ------------- | ------------- | -------------|
|
|
1487
1485
|
| **updateBidRequestDto** | **UpdateBidRequestDto**| | |
|
|
1488
1486
|
| **bidRef** | [**string**] | λ°μ£ΌκΈ°κ΄ μ체 ꡬ맀λ²νΈ(κΆμ₯) λλ c-market κ³΅κ³ λ²νΈ. ꡬ맀λ²νΈλ ν€μ λ°μΈλ©λ λ°μ£Όμ² λ²μμμ μ΅μ λΌμ΄λ κ³΅κ³ λ‘ ν΄μλ©λλ€. | defaults to undefined|
|
|
1489
|
-
| **ifMatch** | [**string**] |
|
|
1490
|
-
| **
|
|
1491
|
-
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body λ‘ μ¬μ μ‘νλ©΄ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λ°μ΅λλ€. UUID v4 λ₯Ό κΆμ₯ν©λλ€. | defaults to undefined|
|
|
1487
|
+
| **ifMatch** | [**string**] | μμ νλ €λ κ³΅κ³ μ ETag(νμ). μ§μ `GET /v2/bids/{bidRef}` μλ΅μ `ETag` ν€λ κ°μ κ·Έλλ‘ μ€μ΄ 보λ΄μΈμ. λλ½νλ©΄ 428, κ·Έ μ¬μ΄ κ³΅κ³ κ° λ°λμμΌλ©΄ 412 λ‘ κ±°μ λλ©° μ무κ²λ μμ λμ§ μμ΅λλ€. | defaults to undefined|
|
|
1488
|
+
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. | defaults to undefined|
|
|
1492
1489
|
|
|
1493
1490
|
|
|
1494
1491
|
### Return type
|
|
@@ -1540,7 +1537,7 @@ import {
|
|
|
1540
1537
|
const configuration = new Configuration();
|
|
1541
1538
|
const apiInstance = new PartnerApiApi(configuration);
|
|
1542
1539
|
|
|
1543
|
-
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
1540
|
+
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. (default to undefined)
|
|
1544
1541
|
let uploadFileRequestDto: UploadFileRequestDto; //
|
|
1545
1542
|
|
|
1546
1543
|
const { status, data } = await apiInstance.uploadFile(
|
|
@@ -1554,7 +1551,7 @@ const { status, data } = await apiInstance.uploadFile(
|
|
|
1554
1551
|
|Name | Type | Description | Notes|
|
|
1555
1552
|
|------------- | ------------- | ------------- | -------------|
|
|
1556
1553
|
| **uploadFileRequestDto** | **UploadFileRequestDto**| | |
|
|
1557
|
-
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
1554
|
+
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. | defaults to undefined|
|
|
1558
1555
|
|
|
1559
1556
|
|
|
1560
1557
|
### Return type
|
package/docs/ProductsApi.md
CHANGED
|
@@ -24,7 +24,7 @@ import {
|
|
|
24
24
|
const configuration = new Configuration();
|
|
25
25
|
const apiInstance = new ProductsApi(configuration);
|
|
26
26
|
|
|
27
|
-
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
27
|
+
let idempotencyKey: string; //λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. (default to undefined)
|
|
28
28
|
let acknowledgeProductsRequestDto: AcknowledgeProductsRequestDto; //
|
|
29
29
|
|
|
30
30
|
const { status, data } = await apiInstance.acknowledgeProductReceipt(
|
|
@@ -38,7 +38,7 @@ const { status, data } = await apiInstance.acknowledgeProductReceipt(
|
|
|
38
38
|
|Name | Type | Description | Notes|
|
|
39
39
|
|------------- | ------------- | ------------- | -------------|
|
|
40
40
|
| **acknowledgeProductsRequestDto** | **AcknowledgeProductsRequestDto**| | |
|
|
41
|
-
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). κ°μ ν€ + κ°μ body
|
|
41
|
+
| **idempotencyKey** | [**string**] | λ©±λ±μ± ν€(1~255μ, `[A-Za-z0-9_-]`). **μ¬μλν λ μ²μκ³Ό κ°μ ν€λ₯Ό λ€μ 보λ΄μΌ** μ€λ³΅ μμ±μ΄ λ§νλλ€ β νμμμΒ·λ€νΈμν¬ μ€λ₯λ‘ λ€μ λΆλ₯΄λ©΄μ μ ν€λ₯Ό λ§λ€λ©΄ λ³κ° μμ²μΌλ‘ μ²λ¦¬λ©λλ€. κ·Έλμ ν€λ UUID v4 λ₯Ό λ§λ€μ΄ **μ°λ μμ€ν
μμ₯μ μ μ₯**νκ±°λ, μμ² λ΄μ©μμ κ²°μ μ μΌλ‘ νμ(μ: `bid-create-{ꡬ맀λ²νΈ}`)ν΄ μ¬μλκ° κ°μ κ°μ μ¬ννλλ‘ νμΈμ. κ°μ ν€ + κ°μ body λ 24μκ° λμ μΊμλ μλ΅μ κ·Έλλ‘ λλ €μ€λλ€. | defaults to undefined|
|
|
42
42
|
|
|
43
43
|
|
|
44
44
|
### Return type
|
package/index.ts
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
* CMARKET V6 Partner API
|
|
5
5
|
* μΈλΆ ERP μ°λμ© RESTful API. ## μΈμ¦ OAuth2 Bearer JWT (`client_credentials` νλ‘μ°). `/oauth/token` μμ ν ν°μ λ°κΈλ°μ `Authorization: Bearer <token>` ν€λλ‘ μ€μΌμΈμ. ## κΆν β λ κ°μ λ
립λ μΆ `403` μ λ§λ¬λ€λ©΄ λ μ€ μ΄λ μΆμ κ±Έλ¦° κ²μΈμ§ λ¨Όμ ꡬλΆνμΈμ. - **μ€μ½ν** = *무μμ ν μ μλ*. ν ν°μ λΆμ¬λ `bids:read`Β·`contracts:write` λ±μ
λλ€. 미보μ μ `β¦/insufficient-scope`. - **λν λ²μ** = *λꡬμ λ°μ΄ν°λ₯Ό λ€λ£° μ μλ*. API ν€ μ€μ μ΄λ©° μ€μ½νλ‘ ννλμ§ μμ΅λλ€. λ²μ λ°μ΄λ©΄ μ€μ½νμ 무κ΄νκ² 403 μ
λλ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λ©λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²νμΈμ. ## μ±κ³΅ μλ΅ λ΄ν¬ `/v2` μ λͺ¨λ 2xx λ³Έλ¬Έμ `{ \"data\": β¦ }` μ
λλ€. λ¨μΌ 리μμ€λ λͺ©λ‘μ΄λ κ°μ΅λλ€. λͺ©λ‘μ²λΌ λΆκ° μ λ³΄κ° μλ μλ΅μ `meta` κ° ν¨κ» μ€λ¦½λλ€ β μ: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"β¦\" } }`. λΆκ° μ λ³΄κ° μμΌλ©΄ `meta` ν€λ μμ λκ°μ§ μμ΅λλ€(λΉ κ°μ²΄λ₯Ό μ£μ§ μμ΅λλ€). λ΄ν¬λ₯Ό μ°μ§ μλ νλ©΄μ λμ
λλ€. `/oauth/_*` μ `/.well-known/_*` λ κ°κ° RFC 6749Β·RFC 8414Β·RFC 9728 μ΄ μ΅μμ νλλ₯Ό κ·μ νκ³ , νμΌ λ΄μ© μλ΅μ λ³Έλ¬Έμ΄ JSON μ΄ μλλλ€. μλ¬ μλ΅μλ λ΄ν¬λ₯Ό μμ°μ§ μμ΅λλ€ β μλ problem+json μ΄ λ¨λ
μΌλ‘ μ±
μμ§λλ€. ## μ‘°κ±΄λΆ μμ² (ETag) `/v2` μ λͺ¨λ `GET` μλ΅μ weak `ETag`(`W/\"β¦\"`)κ° μ€λ¦½λλ€. λ°μ κ°μ λ€μ μμ²μ `If-None-Match` ν€λλ‘ λ보λ΄λ©΄, λ΄μ©μ΄ κ·Έλλ‘μΌ λ `304 Not Modified` λ₯Ό λ³Έλ¬Έ μμ΄ λ°μ΅λλ€. κ²°κ³Όκ° λκΈ°λ₯Ό κΈ°λ€λ¦¬λ©° κ°μ μμμ λ°λ³΅ μ‘°ννλ μ°λμ΄λΌλ©΄ μ΄ ν€λ νλλ‘ μ μ‘λμ΄ μ¬λΌμ§λλ€. ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json` μ
λλ€. **HTTP status + `type` URI** λ‘ λΆκΈ°νμΈμ. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλνκ³ , `false`λ©΄ μμ²μ κ³ μ³μΌ ν©λλ€. - `traceId`: μμ² μΆμ id. `X-Correlation-Id` μλ΅ ν€λμ κ°μ κ°μ
λλ€ β λ¬Έμν λ μ΄ κ°μ 첨λΆνμΈμ. - `correlationId`: `traceId` μ κ°μ κ°μ μ μ΄λ¦. κΈ°μ‘΄ μ°λ νΈνμΌλ‘ ν¨κ» μ€λ¦½λλ€. μ μ°λμ `traceId` λ₯Ό μ½μΌμΈμ. - `invalid-params`: κ²μ¦ μ€ν¨(400 `β¦/validation-failed`) μ μλ° νλ κ²½λ‘ λͺ©λ‘(RFC 9457 νμ₯, κ° μμ). `type` μ `https://problems.cmarket.io/partner/<slug>` ννμ **μμ μλ³μ**μ
λλ€. RFC 9457 Β§3.1.1 μ΄ νμ©νλ λλ‘ μ΄ URI λ **μμ°Έμ‘°(dereference)λμ§ μμ΅λλ€** β λΈλΌμ°μ λ‘ μ΄μ§ λ§κ³ λ¬Έμμ΄ λΉκ΅λ‘λ§ μ°μΈμ. slug λͺ©λ‘κ³Ό μλ―Έλ κ° μλν¬μΈνΈμ μλ΅ μ€λͺ
μ status λ³λ‘ μ ν μμ΅λλ€. ### λ©±λ±μ± μλ°: 409 μ 422 μ μ°¨μ΄ - `409` `β¦/idempotency-key-conflict` β κ°μ ν€μ **μ μμ²μ΄ μμ§ μ²λ¦¬ μ€**μ
λλ€. μ μ λ€ κ°μ ν€λ‘ λ€μ λΆλ₯΄λ©΄ κ·Έ κ²°κ³Όλ₯Ό λ°μ΅λλ€. - `422` `β¦/idempotency-key-reused` β κ°μ ν€λ₯Ό **λ€λ₯Έ body** λ‘ λ³΄λμ΅λλ€. μ¬μλν΄λ μμν κ°μ μ€ν¨μ΄λ μ ν€λ₯Ό μ°κ±°λ body λ₯Ό λλ리μΈμ. ## Rate Limit μ μ **60 μμ²/λΆ per `client_id`**, ν ν° λ°κΈ(`/oauth/token`)μ **5 μμ²/λΆ** μ
λλ€. μ΄κ³Ό μ `429`(`type: β¦/too-many-requests`). μΏΌν°λ λ κ°μ§ νκΈ°λ‘ ν¨κ» λκ°λλ€ β μ κ· μ°λμ νμ€ νλλ₯Ό μ°μΈμ. - **νμ€**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (μ μ±
) Β· `RateLimit: \"default\";r=59;t=42` (μλ r, 리μ
κΉμ§ t μ΄) - **λ κ±°μ**(κ΄μ©): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. κΈ°μ‘΄ μ°λ νΈνμ μν΄ μ μ§ν©λλ€. `429` μμλ `Retry-After`(μ΄)κ° μ°μ ν©λλ€. λλ λκΈ°ν(νλͺ© λ¨μ λ°λ³΅ λ±λ‘ λ±)λ `Retry-After` λ§νΌ backoff ν μ¬μλνμΈμ. ## μΆμ μμ²μ `X-Correlation-Id` ν€λλ₯Ό μ€μΌλ©΄ κ·Έλλ‘ echo λκ³ , μμΌλ©΄ μλ²κ° λ°κΈν©λλ€. λͺ¨λ μλ΅(μ±κ³΅/μλ¬)μ `X-Correlation-Id` κ° μ€λ¦½λλ€. ## μ λ°©νΈν β λͺ¨λ₯΄λ νλμ κ°μμ κΉ¨μ§μ§ μκ² λ€μ μ
μ breaking λ³κ²½μΌλ‘ λ³΄μ§ μμΌλ©° minor 릴리μ€μμ μκ³ μμ΄ μΌμ΄λ©λλ€. μ΄ μ μ λ‘ κ΅¬ννμΈμ. - **μ ν νλ μΆκ°**: λͺ¨λ₯΄λ νλλ 무μνμΈμ. μ격 νμ(unknown key κ±°λΆ)λ₯Ό μ°μ§ λ§μΈμ. - **enum κ° μΆκ°**: μνΒ·λμ°°λ°©λ² λ±μ μ κ°μ΄ μκΉλλ€. λͺ¨λ₯΄λ κ°μ λ§λλ©΄ μμΈλ₯Ό λμ§μ§ λ§κ³ μλ¬Έ λ¬Έμμ΄μ 보쑴νμΈμ. - **problem `type` slug μΆκ°**: λͺ¨λ₯΄λ slug μ **HTTP status λ‘ ν΄λ°±**ν΄ λΆκΈ°νμΈμ. ## λ²μ μλͺ
(deprecation/sunset) - **_/v2** breaking λ³κ²½μ CHANGELOG SemVer(major bump)μ `Deprecation`/`Sunset` ν€λλ‘ ν΅μ§ν©λλ€. μ΄ ν€λλ₯Ό λͺ¨λν°λ§νμΈμ.
|
|
6
6
|
*
|
|
7
|
-
* The version of the OpenAPI document: 36.1.
|
|
7
|
+
* The version of the OpenAPI document: 36.1.1
|
|
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).
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
* CMARKET V6 Partner API
|
|
5
5
|
* μΈλΆ ERP μ°λμ© RESTful API. ## μΈμ¦ OAuth2 Bearer JWT (`client_credentials` νλ‘μ°). `/oauth/token` μμ ν ν°μ λ°κΈλ°μ `Authorization: Bearer <token>` ν€λλ‘ μ€μΌμΈμ. ## κΆν β λ κ°μ λ
립λ μΆ `403` μ λ§λ¬λ€λ©΄ λ μ€ μ΄λ μΆμ κ±Έλ¦° κ²μΈμ§ λ¨Όμ ꡬλΆνμΈμ. - **μ€μ½ν** = *무μμ ν μ μλ*. ν ν°μ λΆμ¬λ `bids:read`Β·`contracts:write` λ±μ
λλ€. 미보μ μ `β¦/insufficient-scope`. - **λν λ²μ** = *λꡬμ λ°μ΄ν°λ₯Ό λ€λ£° μ μλ*. API ν€ μ€μ μ΄λ©° μ€μ½νλ‘ ννλμ§ μμ΅λλ€. λ²μ λ°μ΄λ©΄ μ€μ½νμ 무κ΄νκ² 403 μ
λλ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λ©λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²νμΈμ. ## μ±κ³΅ μλ΅ λ΄ν¬ `/v2` μ λͺ¨λ 2xx λ³Έλ¬Έμ `{ \"data\": β¦ }` μ
λλ€. λ¨μΌ 리μμ€λ λͺ©λ‘μ΄λ κ°μ΅λλ€. λͺ©λ‘μ²λΌ λΆκ° μ λ³΄κ° μλ μλ΅μ `meta` κ° ν¨κ» μ€λ¦½λλ€ β μ: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"β¦\" } }`. λΆκ° μ λ³΄κ° μμΌλ©΄ `meta` ν€λ μμ λκ°μ§ μμ΅λλ€(λΉ κ°μ²΄λ₯Ό μ£μ§ μμ΅λλ€). λ΄ν¬λ₯Ό μ°μ§ μλ νλ©΄μ λμ
λλ€. `/oauth/_*` μ `/.well-known/_*` λ κ°κ° RFC 6749Β·RFC 8414Β·RFC 9728 μ΄ μ΅μμ νλλ₯Ό κ·μ νκ³ , νμΌ λ΄μ© μλ΅μ λ³Έλ¬Έμ΄ JSON μ΄ μλλλ€. μλ¬ μλ΅μλ λ΄ν¬λ₯Ό μμ°μ§ μμ΅λλ€ β μλ problem+json μ΄ λ¨λ
μΌλ‘ μ±
μμ§λλ€. ## μ‘°κ±΄λΆ μμ² (ETag) `/v2` μ λͺ¨λ `GET` μλ΅μ weak `ETag`(`W/\"β¦\"`)κ° μ€λ¦½λλ€. λ°μ κ°μ λ€μ μμ²μ `If-None-Match` ν€λλ‘ λ보λ΄λ©΄, λ΄μ©μ΄ κ·Έλλ‘μΌ λ `304 Not Modified` λ₯Ό λ³Έλ¬Έ μμ΄ λ°μ΅λλ€. κ²°κ³Όκ° λκΈ°λ₯Ό κΈ°λ€λ¦¬λ©° κ°μ μμμ λ°λ³΅ μ‘°ννλ μ°λμ΄λΌλ©΄ μ΄ ν€λ νλλ‘ μ μ‘λμ΄ μ¬λΌμ§λλ€. ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json` μ
λλ€. **HTTP status + `type` URI** λ‘ λΆκΈ°νμΈμ. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλνκ³ , `false`λ©΄ μμ²μ κ³ μ³μΌ ν©λλ€. - `traceId`: μμ² μΆμ id. `X-Correlation-Id` μλ΅ ν€λμ κ°μ κ°μ
λλ€ β λ¬Έμν λ μ΄ κ°μ 첨λΆνμΈμ. - `correlationId`: `traceId` μ κ°μ κ°μ μ μ΄λ¦. κΈ°μ‘΄ μ°λ νΈνμΌλ‘ ν¨κ» μ€λ¦½λλ€. μ μ°λμ `traceId` λ₯Ό μ½μΌμΈμ. - `invalid-params`: κ²μ¦ μ€ν¨(400 `β¦/validation-failed`) μ μλ° νλ κ²½λ‘ λͺ©λ‘(RFC 9457 νμ₯, κ° μμ). `type` μ `https://problems.cmarket.io/partner/<slug>` ννμ **μμ μλ³μ**μ
λλ€. RFC 9457 Β§3.1.1 μ΄ νμ©νλ λλ‘ μ΄ URI λ **μμ°Έμ‘°(dereference)λμ§ μμ΅λλ€** β λΈλΌμ°μ λ‘ μ΄μ§ λ§κ³ λ¬Έμμ΄ λΉκ΅λ‘λ§ μ°μΈμ. slug λͺ©λ‘κ³Ό μλ―Έλ κ° μλν¬μΈνΈμ μλ΅ μ€λͺ
μ status λ³λ‘ μ ν μμ΅λλ€. ### λ©±λ±μ± μλ°: 409 μ 422 μ μ°¨μ΄ - `409` `β¦/idempotency-key-conflict` β κ°μ ν€μ **μ μμ²μ΄ μμ§ μ²λ¦¬ μ€**μ
λλ€. μ μ λ€ κ°μ ν€λ‘ λ€μ λΆλ₯΄λ©΄ κ·Έ κ²°κ³Όλ₯Ό λ°μ΅λλ€. - `422` `β¦/idempotency-key-reused` β κ°μ ν€λ₯Ό **λ€λ₯Έ body** λ‘ λ³΄λμ΅λλ€. μ¬μλν΄λ μμν κ°μ μ€ν¨μ΄λ μ ν€λ₯Ό μ°κ±°λ body λ₯Ό λλ리μΈμ. ## Rate Limit μ μ **60 μμ²/λΆ per `client_id`**, ν ν° λ°κΈ(`/oauth/token`)μ **5 μμ²/λΆ** μ
λλ€. μ΄κ³Ό μ `429`(`type: β¦/too-many-requests`). μΏΌν°λ λ κ°μ§ νκΈ°λ‘ ν¨κ» λκ°λλ€ β μ κ· μ°λμ νμ€ νλλ₯Ό μ°μΈμ. - **νμ€**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (μ μ±
) Β· `RateLimit: \"default\";r=59;t=42` (μλ r, 리μ
κΉμ§ t μ΄) - **λ κ±°μ**(κ΄μ©): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. κΈ°μ‘΄ μ°λ νΈνμ μν΄ μ μ§ν©λλ€. `429` μμλ `Retry-After`(μ΄)κ° μ°μ ν©λλ€. λλ λκΈ°ν(νλͺ© λ¨μ λ°λ³΅ λ±λ‘ λ±)λ `Retry-After` λ§νΌ backoff ν μ¬μλνμΈμ. ## μΆμ μμ²μ `X-Correlation-Id` ν€λλ₯Ό μ€μΌλ©΄ κ·Έλλ‘ echo λκ³ , μμΌλ©΄ μλ²κ° λ°κΈν©λλ€. λͺ¨λ μλ΅(μ±κ³΅/μλ¬)μ `X-Correlation-Id` κ° μ€λ¦½λλ€. ## μ λ°©νΈν β λͺ¨λ₯΄λ νλμ κ°μμ κΉ¨μ§μ§ μκ² λ€μ μ
μ breaking λ³κ²½μΌλ‘ λ³΄μ§ μμΌλ©° minor 릴리μ€μμ μκ³ μμ΄ μΌμ΄λ©λλ€. μ΄ μ μ λ‘ κ΅¬ννμΈμ. - **μ ν νλ μΆκ°**: λͺ¨λ₯΄λ νλλ 무μνμΈμ. μ격 νμ(unknown key κ±°λΆ)λ₯Ό μ°μ§ λ§μΈμ. - **enum κ° μΆκ°**: μνΒ·λμ°°λ°©λ² λ±μ μ κ°μ΄ μκΉλλ€. λͺ¨λ₯΄λ κ°μ λ§λλ©΄ μμΈλ₯Ό λμ§μ§ λ§κ³ μλ¬Έ λ¬Έμμ΄μ 보쑴νμΈμ. - **problem `type` slug μΆκ°**: λͺ¨λ₯΄λ slug μ **HTTP status λ‘ ν΄λ°±**ν΄ λΆκΈ°νμΈμ. ## λ²μ μλͺ
(deprecation/sunset) - **_/v2** breaking λ³κ²½μ CHANGELOG SemVer(major bump)μ `Deprecation`/`Sunset` ν€λλ‘ ν΅μ§ν©λλ€. μ΄ ν€λλ₯Ό λͺ¨λν°λ§νμΈμ.
|
|
6
6
|
*
|
|
7
|
-
* The version of the OpenAPI document: 36.1.
|
|
7
|
+
* The version of the OpenAPI document: 36.1.1
|
|
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).
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
* CMARKET V6 Partner API
|
|
5
5
|
* μΈλΆ ERP μ°λμ© RESTful API. ## μΈμ¦ OAuth2 Bearer JWT (`client_credentials` νλ‘μ°). `/oauth/token` μμ ν ν°μ λ°κΈλ°μ `Authorization: Bearer <token>` ν€λλ‘ μ€μΌμΈμ. ## κΆν β λ κ°μ λ
립λ μΆ `403` μ λ§λ¬λ€λ©΄ λ μ€ μ΄λ μΆμ κ±Έλ¦° κ²μΈμ§ λ¨Όμ ꡬλΆνμΈμ. - **μ€μ½ν** = *무μμ ν μ μλ*. ν ν°μ λΆμ¬λ `bids:read`Β·`contracts:write` λ±μ
λλ€. 미보μ μ `β¦/insufficient-scope`. - **λν λ²μ** = *λꡬμ λ°μ΄ν°λ₯Ό λ€λ£° μ μλ*. API ν€ μ€μ μ΄λ©° μ€μ½νλ‘ ννλμ§ μμ΅λλ€. λ²μ λ°μ΄λ©΄ μ€μ½νμ 무κ΄νκ² 403 μ
λλ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λ©λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²νμΈμ. ## μ±κ³΅ μλ΅ λ΄ν¬ `/v2` μ λͺ¨λ 2xx λ³Έλ¬Έμ `{ \"data\": β¦ }` μ
λλ€. λ¨μΌ 리μμ€λ λͺ©λ‘μ΄λ κ°μ΅λλ€. λͺ©λ‘μ²λΌ λΆκ° μ λ³΄κ° μλ μλ΅μ `meta` κ° ν¨κ» μ€λ¦½λλ€ β μ: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"β¦\" } }`. λΆκ° μ λ³΄κ° μμΌλ©΄ `meta` ν€λ μμ λκ°μ§ μμ΅λλ€(λΉ κ°μ²΄λ₯Ό μ£μ§ μμ΅λλ€). λ΄ν¬λ₯Ό μ°μ§ μλ νλ©΄μ λμ
λλ€. `/oauth/_*` μ `/.well-known/_*` λ κ°κ° RFC 6749Β·RFC 8414Β·RFC 9728 μ΄ μ΅μμ νλλ₯Ό κ·μ νκ³ , νμΌ λ΄μ© μλ΅μ λ³Έλ¬Έμ΄ JSON μ΄ μλλλ€. μλ¬ μλ΅μλ λ΄ν¬λ₯Ό μμ°μ§ μμ΅λλ€ β μλ problem+json μ΄ λ¨λ
μΌλ‘ μ±
μμ§λλ€. ## μ‘°κ±΄λΆ μμ² (ETag) `/v2` μ λͺ¨λ `GET` μλ΅μ weak `ETag`(`W/\"β¦\"`)κ° μ€λ¦½λλ€. λ°μ κ°μ λ€μ μμ²μ `If-None-Match` ν€λλ‘ λ보λ΄λ©΄, λ΄μ©μ΄ κ·Έλλ‘μΌ λ `304 Not Modified` λ₯Ό λ³Έλ¬Έ μμ΄ λ°μ΅λλ€. κ²°κ³Όκ° λκΈ°λ₯Ό κΈ°λ€λ¦¬λ©° κ°μ μμμ λ°λ³΅ μ‘°ννλ μ°λμ΄λΌλ©΄ μ΄ ν€λ νλλ‘ μ μ‘λμ΄ μ¬λΌμ§λλ€. ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json` μ
λλ€. **HTTP status + `type` URI** λ‘ λΆκΈ°νμΈμ. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλνκ³ , `false`λ©΄ μμ²μ κ³ μ³μΌ ν©λλ€. - `traceId`: μμ² μΆμ id. `X-Correlation-Id` μλ΅ ν€λμ κ°μ κ°μ
λλ€ β λ¬Έμν λ μ΄ κ°μ 첨λΆνμΈμ. - `correlationId`: `traceId` μ κ°μ κ°μ μ μ΄λ¦. κΈ°μ‘΄ μ°λ νΈνμΌλ‘ ν¨κ» μ€λ¦½λλ€. μ μ°λμ `traceId` λ₯Ό μ½μΌμΈμ. - `invalid-params`: κ²μ¦ μ€ν¨(400 `β¦/validation-failed`) μ μλ° νλ κ²½λ‘ λͺ©λ‘(RFC 9457 νμ₯, κ° μμ). `type` μ `https://problems.cmarket.io/partner/<slug>` ννμ **μμ μλ³μ**μ
λλ€. RFC 9457 Β§3.1.1 μ΄ νμ©νλ λλ‘ μ΄ URI λ **μμ°Έμ‘°(dereference)λμ§ μμ΅λλ€** β λΈλΌμ°μ λ‘ μ΄μ§ λ§κ³ λ¬Έμμ΄ λΉκ΅λ‘λ§ μ°μΈμ. slug λͺ©λ‘κ³Ό μλ―Έλ κ° μλν¬μΈνΈμ μλ΅ μ€λͺ
μ status λ³λ‘ μ ν μμ΅λλ€. ### λ©±λ±μ± μλ°: 409 μ 422 μ μ°¨μ΄ - `409` `β¦/idempotency-key-conflict` β κ°μ ν€μ **μ μμ²μ΄ μμ§ μ²λ¦¬ μ€**μ
λλ€. μ μ λ€ κ°μ ν€λ‘ λ€μ λΆλ₯΄λ©΄ κ·Έ κ²°κ³Όλ₯Ό λ°μ΅λλ€. - `422` `β¦/idempotency-key-reused` β κ°μ ν€λ₯Ό **λ€λ₯Έ body** λ‘ λ³΄λμ΅λλ€. μ¬μλν΄λ μμν κ°μ μ€ν¨μ΄λ μ ν€λ₯Ό μ°κ±°λ body λ₯Ό λλ리μΈμ. ## Rate Limit μ μ **60 μμ²/λΆ per `client_id`**, ν ν° λ°κΈ(`/oauth/token`)μ **5 μμ²/λΆ** μ
λλ€. μ΄κ³Ό μ `429`(`type: β¦/too-many-requests`). μΏΌν°λ λ κ°μ§ νκΈ°λ‘ ν¨κ» λκ°λλ€ β μ κ· μ°λμ νμ€ νλλ₯Ό μ°μΈμ. - **νμ€**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (μ μ±
) Β· `RateLimit: \"default\";r=59;t=42` (μλ r, 리μ
κΉμ§ t μ΄) - **λ κ±°μ**(κ΄μ©): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. κΈ°μ‘΄ μ°λ νΈνμ μν΄ μ μ§ν©λλ€. `429` μμλ `Retry-After`(μ΄)κ° μ°μ ν©λλ€. λλ λκΈ°ν(νλͺ© λ¨μ λ°λ³΅ λ±λ‘ λ±)λ `Retry-After` λ§νΌ backoff ν μ¬μλνμΈμ. ## μΆμ μμ²μ `X-Correlation-Id` ν€λλ₯Ό μ€μΌλ©΄ κ·Έλλ‘ echo λκ³ , μμΌλ©΄ μλ²κ° λ°κΈν©λλ€. λͺ¨λ μλ΅(μ±κ³΅/μλ¬)μ `X-Correlation-Id` κ° μ€λ¦½λλ€. ## μ λ°©νΈν β λͺ¨λ₯΄λ νλμ κ°μμ κΉ¨μ§μ§ μκ² λ€μ μ
μ breaking λ³κ²½μΌλ‘ λ³΄μ§ μμΌλ©° minor 릴리μ€μμ μκ³ μμ΄ μΌμ΄λ©λλ€. μ΄ μ μ λ‘ κ΅¬ννμΈμ. - **μ ν νλ μΆκ°**: λͺ¨λ₯΄λ νλλ 무μνμΈμ. μ격 νμ(unknown key κ±°λΆ)λ₯Ό μ°μ§ λ§μΈμ. - **enum κ° μΆκ°**: μνΒ·λμ°°λ°©λ² λ±μ μ κ°μ΄ μκΉλλ€. λͺ¨λ₯΄λ κ°μ λ§λλ©΄ μμΈλ₯Ό λμ§μ§ λ§κ³ μλ¬Έ λ¬Έμμ΄μ 보쑴νμΈμ. - **problem `type` slug μΆκ°**: λͺ¨λ₯΄λ slug μ **HTTP status λ‘ ν΄λ°±**ν΄ λΆκΈ°νμΈμ. ## λ²μ μλͺ
(deprecation/sunset) - **_/v2** breaking λ³κ²½μ CHANGELOG SemVer(major bump)μ `Deprecation`/`Sunset` ν€λλ‘ ν΅μ§ν©λλ€. μ΄ ν€λλ₯Ό λͺ¨λν°λ§νμΈμ.
|
|
6
6
|
*
|
|
7
|
-
* The version of the OpenAPI document: 36.1.
|
|
7
|
+
* The version of the OpenAPI document: 36.1.1
|
|
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).
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
* CMARKET V6 Partner API
|
|
5
5
|
* μΈλΆ ERP μ°λμ© RESTful API. ## μΈμ¦ OAuth2 Bearer JWT (`client_credentials` νλ‘μ°). `/oauth/token` μμ ν ν°μ λ°κΈλ°μ `Authorization: Bearer <token>` ν€λλ‘ μ€μΌμΈμ. ## κΆν β λ κ°μ λ
립λ μΆ `403` μ λ§λ¬λ€λ©΄ λ μ€ μ΄λ μΆμ κ±Έλ¦° κ²μΈμ§ λ¨Όμ ꡬλΆνμΈμ. - **μ€μ½ν** = *무μμ ν μ μλ*. ν ν°μ λΆμ¬λ `bids:read`Β·`contracts:write` λ±μ
λλ€. 미보μ μ `β¦/insufficient-scope`. - **λν λ²μ** = *λꡬμ λ°μ΄ν°λ₯Ό λ€λ£° μ μλ*. API ν€ μ€μ μ΄λ©° μ€μ½νλ‘ ννλμ§ μμ΅λλ€. λ²μ λ°μ΄λ©΄ μ€μ½νμ 무κ΄νκ² 403 μ
λλ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λ©λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²νμΈμ. ## μ±κ³΅ μλ΅ λ΄ν¬ `/v2` μ λͺ¨λ 2xx λ³Έλ¬Έμ `{ \"data\": β¦ }` μ
λλ€. λ¨μΌ 리μμ€λ λͺ©λ‘μ΄λ κ°μ΅λλ€. λͺ©λ‘μ²λΌ λΆκ° μ λ³΄κ° μλ μλ΅μ `meta` κ° ν¨κ» μ€λ¦½λλ€ β μ: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"β¦\" } }`. λΆκ° μ λ³΄κ° μμΌλ©΄ `meta` ν€λ μμ λκ°μ§ μμ΅λλ€(λΉ κ°μ²΄λ₯Ό μ£μ§ μμ΅λλ€). λ΄ν¬λ₯Ό μ°μ§ μλ νλ©΄μ λμ
λλ€. `/oauth/_*` μ `/.well-known/_*` λ κ°κ° RFC 6749Β·RFC 8414Β·RFC 9728 μ΄ μ΅μμ νλλ₯Ό κ·μ νκ³ , νμΌ λ΄μ© μλ΅μ λ³Έλ¬Έμ΄ JSON μ΄ μλλλ€. μλ¬ μλ΅μλ λ΄ν¬λ₯Ό μμ°μ§ μμ΅λλ€ β μλ problem+json μ΄ λ¨λ
μΌλ‘ μ±
μμ§λλ€. ## μ‘°κ±΄λΆ μμ² (ETag) `/v2` μ λͺ¨λ `GET` μλ΅μ weak `ETag`(`W/\"β¦\"`)κ° μ€λ¦½λλ€. λ°μ κ°μ λ€μ μμ²μ `If-None-Match` ν€λλ‘ λ보λ΄λ©΄, λ΄μ©μ΄ κ·Έλλ‘μΌ λ `304 Not Modified` λ₯Ό λ³Έλ¬Έ μμ΄ λ°μ΅λλ€. κ²°κ³Όκ° λκΈ°λ₯Ό κΈ°λ€λ¦¬λ©° κ°μ μμμ λ°λ³΅ μ‘°ννλ μ°λμ΄λΌλ©΄ μ΄ ν€λ νλλ‘ μ μ‘λμ΄ μ¬λΌμ§λλ€. ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json` μ
λλ€. **HTTP status + `type` URI** λ‘ λΆκΈ°νμΈμ. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλνκ³ , `false`λ©΄ μμ²μ κ³ μ³μΌ ν©λλ€. - `traceId`: μμ² μΆμ id. `X-Correlation-Id` μλ΅ ν€λμ κ°μ κ°μ
λλ€ β λ¬Έμν λ μ΄ κ°μ 첨λΆνμΈμ. - `correlationId`: `traceId` μ κ°μ κ°μ μ μ΄λ¦. κΈ°μ‘΄ μ°λ νΈνμΌλ‘ ν¨κ» μ€λ¦½λλ€. μ μ°λμ `traceId` λ₯Ό μ½μΌμΈμ. - `invalid-params`: κ²μ¦ μ€ν¨(400 `β¦/validation-failed`) μ μλ° νλ κ²½λ‘ λͺ©λ‘(RFC 9457 νμ₯, κ° μμ). `type` μ `https://problems.cmarket.io/partner/<slug>` ννμ **μμ μλ³μ**μ
λλ€. RFC 9457 Β§3.1.1 μ΄ νμ©νλ λλ‘ μ΄ URI λ **μμ°Έμ‘°(dereference)λμ§ μμ΅λλ€** β λΈλΌμ°μ λ‘ μ΄μ§ λ§κ³ λ¬Έμμ΄ λΉκ΅λ‘λ§ μ°μΈμ. slug λͺ©λ‘κ³Ό μλ―Έλ κ° μλν¬μΈνΈμ μλ΅ μ€λͺ
μ status λ³λ‘ μ ν μμ΅λλ€. ### λ©±λ±μ± μλ°: 409 μ 422 μ μ°¨μ΄ - `409` `β¦/idempotency-key-conflict` β κ°μ ν€μ **μ μμ²μ΄ μμ§ μ²λ¦¬ μ€**μ
λλ€. μ μ λ€ κ°μ ν€λ‘ λ€μ λΆλ₯΄λ©΄ κ·Έ κ²°κ³Όλ₯Ό λ°μ΅λλ€. - `422` `β¦/idempotency-key-reused` β κ°μ ν€λ₯Ό **λ€λ₯Έ body** λ‘ λ³΄λμ΅λλ€. μ¬μλν΄λ μμν κ°μ μ€ν¨μ΄λ μ ν€λ₯Ό μ°κ±°λ body λ₯Ό λλ리μΈμ. ## Rate Limit μ μ **60 μμ²/λΆ per `client_id`**, ν ν° λ°κΈ(`/oauth/token`)μ **5 μμ²/λΆ** μ
λλ€. μ΄κ³Ό μ `429`(`type: β¦/too-many-requests`). μΏΌν°λ λ κ°μ§ νκΈ°λ‘ ν¨κ» λκ°λλ€ β μ κ· μ°λμ νμ€ νλλ₯Ό μ°μΈμ. - **νμ€**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (μ μ±
) Β· `RateLimit: \"default\";r=59;t=42` (μλ r, 리μ
κΉμ§ t μ΄) - **λ κ±°μ**(κ΄μ©): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. κΈ°μ‘΄ μ°λ νΈνμ μν΄ μ μ§ν©λλ€. `429` μμλ `Retry-After`(μ΄)κ° μ°μ ν©λλ€. λλ λκΈ°ν(νλͺ© λ¨μ λ°λ³΅ λ±λ‘ λ±)λ `Retry-After` λ§νΌ backoff ν μ¬μλνμΈμ. ## μΆμ μμ²μ `X-Correlation-Id` ν€λλ₯Ό μ€μΌλ©΄ κ·Έλλ‘ echo λκ³ , μμΌλ©΄ μλ²κ° λ°κΈν©λλ€. λͺ¨λ μλ΅(μ±κ³΅/μλ¬)μ `X-Correlation-Id` κ° μ€λ¦½λλ€. ## μ λ°©νΈν β λͺ¨λ₯΄λ νλμ κ°μμ κΉ¨μ§μ§ μκ² λ€μ μ
μ breaking λ³κ²½μΌλ‘ λ³΄μ§ μμΌλ©° minor 릴리μ€μμ μκ³ μμ΄ μΌμ΄λ©λλ€. μ΄ μ μ λ‘ κ΅¬ννμΈμ. - **μ ν νλ μΆκ°**: λͺ¨λ₯΄λ νλλ 무μνμΈμ. μ격 νμ(unknown key κ±°λΆ)λ₯Ό μ°μ§ λ§μΈμ. - **enum κ° μΆκ°**: μνΒ·λμ°°λ°©λ² λ±μ μ κ°μ΄ μκΉλλ€. λͺ¨λ₯΄λ κ°μ λ§λλ©΄ μμΈλ₯Ό λμ§μ§ λ§κ³ μλ¬Έ λ¬Έμμ΄μ 보쑴νμΈμ. - **problem `type` slug μΆκ°**: λͺ¨λ₯΄λ slug μ **HTTP status λ‘ ν΄λ°±**ν΄ λΆκΈ°νμΈμ. ## λ²μ μλͺ
(deprecation/sunset) - **_/v2** breaking λ³κ²½μ CHANGELOG SemVer(major bump)μ `Deprecation`/`Sunset` ν€λλ‘ ν΅μ§ν©λλ€. μ΄ ν€λλ₯Ό λͺ¨λν°λ§νμΈμ.
|
|
6
6
|
*
|
|
7
|
-
* The version of the OpenAPI document: 36.1.
|
|
7
|
+
* The version of the OpenAPI document: 36.1.1
|
|
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).
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
* CMARKET V6 Partner API
|
|
5
5
|
* μΈλΆ ERP μ°λμ© RESTful API. ## μΈμ¦ OAuth2 Bearer JWT (`client_credentials` νλ‘μ°). `/oauth/token` μμ ν ν°μ λ°κΈλ°μ `Authorization: Bearer <token>` ν€λλ‘ μ€μΌμΈμ. ## κΆν β λ κ°μ λ
립λ μΆ `403` μ λ§λ¬λ€λ©΄ λ μ€ μ΄λ μΆμ κ±Έλ¦° κ²μΈμ§ λ¨Όμ ꡬλΆνμΈμ. - **μ€μ½ν** = *무μμ ν μ μλ*. ν ν°μ λΆμ¬λ `bids:read`Β·`contracts:write` λ±μ
λλ€. 미보μ μ `β¦/insufficient-scope`. - **λν λ²μ** = *λꡬμ λ°μ΄ν°λ₯Ό λ€λ£° μ μλ*. API ν€ μ€μ μ΄λ©° μ€μ½νλ‘ ννλμ§ μμ΅λλ€. λ²μ λ°μ΄λ©΄ μ€μ½νμ 무κ΄νκ² 403 μ
λλ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λ©λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²νμΈμ. ## μ±κ³΅ μλ΅ λ΄ν¬ `/v2` μ λͺ¨λ 2xx λ³Έλ¬Έμ `{ \"data\": β¦ }` μ
λλ€. λ¨μΌ 리μμ€λ λͺ©λ‘μ΄λ κ°μ΅λλ€. λͺ©λ‘μ²λΌ λΆκ° μ λ³΄κ° μλ μλ΅μ `meta` κ° ν¨κ» μ€λ¦½λλ€ β μ: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"β¦\" } }`. λΆκ° μ λ³΄κ° μμΌλ©΄ `meta` ν€λ μμ λκ°μ§ μμ΅λλ€(λΉ κ°μ²΄λ₯Ό μ£μ§ μμ΅λλ€). λ΄ν¬λ₯Ό μ°μ§ μλ νλ©΄μ λμ
λλ€. `/oauth/_*` μ `/.well-known/_*` λ κ°κ° RFC 6749Β·RFC 8414Β·RFC 9728 μ΄ μ΅μμ νλλ₯Ό κ·μ νκ³ , νμΌ λ΄μ© μλ΅μ λ³Έλ¬Έμ΄ JSON μ΄ μλλλ€. μλ¬ μλ΅μλ λ΄ν¬λ₯Ό μμ°μ§ μμ΅λλ€ β μλ problem+json μ΄ λ¨λ
μΌλ‘ μ±
μμ§λλ€. ## μ‘°κ±΄λΆ μμ² (ETag) `/v2` μ λͺ¨λ `GET` μλ΅μ weak `ETag`(`W/\"β¦\"`)κ° μ€λ¦½λλ€. λ°μ κ°μ λ€μ μμ²μ `If-None-Match` ν€λλ‘ λ보λ΄λ©΄, λ΄μ©μ΄ κ·Έλλ‘μΌ λ `304 Not Modified` λ₯Ό λ³Έλ¬Έ μμ΄ λ°μ΅λλ€. κ²°κ³Όκ° λκΈ°λ₯Ό κΈ°λ€λ¦¬λ©° κ°μ μμμ λ°λ³΅ μ‘°ννλ μ°λμ΄λΌλ©΄ μ΄ ν€λ νλλ‘ μ μ‘λμ΄ μ¬λΌμ§λλ€. ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json` μ
λλ€. **HTTP status + `type` URI** λ‘ λΆκΈ°νμΈμ. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλνκ³ , `false`λ©΄ μμ²μ κ³ μ³μΌ ν©λλ€. - `traceId`: μμ² μΆμ id. `X-Correlation-Id` μλ΅ ν€λμ κ°μ κ°μ
λλ€ β λ¬Έμν λ μ΄ κ°μ 첨λΆνμΈμ. - `correlationId`: `traceId` μ κ°μ κ°μ μ μ΄λ¦. κΈ°μ‘΄ μ°λ νΈνμΌλ‘ ν¨κ» μ€λ¦½λλ€. μ μ°λμ `traceId` λ₯Ό μ½μΌμΈμ. - `invalid-params`: κ²μ¦ μ€ν¨(400 `β¦/validation-failed`) μ μλ° νλ κ²½λ‘ λͺ©λ‘(RFC 9457 νμ₯, κ° μμ). `type` μ `https://problems.cmarket.io/partner/<slug>` ννμ **μμ μλ³μ**μ
λλ€. RFC 9457 Β§3.1.1 μ΄ νμ©νλ λλ‘ μ΄ URI λ **μμ°Έμ‘°(dereference)λμ§ μμ΅λλ€** β λΈλΌμ°μ λ‘ μ΄μ§ λ§κ³ λ¬Έμμ΄ λΉκ΅λ‘λ§ μ°μΈμ. slug λͺ©λ‘κ³Ό μλ―Έλ κ° μλν¬μΈνΈμ μλ΅ μ€λͺ
μ status λ³λ‘ μ ν μμ΅λλ€. ### λ©±λ±μ± μλ°: 409 μ 422 μ μ°¨μ΄ - `409` `β¦/idempotency-key-conflict` β κ°μ ν€μ **μ μμ²μ΄ μμ§ μ²λ¦¬ μ€**μ
λλ€. μ μ λ€ κ°μ ν€λ‘ λ€μ λΆλ₯΄λ©΄ κ·Έ κ²°κ³Όλ₯Ό λ°μ΅λλ€. - `422` `β¦/idempotency-key-reused` β κ°μ ν€λ₯Ό **λ€λ₯Έ body** λ‘ λ³΄λμ΅λλ€. μ¬μλν΄λ μμν κ°μ μ€ν¨μ΄λ μ ν€λ₯Ό μ°κ±°λ body λ₯Ό λλ리μΈμ. ## Rate Limit μ μ **60 μμ²/λΆ per `client_id`**, ν ν° λ°κΈ(`/oauth/token`)μ **5 μμ²/λΆ** μ
λλ€. μ΄κ³Ό μ `429`(`type: β¦/too-many-requests`). μΏΌν°λ λ κ°μ§ νκΈ°λ‘ ν¨κ» λκ°λλ€ β μ κ· μ°λμ νμ€ νλλ₯Ό μ°μΈμ. - **νμ€**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (μ μ±
) Β· `RateLimit: \"default\";r=59;t=42` (μλ r, 리μ
κΉμ§ t μ΄) - **λ κ±°μ**(κ΄μ©): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. κΈ°μ‘΄ μ°λ νΈνμ μν΄ μ μ§ν©λλ€. `429` μμλ `Retry-After`(μ΄)κ° μ°μ ν©λλ€. λλ λκΈ°ν(νλͺ© λ¨μ λ°λ³΅ λ±λ‘ λ±)λ `Retry-After` λ§νΌ backoff ν μ¬μλνμΈμ. ## μΆμ μμ²μ `X-Correlation-Id` ν€λλ₯Ό μ€μΌλ©΄ κ·Έλλ‘ echo λκ³ , μμΌλ©΄ μλ²κ° λ°κΈν©λλ€. λͺ¨λ μλ΅(μ±κ³΅/μλ¬)μ `X-Correlation-Id` κ° μ€λ¦½λλ€. ## μ λ°©νΈν β λͺ¨λ₯΄λ νλμ κ°μμ κΉ¨μ§μ§ μκ² λ€μ μ
μ breaking λ³κ²½μΌλ‘ λ³΄μ§ μμΌλ©° minor 릴리μ€μμ μκ³ μμ΄ μΌμ΄λ©λλ€. μ΄ μ μ λ‘ κ΅¬ννμΈμ. - **μ ν νλ μΆκ°**: λͺ¨λ₯΄λ νλλ 무μνμΈμ. μ격 νμ(unknown key κ±°λΆ)λ₯Ό μ°μ§ λ§μΈμ. - **enum κ° μΆκ°**: μνΒ·λμ°°λ°©λ² λ±μ μ κ°μ΄ μκΉλλ€. λͺ¨λ₯΄λ κ°μ λ§λλ©΄ μμΈλ₯Ό λμ§μ§ λ§κ³ μλ¬Έ λ¬Έμμ΄μ 보쑴νμΈμ. - **problem `type` slug μΆκ°**: λͺ¨λ₯΄λ slug μ **HTTP status λ‘ ν΄λ°±**ν΄ λΆκΈ°νμΈμ. ## λ²μ μλͺ
(deprecation/sunset) - **_/v2** breaking λ³κ²½μ CHANGELOG SemVer(major bump)μ `Deprecation`/`Sunset` ν€λλ‘ ν΅μ§ν©λλ€. μ΄ ν€λλ₯Ό λͺ¨λν°λ§νμΈμ.
|
|
6
6
|
*
|
|
7
|
-
* The version of the OpenAPI document: 36.1.
|
|
7
|
+
* The version of the OpenAPI document: 36.1.1
|
|
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).
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
* CMARKET V6 Partner API
|
|
5
5
|
* μΈλΆ ERP μ°λμ© RESTful API. ## μΈμ¦ OAuth2 Bearer JWT (`client_credentials` νλ‘μ°). `/oauth/token` μμ ν ν°μ λ°κΈλ°μ `Authorization: Bearer <token>` ν€λλ‘ μ€μΌμΈμ. ## κΆν β λ κ°μ λ
립λ μΆ `403` μ λ§λ¬λ€λ©΄ λ μ€ μ΄λ μΆμ κ±Έλ¦° κ²μΈμ§ λ¨Όμ ꡬλΆνμΈμ. - **μ€μ½ν** = *무μμ ν μ μλ*. ν ν°μ λΆμ¬λ `bids:read`Β·`contracts:write` λ±μ
λλ€. 미보μ μ `β¦/insufficient-scope`. - **λν λ²μ** = *λꡬμ λ°μ΄ν°λ₯Ό λ€λ£° μ μλ*. API ν€ μ€μ μ΄λ©° μ€μ½νλ‘ ννλμ§ μμ΅λλ€. λ²μ λ°μ΄λ©΄ μ€μ½νμ 무κ΄νκ² 403 μ
λλ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λ©λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²νμΈμ. ## μ±κ³΅ μλ΅ λ΄ν¬ `/v2` μ λͺ¨λ 2xx λ³Έλ¬Έμ `{ \"data\": β¦ }` μ
λλ€. λ¨μΌ 리μμ€λ λͺ©λ‘μ΄λ κ°μ΅λλ€. λͺ©λ‘μ²λΌ λΆκ° μ λ³΄κ° μλ μλ΅μ `meta` κ° ν¨κ» μ€λ¦½λλ€ β μ: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"β¦\" } }`. λΆκ° μ λ³΄κ° μμΌλ©΄ `meta` ν€λ μμ λκ°μ§ μμ΅λλ€(λΉ κ°μ²΄λ₯Ό μ£μ§ μμ΅λλ€). λ΄ν¬λ₯Ό μ°μ§ μλ νλ©΄μ λμ
λλ€. `/oauth/_*` μ `/.well-known/_*` λ κ°κ° RFC 6749Β·RFC 8414Β·RFC 9728 μ΄ μ΅μμ νλλ₯Ό κ·μ νκ³ , νμΌ λ΄μ© μλ΅μ λ³Έλ¬Έμ΄ JSON μ΄ μλλλ€. μλ¬ μλ΅μλ λ΄ν¬λ₯Ό μμ°μ§ μμ΅λλ€ β μλ problem+json μ΄ λ¨λ
μΌλ‘ μ±
μμ§λλ€. ## μ‘°κ±΄λΆ μμ² (ETag) `/v2` μ λͺ¨λ `GET` μλ΅μ weak `ETag`(`W/\"β¦\"`)κ° μ€λ¦½λλ€. λ°μ κ°μ λ€μ μμ²μ `If-None-Match` ν€λλ‘ λ보λ΄λ©΄, λ΄μ©μ΄ κ·Έλλ‘μΌ λ `304 Not Modified` λ₯Ό λ³Έλ¬Έ μμ΄ λ°μ΅λλ€. κ²°κ³Όκ° λκΈ°λ₯Ό κΈ°λ€λ¦¬λ©° κ°μ μμμ λ°λ³΅ μ‘°ννλ μ°λμ΄λΌλ©΄ μ΄ ν€λ νλλ‘ μ μ‘λμ΄ μ¬λΌμ§λλ€. ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json` μ
λλ€. **HTTP status + `type` URI** λ‘ λΆκΈ°νμΈμ. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλνκ³ , `false`λ©΄ μμ²μ κ³ μ³μΌ ν©λλ€. - `traceId`: μμ² μΆμ id. `X-Correlation-Id` μλ΅ ν€λμ κ°μ κ°μ
λλ€ β λ¬Έμν λ μ΄ κ°μ 첨λΆνμΈμ. - `correlationId`: `traceId` μ κ°μ κ°μ μ μ΄λ¦. κΈ°μ‘΄ μ°λ νΈνμΌλ‘ ν¨κ» μ€λ¦½λλ€. μ μ°λμ `traceId` λ₯Ό μ½μΌμΈμ. - `invalid-params`: κ²μ¦ μ€ν¨(400 `β¦/validation-failed`) μ μλ° νλ κ²½λ‘ λͺ©λ‘(RFC 9457 νμ₯, κ° μμ). `type` μ `https://problems.cmarket.io/partner/<slug>` ννμ **μμ μλ³μ**μ
λλ€. RFC 9457 Β§3.1.1 μ΄ νμ©νλ λλ‘ μ΄ URI λ **μμ°Έμ‘°(dereference)λμ§ μμ΅λλ€** β λΈλΌμ°μ λ‘ μ΄μ§ λ§κ³ λ¬Έμμ΄ λΉκ΅λ‘λ§ μ°μΈμ. slug λͺ©λ‘κ³Ό μλ―Έλ κ° μλν¬μΈνΈμ μλ΅ μ€λͺ
μ status λ³λ‘ μ ν μμ΅λλ€. ### λ©±λ±μ± μλ°: 409 μ 422 μ μ°¨μ΄ - `409` `β¦/idempotency-key-conflict` β κ°μ ν€μ **μ μμ²μ΄ μμ§ μ²λ¦¬ μ€**μ
λλ€. μ μ λ€ κ°μ ν€λ‘ λ€μ λΆλ₯΄λ©΄ κ·Έ κ²°κ³Όλ₯Ό λ°μ΅λλ€. - `422` `β¦/idempotency-key-reused` β κ°μ ν€λ₯Ό **λ€λ₯Έ body** λ‘ λ³΄λμ΅λλ€. μ¬μλν΄λ μμν κ°μ μ€ν¨μ΄λ μ ν€λ₯Ό μ°κ±°λ body λ₯Ό λλ리μΈμ. ## Rate Limit μ μ **60 μμ²/λΆ per `client_id`**, ν ν° λ°κΈ(`/oauth/token`)μ **5 μμ²/λΆ** μ
λλ€. μ΄κ³Ό μ `429`(`type: β¦/too-many-requests`). μΏΌν°λ λ κ°μ§ νκΈ°λ‘ ν¨κ» λκ°λλ€ β μ κ· μ°λμ νμ€ νλλ₯Ό μ°μΈμ. - **νμ€**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (μ μ±
) Β· `RateLimit: \"default\";r=59;t=42` (μλ r, 리μ
κΉμ§ t μ΄) - **λ κ±°μ**(κ΄μ©): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. κΈ°μ‘΄ μ°λ νΈνμ μν΄ μ μ§ν©λλ€. `429` μμλ `Retry-After`(μ΄)κ° μ°μ ν©λλ€. λλ λκΈ°ν(νλͺ© λ¨μ λ°λ³΅ λ±λ‘ λ±)λ `Retry-After` λ§νΌ backoff ν μ¬μλνμΈμ. ## μΆμ μμ²μ `X-Correlation-Id` ν€λλ₯Ό μ€μΌλ©΄ κ·Έλλ‘ echo λκ³ , μμΌλ©΄ μλ²κ° λ°κΈν©λλ€. λͺ¨λ μλ΅(μ±κ³΅/μλ¬)μ `X-Correlation-Id` κ° μ€λ¦½λλ€. ## μ λ°©νΈν β λͺ¨λ₯΄λ νλμ κ°μμ κΉ¨μ§μ§ μκ² λ€μ μ
μ breaking λ³κ²½μΌλ‘ λ³΄μ§ μμΌλ©° minor 릴리μ€μμ μκ³ μμ΄ μΌμ΄λ©λλ€. μ΄ μ μ λ‘ κ΅¬ννμΈμ. - **μ ν νλ μΆκ°**: λͺ¨λ₯΄λ νλλ 무μνμΈμ. μ격 νμ(unknown key κ±°λΆ)λ₯Ό μ°μ§ λ§μΈμ. - **enum κ° μΆκ°**: μνΒ·λμ°°λ°©λ² λ±μ μ κ°μ΄ μκΉλλ€. λͺ¨λ₯΄λ κ°μ λ§λλ©΄ μμΈλ₯Ό λμ§μ§ λ§κ³ μλ¬Έ λ¬Έμμ΄μ 보쑴νμΈμ. - **problem `type` slug μΆκ°**: λͺ¨λ₯΄λ slug μ **HTTP status λ‘ ν΄λ°±**ν΄ λΆκΈ°νμΈμ. ## λ²μ μλͺ
(deprecation/sunset) - **_/v2** breaking λ³κ²½μ CHANGELOG SemVer(major bump)μ `Deprecation`/`Sunset` ν€λλ‘ ν΅μ§ν©λλ€. μ΄ ν€λλ₯Ό λͺ¨λν°λ§νμΈμ.
|
|
6
6
|
*
|
|
7
|
-
* The version of the OpenAPI document: 36.1.
|
|
7
|
+
* The version of the OpenAPI document: 36.1.1
|
|
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).
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
* CMARKET V6 Partner API
|
|
5
5
|
* μΈλΆ ERP μ°λμ© RESTful API. ## μΈμ¦ OAuth2 Bearer JWT (`client_credentials` νλ‘μ°). `/oauth/token` μμ ν ν°μ λ°κΈλ°μ `Authorization: Bearer <token>` ν€λλ‘ μ€μΌμΈμ. ## κΆν β λ κ°μ λ
립λ μΆ `403` μ λ§λ¬λ€λ©΄ λ μ€ μ΄λ μΆμ κ±Έλ¦° κ²μΈμ§ λ¨Όμ ꡬλΆνμΈμ. - **μ€μ½ν** = *무μμ ν μ μλ*. ν ν°μ λΆμ¬λ `bids:read`Β·`contracts:write` λ±μ
λλ€. 미보μ μ `β¦/insufficient-scope`. - **λν λ²μ** = *λꡬμ λ°μ΄ν°λ₯Ό λ€λ£° μ μλ*. API ν€ μ€μ μ΄λ©° μ€μ½νλ‘ ννλμ§ μμ΅λλ€. λ²μ λ°μ΄λ©΄ μ€μ½νμ 무κ΄νκ² 403 μ
λλ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λ©λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²νμΈμ. ## μ±κ³΅ μλ΅ λ΄ν¬ `/v2` μ λͺ¨λ 2xx λ³Έλ¬Έμ `{ \"data\": β¦ }` μ
λλ€. λ¨μΌ 리μμ€λ λͺ©λ‘μ΄λ κ°μ΅λλ€. λͺ©λ‘μ²λΌ λΆκ° μ λ³΄κ° μλ μλ΅μ `meta` κ° ν¨κ» μ€λ¦½λλ€ β μ: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"β¦\" } }`. λΆκ° μ λ³΄κ° μμΌλ©΄ `meta` ν€λ μμ λκ°μ§ μμ΅λλ€(λΉ κ°μ²΄λ₯Ό μ£μ§ μμ΅λλ€). λ΄ν¬λ₯Ό μ°μ§ μλ νλ©΄μ λμ
λλ€. `/oauth/_*` μ `/.well-known/_*` λ κ°κ° RFC 6749Β·RFC 8414Β·RFC 9728 μ΄ μ΅μμ νλλ₯Ό κ·μ νκ³ , νμΌ λ΄μ© μλ΅μ λ³Έλ¬Έμ΄ JSON μ΄ μλλλ€. μλ¬ μλ΅μλ λ΄ν¬λ₯Ό μμ°μ§ μμ΅λλ€ β μλ problem+json μ΄ λ¨λ
μΌλ‘ μ±
μμ§λλ€. ## μ‘°κ±΄λΆ μμ² (ETag) `/v2` μ λͺ¨λ `GET` μλ΅μ weak `ETag`(`W/\"β¦\"`)κ° μ€λ¦½λλ€. λ°μ κ°μ λ€μ μμ²μ `If-None-Match` ν€λλ‘ λ보λ΄λ©΄, λ΄μ©μ΄ κ·Έλλ‘μΌ λ `304 Not Modified` λ₯Ό λ³Έλ¬Έ μμ΄ λ°μ΅λλ€. κ²°κ³Όκ° λκΈ°λ₯Ό κΈ°λ€λ¦¬λ©° κ°μ μμμ λ°λ³΅ μ‘°ννλ μ°λμ΄λΌλ©΄ μ΄ ν€λ νλλ‘ μ μ‘λμ΄ μ¬λΌμ§λλ€. ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json` μ
λλ€. **HTTP status + `type` URI** λ‘ λΆκΈ°νμΈμ. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλνκ³ , `false`λ©΄ μμ²μ κ³ μ³μΌ ν©λλ€. - `traceId`: μμ² μΆμ id. `X-Correlation-Id` μλ΅ ν€λμ κ°μ κ°μ
λλ€ β λ¬Έμν λ μ΄ κ°μ 첨λΆνμΈμ. - `correlationId`: `traceId` μ κ°μ κ°μ μ μ΄λ¦. κΈ°μ‘΄ μ°λ νΈνμΌλ‘ ν¨κ» μ€λ¦½λλ€. μ μ°λμ `traceId` λ₯Ό μ½μΌμΈμ. - `invalid-params`: κ²μ¦ μ€ν¨(400 `β¦/validation-failed`) μ μλ° νλ κ²½λ‘ λͺ©λ‘(RFC 9457 νμ₯, κ° μμ). `type` μ `https://problems.cmarket.io/partner/<slug>` ννμ **μμ μλ³μ**μ
λλ€. RFC 9457 Β§3.1.1 μ΄ νμ©νλ λλ‘ μ΄ URI λ **μμ°Έμ‘°(dereference)λμ§ μμ΅λλ€** β λΈλΌμ°μ λ‘ μ΄μ§ λ§κ³ λ¬Έμμ΄ λΉκ΅λ‘λ§ μ°μΈμ. slug λͺ©λ‘κ³Ό μλ―Έλ κ° μλν¬μΈνΈμ μλ΅ μ€λͺ
μ status λ³λ‘ μ ν μμ΅λλ€. ### λ©±λ±μ± μλ°: 409 μ 422 μ μ°¨μ΄ - `409` `β¦/idempotency-key-conflict` β κ°μ ν€μ **μ μμ²μ΄ μμ§ μ²λ¦¬ μ€**μ
λλ€. μ μ λ€ κ°μ ν€λ‘ λ€μ λΆλ₯΄λ©΄ κ·Έ κ²°κ³Όλ₯Ό λ°μ΅λλ€. - `422` `β¦/idempotency-key-reused` β κ°μ ν€λ₯Ό **λ€λ₯Έ body** λ‘ λ³΄λμ΅λλ€. μ¬μλν΄λ μμν κ°μ μ€ν¨μ΄λ μ ν€λ₯Ό μ°κ±°λ body λ₯Ό λλ리μΈμ. ## Rate Limit μ μ **60 μμ²/λΆ per `client_id`**, ν ν° λ°κΈ(`/oauth/token`)μ **5 μμ²/λΆ** μ
λλ€. μ΄κ³Ό μ `429`(`type: β¦/too-many-requests`). μΏΌν°λ λ κ°μ§ νκΈ°λ‘ ν¨κ» λκ°λλ€ β μ κ· μ°λμ νμ€ νλλ₯Ό μ°μΈμ. - **νμ€**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (μ μ±
) Β· `RateLimit: \"default\";r=59;t=42` (μλ r, 리μ
κΉμ§ t μ΄) - **λ κ±°μ**(κ΄μ©): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. κΈ°μ‘΄ μ°λ νΈνμ μν΄ μ μ§ν©λλ€. `429` μμλ `Retry-After`(μ΄)κ° μ°μ ν©λλ€. λλ λκΈ°ν(νλͺ© λ¨μ λ°λ³΅ λ±λ‘ λ±)λ `Retry-After` λ§νΌ backoff ν μ¬μλνμΈμ. ## μΆμ μμ²μ `X-Correlation-Id` ν€λλ₯Ό μ€μΌλ©΄ κ·Έλλ‘ echo λκ³ , μμΌλ©΄ μλ²κ° λ°κΈν©λλ€. λͺ¨λ μλ΅(μ±κ³΅/μλ¬)μ `X-Correlation-Id` κ° μ€λ¦½λλ€. ## μ λ°©νΈν β λͺ¨λ₯΄λ νλμ κ°μμ κΉ¨μ§μ§ μκ² λ€μ μ
μ breaking λ³κ²½μΌλ‘ λ³΄μ§ μμΌλ©° minor 릴리μ€μμ μκ³ μμ΄ μΌμ΄λ©λλ€. μ΄ μ μ λ‘ κ΅¬ννμΈμ. - **μ ν νλ μΆκ°**: λͺ¨λ₯΄λ νλλ 무μνμΈμ. μ격 νμ(unknown key κ±°λΆ)λ₯Ό μ°μ§ λ§μΈμ. - **enum κ° μΆκ°**: μνΒ·λμ°°λ°©λ² λ±μ μ κ°μ΄ μκΉλλ€. λͺ¨λ₯΄λ κ°μ λ§λλ©΄ μμΈλ₯Ό λμ§μ§ λ§κ³ μλ¬Έ λ¬Έμμ΄μ 보쑴νμΈμ. - **problem `type` slug μΆκ°**: λͺ¨λ₯΄λ slug μ **HTTP status λ‘ ν΄λ°±**ν΄ λΆκΈ°νμΈμ. ## λ²μ μλͺ
(deprecation/sunset) - **_/v2** breaking λ³κ²½μ CHANGELOG SemVer(major bump)μ `Deprecation`/`Sunset` ν€λλ‘ ν΅μ§ν©λλ€. μ΄ ν€λλ₯Ό λͺ¨λν°λ§νμΈμ.
|
|
6
6
|
*
|
|
7
|
-
* The version of the OpenAPI document: 36.1.
|
|
7
|
+
* The version of the OpenAPI document: 36.1.1
|
|
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).
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
* CMARKET V6 Partner API
|
|
5
5
|
* μΈλΆ ERP μ°λμ© RESTful API. ## μΈμ¦ OAuth2 Bearer JWT (`client_credentials` νλ‘μ°). `/oauth/token` μμ ν ν°μ λ°κΈλ°μ `Authorization: Bearer <token>` ν€λλ‘ μ€μΌμΈμ. ## κΆν β λ κ°μ λ
립λ μΆ `403` μ λ§λ¬λ€λ©΄ λ μ€ μ΄λ μΆμ κ±Έλ¦° κ²μΈμ§ λ¨Όμ ꡬλΆνμΈμ. - **μ€μ½ν** = *무μμ ν μ μλ*. ν ν°μ λΆμ¬λ `bids:read`Β·`contracts:write` λ±μ
λλ€. 미보μ μ `β¦/insufficient-scope`. - **λν λ²μ** = *λꡬμ λ°μ΄ν°λ₯Ό λ€λ£° μ μλ*. API ν€ μ€μ μ΄λ©° μ€μ½νλ‘ ννλμ§ μμ΅λλ€. λ²μ λ°μ΄λ©΄ μ€μ½νμ 무κ΄νκ² 403 μ
λλ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λ©λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²νμΈμ. ## μ±κ³΅ μλ΅ λ΄ν¬ `/v2` μ λͺ¨λ 2xx λ³Έλ¬Έμ `{ \"data\": β¦ }` μ
λλ€. λ¨μΌ 리μμ€λ λͺ©λ‘μ΄λ κ°μ΅λλ€. λͺ©λ‘μ²λΌ λΆκ° μ λ³΄κ° μλ μλ΅μ `meta` κ° ν¨κ» μ€λ¦½λλ€ β μ: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"β¦\" } }`. λΆκ° μ λ³΄κ° μμΌλ©΄ `meta` ν€λ μμ λκ°μ§ μμ΅λλ€(λΉ κ°μ²΄λ₯Ό μ£μ§ μμ΅λλ€). λ΄ν¬λ₯Ό μ°μ§ μλ νλ©΄μ λμ
λλ€. `/oauth/_*` μ `/.well-known/_*` λ κ°κ° RFC 6749Β·RFC 8414Β·RFC 9728 μ΄ μ΅μμ νλλ₯Ό κ·μ νκ³ , νμΌ λ΄μ© μλ΅μ λ³Έλ¬Έμ΄ JSON μ΄ μλλλ€. μλ¬ μλ΅μλ λ΄ν¬λ₯Ό μμ°μ§ μμ΅λλ€ β μλ problem+json μ΄ λ¨λ
μΌλ‘ μ±
μμ§λλ€. ## μ‘°κ±΄λΆ μμ² (ETag) `/v2` μ λͺ¨λ `GET` μλ΅μ weak `ETag`(`W/\"β¦\"`)κ° μ€λ¦½λλ€. λ°μ κ°μ λ€μ μμ²μ `If-None-Match` ν€λλ‘ λ보λ΄λ©΄, λ΄μ©μ΄ κ·Έλλ‘μΌ λ `304 Not Modified` λ₯Ό λ³Έλ¬Έ μμ΄ λ°μ΅λλ€. κ²°κ³Όκ° λκΈ°λ₯Ό κΈ°λ€λ¦¬λ©° κ°μ μμμ λ°λ³΅ μ‘°ννλ μ°λμ΄λΌλ©΄ μ΄ ν€λ νλλ‘ μ μ‘λμ΄ μ¬λΌμ§λλ€. ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json` μ
λλ€. **HTTP status + `type` URI** λ‘ λΆκΈ°νμΈμ. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλνκ³ , `false`λ©΄ μμ²μ κ³ μ³μΌ ν©λλ€. - `traceId`: μμ² μΆμ id. `X-Correlation-Id` μλ΅ ν€λμ κ°μ κ°μ
λλ€ β λ¬Έμν λ μ΄ κ°μ 첨λΆνμΈμ. - `correlationId`: `traceId` μ κ°μ κ°μ μ μ΄λ¦. κΈ°μ‘΄ μ°λ νΈνμΌλ‘ ν¨κ» μ€λ¦½λλ€. μ μ°λμ `traceId` λ₯Ό μ½μΌμΈμ. - `invalid-params`: κ²μ¦ μ€ν¨(400 `β¦/validation-failed`) μ μλ° νλ κ²½λ‘ λͺ©λ‘(RFC 9457 νμ₯, κ° μμ). `type` μ `https://problems.cmarket.io/partner/<slug>` ννμ **μμ μλ³μ**μ
λλ€. RFC 9457 Β§3.1.1 μ΄ νμ©νλ λλ‘ μ΄ URI λ **μμ°Έμ‘°(dereference)λμ§ μμ΅λλ€** β λΈλΌμ°μ λ‘ μ΄μ§ λ§κ³ λ¬Έμμ΄ λΉκ΅λ‘λ§ μ°μΈμ. slug λͺ©λ‘κ³Ό μλ―Έλ κ° μλν¬μΈνΈμ μλ΅ μ€λͺ
μ status λ³λ‘ μ ν μμ΅λλ€. ### λ©±λ±μ± μλ°: 409 μ 422 μ μ°¨μ΄ - `409` `β¦/idempotency-key-conflict` β κ°μ ν€μ **μ μμ²μ΄ μμ§ μ²λ¦¬ μ€**μ
λλ€. μ μ λ€ κ°μ ν€λ‘ λ€μ λΆλ₯΄λ©΄ κ·Έ κ²°κ³Όλ₯Ό λ°μ΅λλ€. - `422` `β¦/idempotency-key-reused` β κ°μ ν€λ₯Ό **λ€λ₯Έ body** λ‘ λ³΄λμ΅λλ€. μ¬μλν΄λ μμν κ°μ μ€ν¨μ΄λ μ ν€λ₯Ό μ°κ±°λ body λ₯Ό λλ리μΈμ. ## Rate Limit μ μ **60 μμ²/λΆ per `client_id`**, ν ν° λ°κΈ(`/oauth/token`)μ **5 μμ²/λΆ** μ
λλ€. μ΄κ³Ό μ `429`(`type: β¦/too-many-requests`). μΏΌν°λ λ κ°μ§ νκΈ°λ‘ ν¨κ» λκ°λλ€ β μ κ· μ°λμ νμ€ νλλ₯Ό μ°μΈμ. - **νμ€**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (μ μ±
) Β· `RateLimit: \"default\";r=59;t=42` (μλ r, 리μ
κΉμ§ t μ΄) - **λ κ±°μ**(κ΄μ©): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. κΈ°μ‘΄ μ°λ νΈνμ μν΄ μ μ§ν©λλ€. `429` μμλ `Retry-After`(μ΄)κ° μ°μ ν©λλ€. λλ λκΈ°ν(νλͺ© λ¨μ λ°λ³΅ λ±λ‘ λ±)λ `Retry-After` λ§νΌ backoff ν μ¬μλνμΈμ. ## μΆμ μμ²μ `X-Correlation-Id` ν€λλ₯Ό μ€μΌλ©΄ κ·Έλλ‘ echo λκ³ , μμΌλ©΄ μλ²κ° λ°κΈν©λλ€. λͺ¨λ μλ΅(μ±κ³΅/μλ¬)μ `X-Correlation-Id` κ° μ€λ¦½λλ€. ## μ λ°©νΈν β λͺ¨λ₯΄λ νλμ κ°μμ κΉ¨μ§μ§ μκ² λ€μ μ
μ breaking λ³κ²½μΌλ‘ λ³΄μ§ μμΌλ©° minor 릴리μ€μμ μκ³ μμ΄ μΌμ΄λ©λλ€. μ΄ μ μ λ‘ κ΅¬ννμΈμ. - **μ ν νλ μΆκ°**: λͺ¨λ₯΄λ νλλ 무μνμΈμ. μ격 νμ(unknown key κ±°λΆ)λ₯Ό μ°μ§ λ§μΈμ. - **enum κ° μΆκ°**: μνΒ·λμ°°λ°©λ² λ±μ μ κ°μ΄ μκΉλλ€. λͺ¨λ₯΄λ κ°μ λ§λλ©΄ μμΈλ₯Ό λμ§μ§ λ§κ³ μλ¬Έ λ¬Έμμ΄μ 보쑴νμΈμ. - **problem `type` slug μΆκ°**: λͺ¨λ₯΄λ slug μ **HTTP status λ‘ ν΄λ°±**ν΄ λΆκΈ°νμΈμ. ## λ²μ μλͺ
(deprecation/sunset) - **_/v2** breaking λ³κ²½μ CHANGELOG SemVer(major bump)μ `Deprecation`/`Sunset` ν€λλ‘ ν΅μ§ν©λλ€. μ΄ ν€λλ₯Ό λͺ¨λν°λ§νμΈμ.
|
|
6
6
|
*
|
|
7
|
-
* The version of the OpenAPI document: 36.1.
|
|
7
|
+
* The version of the OpenAPI document: 36.1.1
|
|
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).
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
* CMARKET V6 Partner API
|
|
5
5
|
* μΈλΆ ERP μ°λμ© RESTful API. ## μΈμ¦ OAuth2 Bearer JWT (`client_credentials` νλ‘μ°). `/oauth/token` μμ ν ν°μ λ°κΈλ°μ `Authorization: Bearer <token>` ν€λλ‘ μ€μΌμΈμ. ## κΆν β λ κ°μ λ
립λ μΆ `403` μ λ§λ¬λ€λ©΄ λ μ€ μ΄λ μΆμ κ±Έλ¦° κ²μΈμ§ λ¨Όμ ꡬλΆνμΈμ. - **μ€μ½ν** = *무μμ ν μ μλ*. ν ν°μ λΆμ¬λ `bids:read`Β·`contracts:write` λ±μ
λλ€. 미보μ μ `β¦/insufficient-scope`. - **λν λ²μ** = *λꡬμ λ°μ΄ν°λ₯Ό λ€λ£° μ μλ*. API ν€ μ€μ μ΄λ©° μ€μ½νλ‘ ννλμ§ μμ΅λλ€. λ²μ λ°μ΄λ©΄ μ€μ½νμ 무κ΄νκ² 403 μ
λλ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λ©λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²νμΈμ. ## μ±κ³΅ μλ΅ λ΄ν¬ `/v2` μ λͺ¨λ 2xx λ³Έλ¬Έμ `{ \"data\": β¦ }` μ
λλ€. λ¨μΌ 리μμ€λ λͺ©λ‘μ΄λ κ°μ΅λλ€. λͺ©λ‘μ²λΌ λΆκ° μ λ³΄κ° μλ μλ΅μ `meta` κ° ν¨κ» μ€λ¦½λλ€ β μ: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"β¦\" } }`. λΆκ° μ λ³΄κ° μμΌλ©΄ `meta` ν€λ μμ λκ°μ§ μμ΅λλ€(λΉ κ°μ²΄λ₯Ό μ£μ§ μμ΅λλ€). λ΄ν¬λ₯Ό μ°μ§ μλ νλ©΄μ λμ
λλ€. `/oauth/_*` μ `/.well-known/_*` λ κ°κ° RFC 6749Β·RFC 8414Β·RFC 9728 μ΄ μ΅μμ νλλ₯Ό κ·μ νκ³ , νμΌ λ΄μ© μλ΅μ λ³Έλ¬Έμ΄ JSON μ΄ μλλλ€. μλ¬ μλ΅μλ λ΄ν¬λ₯Ό μμ°μ§ μμ΅λλ€ β μλ problem+json μ΄ λ¨λ
μΌλ‘ μ±
μμ§λλ€. ## μ‘°κ±΄λΆ μμ² (ETag) `/v2` μ λͺ¨λ `GET` μλ΅μ weak `ETag`(`W/\"β¦\"`)κ° μ€λ¦½λλ€. λ°μ κ°μ λ€μ μμ²μ `If-None-Match` ν€λλ‘ λ보λ΄λ©΄, λ΄μ©μ΄ κ·Έλλ‘μΌ λ `304 Not Modified` λ₯Ό λ³Έλ¬Έ μμ΄ λ°μ΅λλ€. κ²°κ³Όκ° λκΈ°λ₯Ό κΈ°λ€λ¦¬λ©° κ°μ μμμ λ°λ³΅ μ‘°ννλ μ°λμ΄λΌλ©΄ μ΄ ν€λ νλλ‘ μ μ‘λμ΄ μ¬λΌμ§λλ€. ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json` μ
λλ€. **HTTP status + `type` URI** λ‘ λΆκΈ°νμΈμ. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλνκ³ , `false`λ©΄ μμ²μ κ³ μ³μΌ ν©λλ€. - `traceId`: μμ² μΆμ id. `X-Correlation-Id` μλ΅ ν€λμ κ°μ κ°μ
λλ€ β λ¬Έμν λ μ΄ κ°μ 첨λΆνμΈμ. - `correlationId`: `traceId` μ κ°μ κ°μ μ μ΄λ¦. κΈ°μ‘΄ μ°λ νΈνμΌλ‘ ν¨κ» μ€λ¦½λλ€. μ μ°λμ `traceId` λ₯Ό μ½μΌμΈμ. - `invalid-params`: κ²μ¦ μ€ν¨(400 `β¦/validation-failed`) μ μλ° νλ κ²½λ‘ λͺ©λ‘(RFC 9457 νμ₯, κ° μμ). `type` μ `https://problems.cmarket.io/partner/<slug>` ννμ **μμ μλ³μ**μ
λλ€. RFC 9457 Β§3.1.1 μ΄ νμ©νλ λλ‘ μ΄ URI λ **μμ°Έμ‘°(dereference)λμ§ μμ΅λλ€** β λΈλΌμ°μ λ‘ μ΄μ§ λ§κ³ λ¬Έμμ΄ λΉκ΅λ‘λ§ μ°μΈμ. slug λͺ©λ‘κ³Ό μλ―Έλ κ° μλν¬μΈνΈμ μλ΅ μ€λͺ
μ status λ³λ‘ μ ν μμ΅λλ€. ### λ©±λ±μ± μλ°: 409 μ 422 μ μ°¨μ΄ - `409` `β¦/idempotency-key-conflict` β κ°μ ν€μ **μ μμ²μ΄ μμ§ μ²λ¦¬ μ€**μ
λλ€. μ μ λ€ κ°μ ν€λ‘ λ€μ λΆλ₯΄λ©΄ κ·Έ κ²°κ³Όλ₯Ό λ°μ΅λλ€. - `422` `β¦/idempotency-key-reused` β κ°μ ν€λ₯Ό **λ€λ₯Έ body** λ‘ λ³΄λμ΅λλ€. μ¬μλν΄λ μμν κ°μ μ€ν¨μ΄λ μ ν€λ₯Ό μ°κ±°λ body λ₯Ό λλ리μΈμ. ## Rate Limit μ μ **60 μμ²/λΆ per `client_id`**, ν ν° λ°κΈ(`/oauth/token`)μ **5 μμ²/λΆ** μ
λλ€. μ΄κ³Ό μ `429`(`type: β¦/too-many-requests`). μΏΌν°λ λ κ°μ§ νκΈ°λ‘ ν¨κ» λκ°λλ€ β μ κ· μ°λμ νμ€ νλλ₯Ό μ°μΈμ. - **νμ€**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (μ μ±
) Β· `RateLimit: \"default\";r=59;t=42` (μλ r, 리μ
κΉμ§ t μ΄) - **λ κ±°μ**(κ΄μ©): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. κΈ°μ‘΄ μ°λ νΈνμ μν΄ μ μ§ν©λλ€. `429` μμλ `Retry-After`(μ΄)κ° μ°μ ν©λλ€. λλ λκΈ°ν(νλͺ© λ¨μ λ°λ³΅ λ±λ‘ λ±)λ `Retry-After` λ§νΌ backoff ν μ¬μλνμΈμ. ## μΆμ μμ²μ `X-Correlation-Id` ν€λλ₯Ό μ€μΌλ©΄ κ·Έλλ‘ echo λκ³ , μμΌλ©΄ μλ²κ° λ°κΈν©λλ€. λͺ¨λ μλ΅(μ±κ³΅/μλ¬)μ `X-Correlation-Id` κ° μ€λ¦½λλ€. ## μ λ°©νΈν β λͺ¨λ₯΄λ νλμ κ°μμ κΉ¨μ§μ§ μκ² λ€μ μ
μ breaking λ³κ²½μΌλ‘ λ³΄μ§ μμΌλ©° minor 릴리μ€μμ μκ³ μμ΄ μΌμ΄λ©λλ€. μ΄ μ μ λ‘ κ΅¬ννμΈμ. - **μ ν νλ μΆκ°**: λͺ¨λ₯΄λ νλλ 무μνμΈμ. μ격 νμ(unknown key κ±°λΆ)λ₯Ό μ°μ§ λ§μΈμ. - **enum κ° μΆκ°**: μνΒ·λμ°°λ°©λ² λ±μ μ κ°μ΄ μκΉλλ€. λͺ¨λ₯΄λ κ°μ λ§λλ©΄ μμΈλ₯Ό λμ§μ§ λ§κ³ μλ¬Έ λ¬Έμμ΄μ 보쑴νμΈμ. - **problem `type` slug μΆκ°**: λͺ¨λ₯΄λ slug μ **HTTP status λ‘ ν΄λ°±**ν΄ λΆκΈ°νμΈμ. ## λ²μ μλͺ
(deprecation/sunset) - **_/v2** breaking λ³κ²½μ CHANGELOG SemVer(major bump)μ `Deprecation`/`Sunset` ν€λλ‘ ν΅μ§ν©λλ€. μ΄ ν€λλ₯Ό λͺ¨λν°λ§νμΈμ.
|
|
6
6
|
*
|
|
7
|
-
* The version of the OpenAPI document: 36.1.
|
|
7
|
+
* The version of the OpenAPI document: 36.1.1
|
|
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).
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
* CMARKET V6 Partner API
|
|
5
5
|
* μΈλΆ ERP μ°λμ© RESTful API. ## μΈμ¦ OAuth2 Bearer JWT (`client_credentials` νλ‘μ°). `/oauth/token` μμ ν ν°μ λ°κΈλ°μ `Authorization: Bearer <token>` ν€λλ‘ μ€μΌμΈμ. ## κΆν β λ κ°μ λ
립λ μΆ `403` μ λ§λ¬λ€λ©΄ λ μ€ μ΄λ μΆμ κ±Έλ¦° κ²μΈμ§ λ¨Όμ ꡬλΆνμΈμ. - **μ€μ½ν** = *무μμ ν μ μλ*. ν ν°μ λΆμ¬λ `bids:read`Β·`contracts:write` λ±μ
λλ€. 미보μ μ `β¦/insufficient-scope`. - **λν λ²μ** = *λꡬμ λ°μ΄ν°λ₯Ό λ€λ£° μ μλ*. API ν€ μ€μ μ΄λ©° μ€μ½νλ‘ ννλμ§ μμ΅λλ€. λ²μ λ°μ΄λ©΄ μ€μ½νμ 무κ΄νκ² 403 μ
λλ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λ©λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²νμΈμ. ## μ±κ³΅ μλ΅ λ΄ν¬ `/v2` μ λͺ¨λ 2xx λ³Έλ¬Έμ `{ \"data\": β¦ }` μ
λλ€. λ¨μΌ 리μμ€λ λͺ©λ‘μ΄λ κ°μ΅λλ€. λͺ©λ‘μ²λΌ λΆκ° μ λ³΄κ° μλ μλ΅μ `meta` κ° ν¨κ» μ€λ¦½λλ€ β μ: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"β¦\" } }`. λΆκ° μ λ³΄κ° μμΌλ©΄ `meta` ν€λ μμ λκ°μ§ μμ΅λλ€(λΉ κ°μ²΄λ₯Ό μ£μ§ μμ΅λλ€). λ΄ν¬λ₯Ό μ°μ§ μλ νλ©΄μ λμ
λλ€. `/oauth/_*` μ `/.well-known/_*` λ κ°κ° RFC 6749Β·RFC 8414Β·RFC 9728 μ΄ μ΅μμ νλλ₯Ό κ·μ νκ³ , νμΌ λ΄μ© μλ΅μ λ³Έλ¬Έμ΄ JSON μ΄ μλλλ€. μλ¬ μλ΅μλ λ΄ν¬λ₯Ό μμ°μ§ μμ΅λλ€ β μλ problem+json μ΄ λ¨λ
μΌλ‘ μ±
μμ§λλ€. ## μ‘°κ±΄λΆ μμ² (ETag) `/v2` μ λͺ¨λ `GET` μλ΅μ weak `ETag`(`W/\"β¦\"`)κ° μ€λ¦½λλ€. λ°μ κ°μ λ€μ μμ²μ `If-None-Match` ν€λλ‘ λ보λ΄λ©΄, λ΄μ©μ΄ κ·Έλλ‘μΌ λ `304 Not Modified` λ₯Ό λ³Έλ¬Έ μμ΄ λ°μ΅λλ€. κ²°κ³Όκ° λκΈ°λ₯Ό κΈ°λ€λ¦¬λ©° κ°μ μμμ λ°λ³΅ μ‘°ννλ μ°λμ΄λΌλ©΄ μ΄ ν€λ νλλ‘ μ μ‘λμ΄ μ¬λΌμ§λλ€. ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json` μ
λλ€. **HTTP status + `type` URI** λ‘ λΆκΈ°νμΈμ. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλνκ³ , `false`λ©΄ μμ²μ κ³ μ³μΌ ν©λλ€. - `traceId`: μμ² μΆμ id. `X-Correlation-Id` μλ΅ ν€λμ κ°μ κ°μ
λλ€ β λ¬Έμν λ μ΄ κ°μ 첨λΆνμΈμ. - `correlationId`: `traceId` μ κ°μ κ°μ μ μ΄λ¦. κΈ°μ‘΄ μ°λ νΈνμΌλ‘ ν¨κ» μ€λ¦½λλ€. μ μ°λμ `traceId` λ₯Ό μ½μΌμΈμ. - `invalid-params`: κ²μ¦ μ€ν¨(400 `β¦/validation-failed`) μ μλ° νλ κ²½λ‘ λͺ©λ‘(RFC 9457 νμ₯, κ° μμ). `type` μ `https://problems.cmarket.io/partner/<slug>` ννμ **μμ μλ³μ**μ
λλ€. RFC 9457 Β§3.1.1 μ΄ νμ©νλ λλ‘ μ΄ URI λ **μμ°Έμ‘°(dereference)λμ§ μμ΅λλ€** β λΈλΌμ°μ λ‘ μ΄μ§ λ§κ³ λ¬Έμμ΄ λΉκ΅λ‘λ§ μ°μΈμ. slug λͺ©λ‘κ³Ό μλ―Έλ κ° μλν¬μΈνΈμ μλ΅ μ€λͺ
μ status λ³λ‘ μ ν μμ΅λλ€. ### λ©±λ±μ± μλ°: 409 μ 422 μ μ°¨μ΄ - `409` `β¦/idempotency-key-conflict` β κ°μ ν€μ **μ μμ²μ΄ μμ§ μ²λ¦¬ μ€**μ
λλ€. μ μ λ€ κ°μ ν€λ‘ λ€μ λΆλ₯΄λ©΄ κ·Έ κ²°κ³Όλ₯Ό λ°μ΅λλ€. - `422` `β¦/idempotency-key-reused` β κ°μ ν€λ₯Ό **λ€λ₯Έ body** λ‘ λ³΄λμ΅λλ€. μ¬μλν΄λ μμν κ°μ μ€ν¨μ΄λ μ ν€λ₯Ό μ°κ±°λ body λ₯Ό λλ리μΈμ. ## Rate Limit μ μ **60 μμ²/λΆ per `client_id`**, ν ν° λ°κΈ(`/oauth/token`)μ **5 μμ²/λΆ** μ
λλ€. μ΄κ³Ό μ `429`(`type: β¦/too-many-requests`). μΏΌν°λ λ κ°μ§ νκΈ°λ‘ ν¨κ» λκ°λλ€ β μ κ· μ°λμ νμ€ νλλ₯Ό μ°μΈμ. - **νμ€**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (μ μ±
) Β· `RateLimit: \"default\";r=59;t=42` (μλ r, 리μ
κΉμ§ t μ΄) - **λ κ±°μ**(κ΄μ©): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. κΈ°μ‘΄ μ°λ νΈνμ μν΄ μ μ§ν©λλ€. `429` μμλ `Retry-After`(μ΄)κ° μ°μ ν©λλ€. λλ λκΈ°ν(νλͺ© λ¨μ λ°λ³΅ λ±λ‘ λ±)λ `Retry-After` λ§νΌ backoff ν μ¬μλνμΈμ. ## μΆμ μμ²μ `X-Correlation-Id` ν€λλ₯Ό μ€μΌλ©΄ κ·Έλλ‘ echo λκ³ , μμΌλ©΄ μλ²κ° λ°κΈν©λλ€. λͺ¨λ μλ΅(μ±κ³΅/μλ¬)μ `X-Correlation-Id` κ° μ€λ¦½λλ€. ## μ λ°©νΈν β λͺ¨λ₯΄λ νλμ κ°μμ κΉ¨μ§μ§ μκ² λ€μ μ
μ breaking λ³κ²½μΌλ‘ λ³΄μ§ μμΌλ©° minor 릴리μ€μμ μκ³ μμ΄ μΌμ΄λ©λλ€. μ΄ μ μ λ‘ κ΅¬ννμΈμ. - **μ ν νλ μΆκ°**: λͺ¨λ₯΄λ νλλ 무μνμΈμ. μ격 νμ(unknown key κ±°λΆ)λ₯Ό μ°μ§ λ§μΈμ. - **enum κ° μΆκ°**: μνΒ·λμ°°λ°©λ² λ±μ μ κ°μ΄ μκΉλλ€. λͺ¨λ₯΄λ κ°μ λ§λλ©΄ μμΈλ₯Ό λμ§μ§ λ§κ³ μλ¬Έ λ¬Έμμ΄μ 보쑴νμΈμ. - **problem `type` slug μΆκ°**: λͺ¨λ₯΄λ slug μ **HTTP status λ‘ ν΄λ°±**ν΄ λΆκΈ°νμΈμ. ## λ²μ μλͺ
(deprecation/sunset) - **_/v2** breaking λ³κ²½μ CHANGELOG SemVer(major bump)μ `Deprecation`/`Sunset` ν€λλ‘ ν΅μ§ν©λλ€. μ΄ ν€λλ₯Ό λͺ¨λν°λ§νμΈμ.
|
|
6
6
|
*
|
|
7
|
-
* The version of the OpenAPI document: 36.1.
|
|
7
|
+
* The version of the OpenAPI document: 36.1.1
|
|
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).
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
* CMARKET V6 Partner API
|
|
5
5
|
* μΈλΆ ERP μ°λμ© RESTful API. ## μΈμ¦ OAuth2 Bearer JWT (`client_credentials` νλ‘μ°). `/oauth/token` μμ ν ν°μ λ°κΈλ°μ `Authorization: Bearer <token>` ν€λλ‘ μ€μΌμΈμ. ## κΆν β λ κ°μ λ
립λ μΆ `403` μ λ§λ¬λ€λ©΄ λ μ€ μ΄λ μΆμ κ±Έλ¦° κ²μΈμ§ λ¨Όμ ꡬλΆνμΈμ. - **μ€μ½ν** = *무μμ ν μ μλ*. ν ν°μ λΆμ¬λ `bids:read`Β·`contracts:write` λ±μ
λλ€. 미보μ μ `β¦/insufficient-scope`. - **λν λ²μ** = *λꡬμ λ°μ΄ν°λ₯Ό λ€λ£° μ μλ*. API ν€ μ€μ μ΄λ©° μ€μ½νλ‘ ννλμ§ μμ΅λλ€. λ²μ λ°μ΄λ©΄ μ€μ½νμ 무κ΄νκ² 403 μ
λλ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λ©λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²νμΈμ. ## μ±κ³΅ μλ΅ λ΄ν¬ `/v2` μ λͺ¨λ 2xx λ³Έλ¬Έμ `{ \"data\": β¦ }` μ
λλ€. λ¨μΌ 리μμ€λ λͺ©λ‘μ΄λ κ°μ΅λλ€. λͺ©λ‘μ²λΌ λΆκ° μ λ³΄κ° μλ μλ΅μ `meta` κ° ν¨κ» μ€λ¦½λλ€ β μ: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"β¦\" } }`. λΆκ° μ λ³΄κ° μμΌλ©΄ `meta` ν€λ μμ λκ°μ§ μμ΅λλ€(λΉ κ°μ²΄λ₯Ό μ£μ§ μμ΅λλ€). λ΄ν¬λ₯Ό μ°μ§ μλ νλ©΄μ λμ
λλ€. `/oauth/_*` μ `/.well-known/_*` λ κ°κ° RFC 6749Β·RFC 8414Β·RFC 9728 μ΄ μ΅μμ νλλ₯Ό κ·μ νκ³ , νμΌ λ΄μ© μλ΅μ λ³Έλ¬Έμ΄ JSON μ΄ μλλλ€. μλ¬ μλ΅μλ λ΄ν¬λ₯Ό μμ°μ§ μμ΅λλ€ β μλ problem+json μ΄ λ¨λ
μΌλ‘ μ±
μμ§λλ€. ## μ‘°κ±΄λΆ μμ² (ETag) `/v2` μ λͺ¨λ `GET` μλ΅μ weak `ETag`(`W/\"β¦\"`)κ° μ€λ¦½λλ€. λ°μ κ°μ λ€μ μμ²μ `If-None-Match` ν€λλ‘ λ보λ΄λ©΄, λ΄μ©μ΄ κ·Έλλ‘μΌ λ `304 Not Modified` λ₯Ό λ³Έλ¬Έ μμ΄ λ°μ΅λλ€. κ²°κ³Όκ° λκΈ°λ₯Ό κΈ°λ€λ¦¬λ©° κ°μ μμμ λ°λ³΅ μ‘°ννλ μ°λμ΄λΌλ©΄ μ΄ ν€λ νλλ‘ μ μ‘λμ΄ μ¬λΌμ§λλ€. ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json` μ
λλ€. **HTTP status + `type` URI** λ‘ λΆκΈ°νμΈμ. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλνκ³ , `false`λ©΄ μμ²μ κ³ μ³μΌ ν©λλ€. - `traceId`: μμ² μΆμ id. `X-Correlation-Id` μλ΅ ν€λμ κ°μ κ°μ
λλ€ β λ¬Έμν λ μ΄ κ°μ 첨λΆνμΈμ. - `correlationId`: `traceId` μ κ°μ κ°μ μ μ΄λ¦. κΈ°μ‘΄ μ°λ νΈνμΌλ‘ ν¨κ» μ€λ¦½λλ€. μ μ°λμ `traceId` λ₯Ό μ½μΌμΈμ. - `invalid-params`: κ²μ¦ μ€ν¨(400 `β¦/validation-failed`) μ μλ° νλ κ²½λ‘ λͺ©λ‘(RFC 9457 νμ₯, κ° μμ). `type` μ `https://problems.cmarket.io/partner/<slug>` ννμ **μμ μλ³μ**μ
λλ€. RFC 9457 Β§3.1.1 μ΄ νμ©νλ λλ‘ μ΄ URI λ **μμ°Έμ‘°(dereference)λμ§ μμ΅λλ€** β λΈλΌμ°μ λ‘ μ΄μ§ λ§κ³ λ¬Έμμ΄ λΉκ΅λ‘λ§ μ°μΈμ. slug λͺ©λ‘κ³Ό μλ―Έλ κ° μλν¬μΈνΈμ μλ΅ μ€λͺ
μ status λ³λ‘ μ ν μμ΅λλ€. ### λ©±λ±μ± μλ°: 409 μ 422 μ μ°¨μ΄ - `409` `β¦/idempotency-key-conflict` β κ°μ ν€μ **μ μμ²μ΄ μμ§ μ²λ¦¬ μ€**μ
λλ€. μ μ λ€ κ°μ ν€λ‘ λ€μ λΆλ₯΄λ©΄ κ·Έ κ²°κ³Όλ₯Ό λ°μ΅λλ€. - `422` `β¦/idempotency-key-reused` β κ°μ ν€λ₯Ό **λ€λ₯Έ body** λ‘ λ³΄λμ΅λλ€. μ¬μλν΄λ μμν κ°μ μ€ν¨μ΄λ μ ν€λ₯Ό μ°κ±°λ body λ₯Ό λλ리μΈμ. ## Rate Limit μ μ **60 μμ²/λΆ per `client_id`**, ν ν° λ°κΈ(`/oauth/token`)μ **5 μμ²/λΆ** μ
λλ€. μ΄κ³Ό μ `429`(`type: β¦/too-many-requests`). μΏΌν°λ λ κ°μ§ νκΈ°λ‘ ν¨κ» λκ°λλ€ β μ κ· μ°λμ νμ€ νλλ₯Ό μ°μΈμ. - **νμ€**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (μ μ±
) Β· `RateLimit: \"default\";r=59;t=42` (μλ r, 리μ
κΉμ§ t μ΄) - **λ κ±°μ**(κ΄μ©): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. κΈ°μ‘΄ μ°λ νΈνμ μν΄ μ μ§ν©λλ€. `429` μμλ `Retry-After`(μ΄)κ° μ°μ ν©λλ€. λλ λκΈ°ν(νλͺ© λ¨μ λ°λ³΅ λ±λ‘ λ±)λ `Retry-After` λ§νΌ backoff ν μ¬μλνμΈμ. ## μΆμ μμ²μ `X-Correlation-Id` ν€λλ₯Ό μ€μΌλ©΄ κ·Έλλ‘ echo λκ³ , μμΌλ©΄ μλ²κ° λ°κΈν©λλ€. λͺ¨λ μλ΅(μ±κ³΅/μλ¬)μ `X-Correlation-Id` κ° μ€λ¦½λλ€. ## μ λ°©νΈν β λͺ¨λ₯΄λ νλμ κ°μμ κΉ¨μ§μ§ μκ² λ€μ μ
μ breaking λ³κ²½μΌλ‘ λ³΄μ§ μμΌλ©° minor 릴리μ€μμ μκ³ μμ΄ μΌμ΄λ©λλ€. μ΄ μ μ λ‘ κ΅¬ννμΈμ. - **μ ν νλ μΆκ°**: λͺ¨λ₯΄λ νλλ 무μνμΈμ. μ격 νμ(unknown key κ±°λΆ)λ₯Ό μ°μ§ λ§μΈμ. - **enum κ° μΆκ°**: μνΒ·λμ°°λ°©λ² λ±μ μ κ°μ΄ μκΉλλ€. λͺ¨λ₯΄λ κ°μ λ§λλ©΄ μμΈλ₯Ό λμ§μ§ λ§κ³ μλ¬Έ λ¬Έμμ΄μ 보쑴νμΈμ. - **problem `type` slug μΆκ°**: λͺ¨λ₯΄λ slug μ **HTTP status λ‘ ν΄λ°±**ν΄ λΆκΈ°νμΈμ. ## λ²μ μλͺ
(deprecation/sunset) - **_/v2** breaking λ³κ²½μ CHANGELOG SemVer(major bump)μ `Deprecation`/`Sunset` ν€λλ‘ ν΅μ§ν©λλ€. μ΄ ν€λλ₯Ό λͺ¨λν°λ§νμΈμ.
|
|
6
6
|
*
|
|
7
|
-
* The version of the OpenAPI document: 36.1.
|
|
7
|
+
* The version of the OpenAPI document: 36.1.1
|
|
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).
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
* CMARKET V6 Partner API
|
|
5
5
|
* μΈλΆ ERP μ°λμ© RESTful API. ## μΈμ¦ OAuth2 Bearer JWT (`client_credentials` νλ‘μ°). `/oauth/token` μμ ν ν°μ λ°κΈλ°μ `Authorization: Bearer <token>` ν€λλ‘ μ€μΌμΈμ. ## κΆν β λ κ°μ λ
립λ μΆ `403` μ λ§λ¬λ€λ©΄ λ μ€ μ΄λ μΆμ κ±Έλ¦° κ²μΈμ§ λ¨Όμ ꡬλΆνμΈμ. - **μ€μ½ν** = *무μμ ν μ μλ*. ν ν°μ λΆμ¬λ `bids:read`Β·`contracts:write` λ±μ
λλ€. 미보μ μ `β¦/insufficient-scope`. - **λν λ²μ** = *λꡬμ λ°μ΄ν°λ₯Ό λ€λ£° μ μλ*. API ν€ μ€μ μ΄λ©° μ€μ½νλ‘ ννλμ§ μμ΅λλ€. λ²μ λ°μ΄λ©΄ μ€μ½νμ 무κ΄νκ² 403 μ
λλ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λ©λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²νμΈμ. ## μ±κ³΅ μλ΅ λ΄ν¬ `/v2` μ λͺ¨λ 2xx λ³Έλ¬Έμ `{ \"data\": β¦ }` μ
λλ€. λ¨μΌ 리μμ€λ λͺ©λ‘μ΄λ κ°μ΅λλ€. λͺ©λ‘μ²λΌ λΆκ° μ λ³΄κ° μλ μλ΅μ `meta` κ° ν¨κ» μ€λ¦½λλ€ β μ: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"β¦\" } }`. λΆκ° μ λ³΄κ° μμΌλ©΄ `meta` ν€λ μμ λκ°μ§ μμ΅λλ€(λΉ κ°μ²΄λ₯Ό μ£μ§ μμ΅λλ€). λ΄ν¬λ₯Ό μ°μ§ μλ νλ©΄μ λμ
λλ€. `/oauth/_*` μ `/.well-known/_*` λ κ°κ° RFC 6749Β·RFC 8414Β·RFC 9728 μ΄ μ΅μμ νλλ₯Ό κ·μ νκ³ , νμΌ λ΄μ© μλ΅μ λ³Έλ¬Έμ΄ JSON μ΄ μλλλ€. μλ¬ μλ΅μλ λ΄ν¬λ₯Ό μμ°μ§ μμ΅λλ€ β μλ problem+json μ΄ λ¨λ
μΌλ‘ μ±
μμ§λλ€. ## μ‘°κ±΄λΆ μμ² (ETag) `/v2` μ λͺ¨λ `GET` μλ΅μ weak `ETag`(`W/\"β¦\"`)κ° μ€λ¦½λλ€. λ°μ κ°μ λ€μ μμ²μ `If-None-Match` ν€λλ‘ λ보λ΄λ©΄, λ΄μ©μ΄ κ·Έλλ‘μΌ λ `304 Not Modified` λ₯Ό λ³Έλ¬Έ μμ΄ λ°μ΅λλ€. κ²°κ³Όκ° λκΈ°λ₯Ό κΈ°λ€λ¦¬λ©° κ°μ μμμ λ°λ³΅ μ‘°ννλ μ°λμ΄λΌλ©΄ μ΄ ν€λ νλλ‘ μ μ‘λμ΄ μ¬λΌμ§λλ€. ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json` μ
λλ€. **HTTP status + `type` URI** λ‘ λΆκΈ°νμΈμ. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλνκ³ , `false`λ©΄ μμ²μ κ³ μ³μΌ ν©λλ€. - `traceId`: μμ² μΆμ id. `X-Correlation-Id` μλ΅ ν€λμ κ°μ κ°μ
λλ€ β λ¬Έμν λ μ΄ κ°μ 첨λΆνμΈμ. - `correlationId`: `traceId` μ κ°μ κ°μ μ μ΄λ¦. κΈ°μ‘΄ μ°λ νΈνμΌλ‘ ν¨κ» μ€λ¦½λλ€. μ μ°λμ `traceId` λ₯Ό μ½μΌμΈμ. - `invalid-params`: κ²μ¦ μ€ν¨(400 `β¦/validation-failed`) μ μλ° νλ κ²½λ‘ λͺ©λ‘(RFC 9457 νμ₯, κ° μμ). `type` μ `https://problems.cmarket.io/partner/<slug>` ννμ **μμ μλ³μ**μ
λλ€. RFC 9457 Β§3.1.1 μ΄ νμ©νλ λλ‘ μ΄ URI λ **μμ°Έμ‘°(dereference)λμ§ μμ΅λλ€** β λΈλΌμ°μ λ‘ μ΄μ§ λ§κ³ λ¬Έμμ΄ λΉκ΅λ‘λ§ μ°μΈμ. slug λͺ©λ‘κ³Ό μλ―Έλ κ° μλν¬μΈνΈμ μλ΅ μ€λͺ
μ status λ³λ‘ μ ν μμ΅λλ€. ### λ©±λ±μ± μλ°: 409 μ 422 μ μ°¨μ΄ - `409` `β¦/idempotency-key-conflict` β κ°μ ν€μ **μ μμ²μ΄ μμ§ μ²λ¦¬ μ€**μ
λλ€. μ μ λ€ κ°μ ν€λ‘ λ€μ λΆλ₯΄λ©΄ κ·Έ κ²°κ³Όλ₯Ό λ°μ΅λλ€. - `422` `β¦/idempotency-key-reused` β κ°μ ν€λ₯Ό **λ€λ₯Έ body** λ‘ λ³΄λμ΅λλ€. μ¬μλν΄λ μμν κ°μ μ€ν¨μ΄λ μ ν€λ₯Ό μ°κ±°λ body λ₯Ό λλ리μΈμ. ## Rate Limit μ μ **60 μμ²/λΆ per `client_id`**, ν ν° λ°κΈ(`/oauth/token`)μ **5 μμ²/λΆ** μ
λλ€. μ΄κ³Ό μ `429`(`type: β¦/too-many-requests`). μΏΌν°λ λ κ°μ§ νκΈ°λ‘ ν¨κ» λκ°λλ€ β μ κ· μ°λμ νμ€ νλλ₯Ό μ°μΈμ. - **νμ€**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (μ μ±
) Β· `RateLimit: \"default\";r=59;t=42` (μλ r, 리μ
κΉμ§ t μ΄) - **λ κ±°μ**(κ΄μ©): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. κΈ°μ‘΄ μ°λ νΈνμ μν΄ μ μ§ν©λλ€. `429` μμλ `Retry-After`(μ΄)κ° μ°μ ν©λλ€. λλ λκΈ°ν(νλͺ© λ¨μ λ°λ³΅ λ±λ‘ λ±)λ `Retry-After` λ§νΌ backoff ν μ¬μλνμΈμ. ## μΆμ μμ²μ `X-Correlation-Id` ν€λλ₯Ό μ€μΌλ©΄ κ·Έλλ‘ echo λκ³ , μμΌλ©΄ μλ²κ° λ°κΈν©λλ€. λͺ¨λ μλ΅(μ±κ³΅/μλ¬)μ `X-Correlation-Id` κ° μ€λ¦½λλ€. ## μ λ°©νΈν β λͺ¨λ₯΄λ νλμ κ°μμ κΉ¨μ§μ§ μκ² λ€μ μ
μ breaking λ³κ²½μΌλ‘ λ³΄μ§ μμΌλ©° minor 릴리μ€μμ μκ³ μμ΄ μΌμ΄λ©λλ€. μ΄ μ μ λ‘ κ΅¬ννμΈμ. - **μ ν νλ μΆκ°**: λͺ¨λ₯΄λ νλλ 무μνμΈμ. μ격 νμ(unknown key κ±°λΆ)λ₯Ό μ°μ§ λ§μΈμ. - **enum κ° μΆκ°**: μνΒ·λμ°°λ°©λ² λ±μ μ κ°μ΄ μκΉλλ€. λͺ¨λ₯΄λ κ°μ λ§λλ©΄ μμΈλ₯Ό λμ§μ§ λ§κ³ μλ¬Έ λ¬Έμμ΄μ 보쑴νμΈμ. - **problem `type` slug μΆκ°**: λͺ¨λ₯΄λ slug μ **HTTP status λ‘ ν΄λ°±**ν΄ λΆκΈ°νμΈμ. ## λ²μ μλͺ
(deprecation/sunset) - **_/v2** breaking λ³κ²½μ CHANGELOG SemVer(major bump)μ `Deprecation`/`Sunset` ν€λλ‘ ν΅μ§ν©λλ€. μ΄ ν€λλ₯Ό λͺ¨λν°λ§νμΈμ.
|
|
6
6
|
*
|
|
7
|
-
* The version of the OpenAPI document: 36.1.
|
|
7
|
+
* The version of the OpenAPI document: 36.1.1
|
|
8
8
|
* Contact: semo.io.kr@gmail.com
|
|
9
9
|
*
|
|
10
10
|
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
|
package/models/bid-bond-dto.ts
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
* CMARKET V6 Partner API
|
|
5
5
|
* μΈλΆ ERP μ°λμ© RESTful API. ## μΈμ¦ OAuth2 Bearer JWT (`client_credentials` νλ‘μ°). `/oauth/token` μμ ν ν°μ λ°κΈλ°μ `Authorization: Bearer <token>` ν€λλ‘ μ€μΌμΈμ. ## κΆν β λ κ°μ λ
립λ μΆ `403` μ λ§λ¬λ€λ©΄ λ μ€ μ΄λ μΆμ κ±Έλ¦° κ²μΈμ§ λ¨Όμ ꡬλΆνμΈμ. - **μ€μ½ν** = *무μμ ν μ μλ*. ν ν°μ λΆμ¬λ `bids:read`Β·`contracts:write` λ±μ
λλ€. 미보μ μ `β¦/insufficient-scope`. - **λν λ²μ** = *λꡬμ λ°μ΄ν°λ₯Ό λ€λ£° μ μλ*. API ν€ μ€μ μ΄λ©° μ€μ½νλ‘ ννλμ§ μμ΅λλ€. λ²μ λ°μ΄λ©΄ μ€μ½νμ 무κ΄νκ² 403 μ
λλ€. λν λ²μλ ν€λ§λ€ λ μ€ νλλ‘ μ€μ λ©λλ€ β **μμ κ·Έλ£Ή μ μ**(κΈ°κ΄ ν€. μ¬μ
μ²Β·λΆμ κ³μ μ΄ μλ‘ μ겨λ μλ ν¬ν¨) λλ **μ§μ λ°μ£Όμ² λͺ©λ‘**(κ³μ½μΌλ‘ ν©μλ λͺ©λ‘). λ²μλ₯Ό λνμΌ νλ©΄ μ€μ½νκ° μλλΌ ν€ μ€μ λ³κ²½μ μμ²νμΈμ. ## μ±κ³΅ μλ΅ λ΄ν¬ `/v2` μ λͺ¨λ 2xx λ³Έλ¬Έμ `{ \"data\": β¦ }` μ
λλ€. λ¨μΌ 리μμ€λ λͺ©λ‘μ΄λ κ°μ΅λλ€. λͺ©λ‘μ²λΌ λΆκ° μ λ³΄κ° μλ μλ΅μ `meta` κ° ν¨κ» μ€λ¦½λλ€ β μ: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"β¦\" } }`. λΆκ° μ λ³΄κ° μμΌλ©΄ `meta` ν€λ μμ λκ°μ§ μμ΅λλ€(λΉ κ°μ²΄λ₯Ό μ£μ§ μμ΅λλ€). λ΄ν¬λ₯Ό μ°μ§ μλ νλ©΄μ λμ
λλ€. `/oauth/_*` μ `/.well-known/_*` λ κ°κ° RFC 6749Β·RFC 8414Β·RFC 9728 μ΄ μ΅μμ νλλ₯Ό κ·μ νκ³ , νμΌ λ΄μ© μλ΅μ λ³Έλ¬Έμ΄ JSON μ΄ μλλλ€. μλ¬ μλ΅μλ λ΄ν¬λ₯Ό μμ°μ§ μμ΅λλ€ β μλ problem+json μ΄ λ¨λ
μΌλ‘ μ±
μμ§λλ€. ## μ‘°κ±΄λΆ μμ² (ETag) `/v2` μ λͺ¨λ `GET` μλ΅μ weak `ETag`(`W/\"β¦\"`)κ° μ€λ¦½λλ€. λ°μ κ°μ λ€μ μμ²μ `If-None-Match` ν€λλ‘ λ보λ΄λ©΄, λ΄μ©μ΄ κ·Έλλ‘μΌ λ `304 Not Modified` λ₯Ό λ³Έλ¬Έ μμ΄ λ°μ΅λλ€. κ²°κ³Όκ° λκΈ°λ₯Ό κΈ°λ€λ¦¬λ©° κ°μ μμμ λ°λ³΅ μ‘°ννλ μ°λμ΄λΌλ©΄ μ΄ ν€λ νλλ‘ μ μ‘λμ΄ μ¬λΌμ§λλ€. ## μλ¬ (RFC 9457 problem+json) λͺ¨λ μλ¬ μλ΅μ `application/problem+json` μ
λλ€. **HTTP status + `type` URI** λ‘ λΆκΈ°νμΈμ. - `retryable`(boolean): μλ μ¬μλ μμ μ¬λΆ. `true`(429Β·5xx transient)λ©΄ backoff ν μ¬μλνκ³ , `false`λ©΄ μμ²μ κ³ μ³μΌ ν©λλ€. - `traceId`: μμ² μΆμ id. `X-Correlation-Id` μλ΅ ν€λμ κ°μ κ°μ
λλ€ β λ¬Έμν λ μ΄ κ°μ 첨λΆνμΈμ. - `correlationId`: `traceId` μ κ°μ κ°μ μ μ΄λ¦. κΈ°μ‘΄ μ°λ νΈνμΌλ‘ ν¨κ» μ€λ¦½λλ€. μ μ°λμ `traceId` λ₯Ό μ½μΌμΈμ. - `invalid-params`: κ²μ¦ μ€ν¨(400 `β¦/validation-failed`) μ μλ° νλ κ²½λ‘ λͺ©λ‘(RFC 9457 νμ₯, κ° μμ). `type` μ `https://problems.cmarket.io/partner/<slug>` ννμ **μμ μλ³μ**μ
λλ€. RFC 9457 Β§3.1.1 μ΄ νμ©νλ λλ‘ μ΄ URI λ **μμ°Έμ‘°(dereference)λμ§ μμ΅λλ€** β λΈλΌμ°μ λ‘ μ΄μ§ λ§κ³ λ¬Έμμ΄ λΉκ΅λ‘λ§ μ°μΈμ. slug λͺ©λ‘κ³Ό μλ―Έλ κ° μλν¬μΈνΈμ μλ΅ μ€λͺ
μ status λ³λ‘ μ ν μμ΅λλ€. ### λ©±λ±μ± μλ°: 409 μ 422 μ μ°¨μ΄ - `409` `β¦/idempotency-key-conflict` β κ°μ ν€μ **μ μμ²μ΄ μμ§ μ²λ¦¬ μ€**μ
λλ€. μ μ λ€ κ°μ ν€λ‘ λ€μ λΆλ₯΄λ©΄ κ·Έ κ²°κ³Όλ₯Ό λ°μ΅λλ€. - `422` `β¦/idempotency-key-reused` β κ°μ ν€λ₯Ό **λ€λ₯Έ body** λ‘ λ³΄λμ΅λλ€. μ¬μλν΄λ μμν κ°μ μ€ν¨μ΄λ μ ν€λ₯Ό μ°κ±°λ body λ₯Ό λλ리μΈμ. ## Rate Limit μ μ **60 μμ²/λΆ per `client_id`**, ν ν° λ°κΈ(`/oauth/token`)μ **5 μμ²/λΆ** μ
λλ€. μ΄κ³Ό μ `429`(`type: β¦/too-many-requests`). μΏΌν°λ λ κ°μ§ νκΈ°λ‘ ν¨κ» λκ°λλ€ β μ κ· μ°λμ νμ€ νλλ₯Ό μ°μΈμ. - **νμ€**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (μ μ±
) Β· `RateLimit: \"default\";r=59;t=42` (μλ r, 리μ
κΉμ§ t μ΄) - **λ κ±°μ**(κ΄μ©): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. κΈ°μ‘΄ μ°λ νΈνμ μν΄ μ μ§ν©λλ€. `429` μμλ `Retry-After`(μ΄)κ° μ°μ ν©λλ€. λλ λκΈ°ν(νλͺ© λ¨μ λ°λ³΅ λ±λ‘ λ±)λ `Retry-After` λ§νΌ backoff ν μ¬μλνμΈμ. ## μΆμ μμ²μ `X-Correlation-Id` ν€λλ₯Ό μ€μΌλ©΄ κ·Έλλ‘ echo λκ³ , μμΌλ©΄ μλ²κ° λ°κΈν©λλ€. λͺ¨λ μλ΅(μ±κ³΅/μλ¬)μ `X-Correlation-Id` κ° μ€λ¦½λλ€. ## μ λ°©νΈν β λͺ¨λ₯΄λ νλμ κ°μμ κΉ¨μ§μ§ μκ² λ€μ μ
μ breaking λ³κ²½μΌλ‘ λ³΄μ§ μμΌλ©° minor 릴리μ€μμ μκ³ μμ΄ μΌμ΄λ©λλ€. μ΄ μ μ λ‘ κ΅¬ννμΈμ. - **μ ν νλ μΆκ°**: λͺ¨λ₯΄λ νλλ 무μνμΈμ. μ격 νμ(unknown key κ±°λΆ)λ₯Ό μ°μ§ λ§μΈμ. - **enum κ° μΆκ°**: μνΒ·λμ°°λ°©λ² λ±μ μ κ°μ΄ μκΉλλ€. λͺ¨λ₯΄λ κ°μ λ§λλ©΄ μμΈλ₯Ό λμ§μ§ λ§κ³ μλ¬Έ λ¬Έμμ΄μ 보쑴νμΈμ. - **problem `type` slug μΆκ°**: λͺ¨λ₯΄λ slug μ **HTTP status λ‘ ν΄λ°±**ν΄ λΆκΈ°νμΈμ. ## λ²μ μλͺ
(deprecation/sunset) - **_/v2** breaking λ³κ²½μ CHANGELOG SemVer(major bump)μ `Deprecation`/`Sunset` ν€λλ‘ ν΅μ§ν©λλ€. μ΄ ν€λλ₯Ό λͺ¨λν°λ§νμΈμ.
|
|
6
6
|
*
|
|
7
|
-
* The version of the OpenAPI document: 36.1.
|
|
7
|
+
* The version of the OpenAPI document: 36.1.1
|
|
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).
|