> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bizmori.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 주문 상세 조회



## OpenAPI

````yaml /ko/api-reference/openapi.yaml get /api/v2/orders/{orderId}
openapi: 3.0.0
info:
  title: BIZ MORI API
  version: 2.0.0
  description: |
    BIZ MORI API는 디지털 콘텐츠 보호를 위한 네 가지 핵심 서비스를 제공합니다:
    - **Anti-AI**: 이미지를 AI 학습으로부터 보호
    - **Watermark Embed**: 이미지에 보이지 않는 디지털 워터마크 삽입
    - **Watermark Extract**: 이미지에서 워터마크 추출 및 검증
    - **AI Detection**: 이미지가 AI로 생성되었는지 감지
  contact:
    name: BIZ MORI 지원
    email: support@bizmori.com
servers:
  - url: https://api.bizmori.com
    description: 프로덕션
security: []
tags:
  - name: Anti-AI
    description: AI 학습 방지 이미지 보호 주문
  - name: Watermark Embed
    description: 워터마크 삽입 주문
  - name: Watermark Extract
    description: 워터마크 추출 주문
  - name: AI Detection
    description: AI 생성 이미지 감지 주문
  - name: Orders
    description: 주문 조회 및 관리
  - name: Webhooks
    description: 웹훅 설정 및 이벤트
