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

# 빠른 시작

> 몇 분 만에 첫 Omni 검증 워크플로우를 엔드투엔드로 실행해보세요.

이 가이드에서는 프로필 생성, 문서 업로드, 분석 실행까지의 전체 Omni API 흐름을 안내합니다.

## 사전 요구사항

* Omni API 키 ([여기서 발급](/ko/omni/getting-started/authentication))
* 최소 하나의 워크플로우가 설정된 프로젝트

<Info>
  아직 워크플로우를 설정하지 않았다면, 아래 단계를 진행하기 전에 Omni 대시보드에서 워크플로우를 먼저 만드세요. 전체 절차는 [워크플로우 생성하기](/ko/omni/guides/creating-a-workflow) 가이드를 참조하세요.
</Info>

## 엔드투엔드 흐름

<Steps>
  <Step title="프로젝트 및 워크플로우 조회">
    먼저 프로젝트를 조회하여 사용 가능한 워크플로우를 확인합니다.

    ```bash theme={null}
    curl -X GET "http://client-omni-api.argosidentity.com/v1/projects/{projectId}" \
      -H "x-api-key: your-api-key-here"
    ```

    응답에서 사용할 `workflowId`를 확인하세요.
  </Step>

  <Step title="프로필 생성">
    워크플로우 하위에 새 프로필을 생성합니다. 각 프로필은 하나의 검증 케이스를 나타냅니다.

    ```bash theme={null}
    curl -X POST "http://client-omni-api.argosidentity.com/v1/workflows/{workflowId}/profiles" \
      -H "x-api-key: your-api-key-here" \
      -H "Content-Type: application/json" \
      -d '{
        "name": "Acme Corp - KYB Verification"
      }'
    ```

    응답에 `profileId`와 기본 폴더가 포함됩니다.
  </Step>

  <Step title="아이템 업로드">
    기본 폴더에 문서를 업로드합니다. Omni는 이미지(JPG, PNG), PDF, 오피스 문서를 지원합니다.

    ```bash theme={null}
    curl -X POST "http://client-omni-api.argosidentity.com/v1/folders/{folderId}/items/upload" \
      -H "x-api-key: your-api-key-here" \
      -F "file=@/path/to/business-registration.pdf" \
      -F "type=file"
    ```

    <Note>
      최대 파일 크기: **10MB**. 폴더당 최대 아이템: **5개**. 지원 형식: JPG, PNG, PDF, TXT, DOC, DOCX, XLS, XLSX, BMP, TIFF, WEBP, CSV, HTML, MD.
    </Note>
  </Step>

  <Step title="처리 대기">
    업로드 후 아이템은 자동 처리(OCR, 텍스트 추출)를 거칩니다. 모든 아이템이 `ACTIVE` 상태가 될 때까지 폴링합니다.

    ```bash theme={null}
    curl -X GET "http://client-omni-api.argosidentity.com/v1/profiles/{profileId}/items/status" \
      -H "x-api-key: your-api-key-here"
    ```

    ```json theme={null}
    {
      "total": 1,
      "pending": 0,
      "active": 1,
      "failed": 0
    }
    ```

    <Tip>
      **1초 간격**으로 폴링하며 **60초 타임아웃**을 설정하세요. 분석 실행 전 모든 아이템이 `ACTIVE` 상태여야 합니다.
    </Tip>
  </Step>

  <Step title="분석 실행">
    모든 아이템이 활성화되면 분석을 트리거합니다. 워크플로우의 정책, 엔진, 출력 스키마가 자동으로 적용됩니다.

    ```bash theme={null}
    curl -X POST "http://client-omni-api.argosidentity.com/v1/profiles/{profileId}/analyze" \
      -H "x-api-key: your-api-key-here"
    ```

    분석은 비동기적으로 실행됩니다. 프로필을 폴링하여 결과를 확인하세요.
  </Step>

  <Step title="결과 조회">
    분석이 완료되면 구조화된 결과를 조회합니다.

    ```bash theme={null}
    curl -X GET "http://client-omni-api.argosidentity.com/v1/profiles/{profileId}" \
      -H "x-api-key: your-api-key-here"
    ```

    결과는 워크플로우의 출력 스키마를 따르며, `decision` 객체에 `verificationStatus`(`pending_review`, `approved`, `rejected` 중 하나)가 포함됩니다.
  </Step>
</Steps>

## 다음 단계

<CardGroup cols={2}>
  <Card title="대시보드" icon="sliders" href="/ko/omni/dashboard/overview">
    대시보드에서 워크플로우, 정책, 엔진을 설정하는 방법을 알아보세요.
  </Card>

  <Card title="API 참조" icon="code" href="/ko/omni/api-reference/overview">
    전체 API 문서를 확인하세요.
  </Card>
</CardGroup>