빠른 시작 - ARGOS Identity

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

사전 요구사항

Omni API 키 (여기서 발급)
최소 하나의 워크플로우가 설정된 프로젝트

아직 워크플로우를 설정하지 않았다면, 아래 단계를 진행하기 전에 Omni 대시보드에서 워크플로우를 먼저 만드세요. 전체 절차는 워크플로우 생성하기 가이드를 참조하세요.

엔드투엔드 흐름

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

먼저 프로젝트를 조회하여 사용 가능한 워크플로우를 확인합니다.

curl -X GET "https://client-omni-api.argosidentity.com/v1/projects/{projectId}" \
  -H "x-api-key: your-api-key-here"

응답에서 사용할 workflowId를 확인하세요.

프로필 생성

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

curl -X POST "https://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와 기본 폴더가 포함됩니다.

아이템 업로드

기본 폴더에 문서를 업로드합니다. Omni는 이미지(JPG, PNG), PDF, 오피스 문서를 지원합니다.

curl -X POST "https://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.

처리 대기

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

curl -X GET "https://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 상태여야 합니다.

분석 실행

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

curl -X POST "https://client-omni-api.argosidentity.com/v1/profiles/{profileId}/analyze" \
  -H "x-api-key: your-api-key-here"

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

결과 조회

분석이 완료되면 구조화된 결과를 조회합니다.

curl -X GET "https://client-omni-api.argosidentity.com/v1/profiles/{profileId}" \
  -H "x-api-key: your-api-key-here"

extractedData는 워크플로우의 출력 스키마를 따릅니다. 이와 별개로 응답 최상위에는 시스템 판정 verificationStatus(verified, pending_review, rejected 중 하나)가 항상 포함됩니다.

다음 단계

대시보드

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

API 참조

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

​사전 요구사항

​엔드투엔드 흐름

​다음 단계

대시보드

API 참조

사전 요구사항

엔드투엔드 흐름

다음 단계