메인 콘텐츠로 건너뛰기
이 가이드에서는 프로필 생성, 문서 업로드, 분석 실행까지의 전체 Omni API 흐름을 안내합니다.

​
사전 요구사항

  • Omni API 키 (여기서 발급)
  • 최소 하나의 워크플로우가 설정된 프로젝트
아직 워크플로우를 설정하지 않았다면, 아래 단계를 진행하기 전에 Omni 대시보드에서 워크플로우를 먼저 만드세요. 전체 절차는 워크플로우 생성하기 가이드를 참조하세요.

​
엔드투엔드 흐름

1

프로젝트 및 워크플로우 조회

먼저 프로젝트를 조회하여 사용 가능한 워크플로우를 확인합니다.
curl -X GET "http://client-omni-api.argosidentity.com/v1/projects/{projectId}" \
  -H "x-api-key: your-api-key-here"
응답에서 사용할 workflowId를 확인하세요.
2

프로필 생성

워크플로우 하위에 새 프로필을 생성합니다. 각 프로필은 하나의 검증 케이스를 나타냅니다.
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와 기본 폴더가 포함됩니다.
3

아이템 업로드

기본 폴더에 문서를 업로드합니다. Omni는 이미지(JPG, PNG), PDF, 오피스 문서를 지원합니다.
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"
최대 파일 크기: 10MB. 폴더당 최대 아이템: 5개. 지원 형식: JPG, PNG, PDF, TXT, DOC, DOCX, XLS, XLSX, BMP, TIFF, WEBP, CSV, HTML, MD.
4

처리 대기

업로드 후 아이템은 자동 처리(OCR, 텍스트 추출)를 거칩니다. 모든 아이템이 ACTIVE 상태가 될 때까지 폴링합니다.
curl -X GET "http://client-omni-api.argosidentity.com/v1/profiles/{profileId}/items/status" \
  -H "x-api-key: your-api-key-here"

{
  "total": 1,
  "pending": 0,
  "active": 1,
  "failed": 0
}
1초 간격으로 폴링하며 60초 타임아웃을 설정하세요. 분석 실행 전 모든 아이템이 ACTIVE 상태여야 합니다.
5

분석 실행

모든 아이템이 활성화되면 분석을 트리거합니다. 워크플로우의 정책, 엔진, 출력 스키마가 자동으로 적용됩니다.
curl -X POST "http://client-omni-api.argosidentity.com/v1/profiles/{profileId}/analyze" \
  -H "x-api-key: your-api-key-here"
분석은 비동기적으로 실행됩니다. 프로필을 폴링하여 결과를 확인하세요.
6

결과 조회

분석이 완료되면 구조화된 결과를 조회합니다.
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 중 하나)가 포함됩니다.

​
다음 단계

대시보드

대시보드에서 워크플로우, 정책, 엔진을 설정하는 방법을 알아보세요.

API 참조

전체 API 문서를 확인하세요.