paths:
  /api/v2/orders/{orderId}:
    get:
      tags:
        - Orders
      summary: 주문 상세 조회
      parameters:
        - in: path
          name: orderId
          required: true
          schema:
            type: string
          description: 주문 ID
      responses:
        '200':
          description: 성공
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/OrderDetail'
              examples:
                antiAi:
                  summary: Anti-AI 주문
                  value:
                    data:
                      type: antiAi
                      orderId: '1234567890123456789'
                      channel: api
                      thumbnailImageUrl: https://s3.amazonaws.com/...
                      status: complete
                      orderName: anti_ai_2026-03-12
                      fileCount: 3
                      createdAt: '2026-03-12T10:00:00.000Z'
                      updatedAt: '2026-03-12T10:05:00.000Z'
                      errors: null
                watermarkEmbed:
                  summary: 워터마크 삽입 주문
                  value:
                    data:
                      type: watermarkEmbed
                      orderId: '1234567890123456790'
                      channel: api
                      thumbnailImageUrl: https://s3.amazonaws.com/...
                      status: complete
                      orderName: wtr_embed_2026-03-12
                      fileCount: 2
                      createdAt: '2026-03-12T10:00:00.000Z'
                      updatedAt: '2026-03-12T10:03:00.000Z'
                      errors: null
                      watermarks:
                        - MORI-WTR-001
                        - MORI-WTR-002
                watermarkExtract:
                  summary: 워터마크 추출 주문
                  value:
                    data:
                      type: watermarkExtract
                      orderId: '1234567890123456791'
                      channel: api
                      thumbnailImageUrl: https://s3.amazonaws.com/...
                      status: detected
                      orderName: wtr_extract_2026-03-12
                      fileCount: 1
                      createdAt: '2026-03-12T10:00:00.000Z'
                      updatedAt: '2026-03-12T10:02:00.000Z'
                      errors: null
                      statusCode: detected
                      watermarkText: MORI-WTR-001
                aiDetection:
                  summary: AI Detection 주문
                  value:
                    data:
                      type: aiDetection
                      orderId: '1234567890123456792'
                      channel: api
                      thumbnailImageUrl: https://s3.amazonaws.com/...
                      originalImageUrl: https://s3.amazonaws.com/...
                      status: complete
                      orderName: ai_detection_2026-03-12
                      fileCount: 1
                      createdAt: '2026-03-12T10:00:00.000Z'
                      updatedAt: '2026-03-12T10:01:00.000Z'
                      errors: null
                      probability: 0.92
                      statusCode: likely_ai
                      heatmapUrl: https://s3.amazonaws.com/...
                      overlayUrl: https://s3.amazonaws.com/...
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      security:
        - BearerAuth: []
      x-codeSamples:
        - lang: curl
          label: cURL
          source: |-
            curl -X GET https://api.bizmori.com/api/v2/orders/ORDER_ID \
              -H "Authorization: Bearer YOUR_API_TOKEN"
        - lang: javascript
          label: JavaScript
          source: |-
            const orderId = 'ORDER_ID';
            const response = await fetch(
              `https://api.bizmori.com/api/v2/orders/${orderId}`,
              { headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' } }
            );
            const data = await response.json();
        - lang: python
          label: Python
          source: |-
            import requests

            order_id = 'ORDER_ID'
            response = requests.get(
                f'https://api.bizmori.com/api/v2/orders/{order_id}',
                headers={'Authorization': 'YOUR_API_KEY'}
            )
            data = response.json()
components:
  schemas:
    OrderDetail:
      type: object
      description: 주문 상세 정보
      properties:
        orderId:
          type: string
          description: 주문 ID
        orderName:
          type: string
          description: 주문 이름
        type:
          type: string
          enum:
            - antiAi
            - watermarkEmbed
            - watermarkExtract
            - aiDetection
          description: 주문 타입
        channel:
          type: string
          enum:
            - api
            - web
          description: 주문 채널
        status:
          type: string
          enum:
            - pending
            - inProgress
            - complete
            - failed
            - expired
          description: 주문 상태
        fileCount:
          type: integer
          description: 파일 수
        thumbnailImageUrl:
          type: string
          format: uri
          nullable: true
          description: >-
            썸네일 이미지 URL (프리사인드 URL, 1시간 유효). aiDetection 주문에서 generateThumbnail
            옵션 사용 시에만 반환됩니다. 만료 상태 시 null.
        originalImageUrl:
          type: string
          format: uri
          nullable: true
          description: >-
            원본 입력 이미지 다운로드 URL (프리사인드 URL, 1시간 유효). aiDetection 주문 전용. 만료 상태 시
            null.
        createdAt:
          type: string
          format: date-time
          description: 생성 시각
        updatedAt:
          type: string
          format: date-time
          description: 수정 시각
        errors:
          type: string
          nullable: true
          description: 에러 메시지 (실패 시)
        watermarks:
          type: array
          items:
            type: string
          description: 워터마크 텍스트 목록 (watermarkEmbed 주문 전용)
        watermarkText:
          type: string
          nullable: true
          description: 추출된 워터마크 텍스트 (watermarkExtract 주문 전용)
        probability:
          type: number
          nullable: true
          description: AI 감지 확률 (aiDetection 주문 전용)
        statusCode:
          type: string
          nullable: true
          description: |
            주문 타입별 상태 코드.
            **watermarkExtract 주문:**
            * detected - 워터마크 검출됨
            * undetected - 워터마크 미검출
            **aiDetection 주문** (probability 기반 자동 계산):
            * likely_real - probability < 0.25
            * uncertain_real - 0.25 <= probability < 0.5
            * uncertain_ai - 0.5 <= probability < 0.75
            * likely_ai - probability >= 0.75
            다른 주문 타입에서는 반환되지 않습니다.
        options:
          type: object
          nullable: true
          description: 주문 생성 시 설정한 옵션 (aiDetection 주문만)
          properties:
            generateHeatmap:
              type: boolean
              description: 히트맵 이미지 생성 여부
              example: true
            generateOverlay:
              type: boolean
              description: 오버레이 이미지 생성 여부
              example: true
            generateThumbnail:
              type: boolean
              description: 썸네일 이미지 생성 여부
              example: true
        heatmapUrl:
          type: string
          format: uri
          nullable: true
          description: >-
            AI 판별 히트맵 이미지 다운로드 URL (aiDetection 주문 전용, generateHeatmap 옵션 사용 시
            반환)
        overlayUrl:
          type: string
          format: uri
          nullable: true
          description: >-
            원본 위 히트맵 오버레이 이미지 다운로드 URL (aiDetection 주문 전용, generateOverlay 옵션 사용
            시 반환)
    ErrorResponse:
      type: object
      properties:
        code:
          type: string
          description: 에러 코드
  responses:
    Unauthorized:
      description: 인증 실패
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            code: AUTH_NOT_AUTHENTICATED
    NotFound:
      description: 리소스를 찾을 수 없음
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            code: RESOURCE_NOT_FOUND
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: 외부 클라이언트 접근을 위한 API 키

````