> ## Documentation Index > Fetch the complete documentation index at: https://make.edicus.io/docs/llms.txt > Use this file to discover all available pages before exploring further. # 확정 주문 > 주문을 확정합니다. 프로젝트 상태가 `ordered`가 되고 인쇄용 고해상도 파일의 렌더링이 시작됩니다. **확정 이후에는 취소할 수 없습니다.** 반드시 잠정 주문 이후에 호출합니다. 잠정 주문 없이 호출하면 `409 project_not_ordering`입니다. ## OpenAPI ````yaml /api-reference/openapi.json post /v2/projects/{project_id}/order/definitive openapi: 3.1.0 info: title: Edicus Server API version: 1.1.5 description: >- Edicus 편집기 연동에 필요한 서버 API입니다. 토큰 발급, 프로젝트 조회, 주문 처리, 폰트와 상품 정보, 템플릿 등록을 다룹니다. ## 반드시 서버에서만 호출합니다 모든 엔드포인트는 `edicus-api-key` 헤더를 요구합니다. 이 키는 고객사 서버에만 두고 브라우저 코드나 공개 저장소에 넣지 않습니다. 브라우저에는 이 API로 발급받은 토큰만 내려보냅니다. ## 오류 응답 `api.edicus.io`는 실패를 4xx와 5xx 상태 코드로 알리고, body는 언제나 `{"error": {"code", "message", "details", "request_id"}}` 모양입니다. `error.code`로 분기합니다. 같은 `request_id`가 응답 헤더 `x-request-id`에도 실립니다. `resource-dot-edicusbase.appspot.com`은 방식이 다릅니다. 파라미터 누락은 `400`, 인증 실패는 `401`, 그 밖의 모든 실패는 `500`이고, body에 `error` 객체가 없습니다. ## 응답 형식 응답의 `content-type`은 `application/json`입니다. contact: name: 모션원 url: https://edicus.io servers: - url: https://api.edicus.io description: Server API 호스트 security: - edicusApiKey: [] tags: - name: Auth description: 토큰 발급 - name: Projects description: 프로젝트 조회, 삭제, 복제 - name: Orders description: 잠정 주문, 확정 주문, 취소 - name: Fonts description: 폰트 그룹과 폰트 목록 - name: Products description: 상품과 상품 카테고리 정보 - name: Templates description: 리소스 토큰과 템플릿 패키지 등록 - name: Resources description: 리소스 검색과 사용자 이미지 paths: /v2/projects/{project_id}/order/definitive: post: tags: - Orders summary: 확정 주문 description: >- 주문을 확정합니다. 프로젝트 상태가 `ordered`가 되고 인쇄용 고해상도 파일의 렌더링이 시작됩니다. **확정 이후에는 취소할 수 없습니다.** 반드시 잠정 주문 이후에 호출합니다. 잠정 주문 없이 호출하면 `409 project_not_ordering`입니다. operationId: createDefinitiveOrder parameters: - name: project_id in: path required: true description: 프로젝트 id schema: type: string minLength: 1 example: '-LiBngTbCFYNjcOVcxcY' - name: edicus-uid in: header required: true description: >- 고객사가 사용자에게 부여한 고유 id입니다. 1~70자이고 `a-z`, `A-Z`, `0-9`, `_`, `!`, `@`, `-`, `+`, `=`만 쓸 수 있습니다. 없거나 규칙을 어기면 `400 invalid_request`입니다. schema: type: string minLength: 1 maxLength: 70 pattern: ^[a-zA-Z0-9_!@\-+=]+$ example: kr46KCD8vWOnOGo8CBO7c6ctSge2 responses: '200': description: 주문이 확정됐습니다. content: application/json: schema: $ref: '#/components/schemas/DefinitiveOrderResult' example: order_id: 100023 status: ordered '400': description: >- `edicus-uid`가 없거나 형식 규칙을 어겼습니다. `error.code`는 `invalid_request`이고 `error.details.issues`에 어긋난 항목이 있습니다. content: application/json: schema: $ref: '#/components/schemas/ErrorBody' example: error: code: invalid_request message: 요청 형식이 맞지 않습니다 details: issues: - origin: string code: invalid_format format: regex pattern: ^[a-zA-Z0-9_!@\-+=]+$ path: - edicus-uid message: 'allowed: a-z A-Z 0-9 _ ! @ - + =' request_id: 4bf92f3577b34da6a3ce929d0e0e4736 '401': description: >- 인증 실패입니다. `error.code`는 `no_credentials`(자격 증명 헤더가 없음) 또는 `invalid_api_key`(API 키가 틀림)입니다. content: application/json: schema: $ref: '#/components/schemas/ErrorBody' examples: invalid_api_key: summary: invalid_api_key value: error: code: invalid_api_key message: edicus-api-key 값을 확인하세요 request_id: 4bf92f3577b34da6a3ce929d0e0e4736 no_credentials: summary: no_credentials value: error: code: no_credentials message: edicus-api-key 또는 edicus-id-token이 필요합니다 request_id: 4bf92f3577b34da6a3ce929d0e0e4736 '404': description: 프로젝트가 없습니다. `error.code`는 `project_not_found`입니다. content: application/json: schema: $ref: '#/components/schemas/ErrorBody' example: error: code: project_not_found message: 프로젝트가 없습니다 request_id: 4bf92f3577b34da6a3ce929d0e0e4736 '409': description: |- 확정할 수 없는 상태입니다. `error.code`는 다음 중 하나입니다. - `project_not_ordering`: 프로젝트가 잠정 주문(`ordering`) 상태가 아닙니다 - `order_id_missing`: 프로젝트에 주문 id가 기록돼 있지 않습니다 content: application/json: schema: $ref: '#/components/schemas/ErrorBody' examples: project_not_ordering: summary: project_not_ordering value: error: code: project_not_ordering message: 확정 주문 전에 잠정 주문이 필요합니다 (현재 editing) request_id: 4bf92f3577b34da6a3ce929d0e0e4736 order_id_missing: summary: order_id_missing value: error: code: order_id_missing message: 프로젝트에 주문 번호가 없습니다 request_id: 4bf92f3577b34da6a3ce929d0e0e4736 components: schemas: DefinitiveOrderResult: type: object properties: order_id: type: integer status: type: string enum: - ordered required: - order_id - status ErrorBody: type: object description: '`api.edicus.io`의 모든 4xx와 5xx 응답 body입니다. 클라이언트는 `error.code`로 분기합니다.' properties: error: type: object properties: code: type: string description: snake_case 오류 코드. 이 값으로 분기합니다 example: project_not_found message: type: string description: 사람이 읽는 설명입니다. 파싱하지 않습니다 details: type: object additionalProperties: true description: 선택. 검증 실패면 `issues`에 어긋난 항목 목록이, 상태 충돌이면 현재 상태가 들어 있습니다 request_id: type: string description: 요청 id입니다. 응답 헤더 `x-request-id`와 같은 값이고, 문의할 때 함께 알려 줍니다 required: - code - message - request_id required: - error example: error: code: project_not_found message: 프로젝트가 없습니다 request_id: 4bf92f3577b34da6a3ce929d0e0e4736 securitySchemes: edicusApiKey: type: apiKey in: header name: edicus-api-key description: 모션원에서 발급받는 API 키입니다. 외부에 유출되지 않도록 각별히 주의합니다. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.