메인 콘텐츠로 건너뛰기

​
Endpoint

GET /v1/analyses/{profileId}/analyses

​
요청

curl -X GET "http://client-omni-api.argosidentity.com/v1/analyses/{profileId}/analyses?status=completed&sort=createdAt&order=desc&limit=20" \
  -H "x-api-key: your-api-key-here"

​
쿼리 파라미터

파라미터타입필수기본값설명
statusstring분석 상태로 필터링: pending, processing, completed, failed
sortstringcreatedAt정렬 기준 필드: createdAt, completedAt, requestedAt
orderstringdesc정렬 순서: asc, desc
cursorstring이전 응답에서 반환된 페이지네이션 커서
limitnumber20페이지당 결과 수 (최대 50)

​
응답 (200 OK)

{
  "count": 3,
  "nextCursor": "eyJjcmVhdGVkQXQiOiIyMDI1LTA1LTAxVDEyOjAwOjAwWiJ9",
  "items": [
    {
      "id": "analysis_abc123",
      "profileId": "profile_xyz789",
      "folderId": null,
      "engineId": null,
      "status": "completed",
      "verificationStatus": "approved",
      "riskAssessment": {
        "riskLevel": "low",
        "riskScore": 12
      },
      "processingTimeMs": 4523,
      "error": null,
      "requestedAt": "2025-05-01T12:00:00Z",
      "completedAt": "2025-05-01T12:00:04Z",
      "createdAt": "2025-05-01T12:00:00Z"
    }
  ]
}

​
응답 필드

​
count
number
필수
현재 응답 페이지의 총 아이템 수
​
nextCursor
string | null
필수
다음 페이지를 위한 커서입니다. 다음 요청 시 cursor 쿼리 파라미터로 전달하세요. 더 이상 결과가 없으면 null입니다.
​
items
array
필수
분석 요약 객체 배열

​
아이템 필드

​
id
string
필수
분석 고유 ID (analysis_ 접두사)
​
profileId
string
필수
이 분석이 속한 프로필 ID
​
folderId
string | null
필수
대상 폴더 ID (전체 프로필 분석 시 null)
​
engineId
string | null
필수
사용된 엔진 ID (기본 엔진 사용 시 null)
​
status
string
필수
분석 상태: pending / processing / completed / failed
​
verificationStatus
string
필수
최종 검증 상태: pending_review / approved / rejected
​
riskAssessment
object
필수
위험도 평가 요약
​
riskAssessment.riskLevel
string
필수
위험 등급: low / medium / high
​
riskAssessment.riskScore
number
필수
위험 점수 (0–100, 높을수록 위험)
​
processingTimeMs
number
필수
처리 소요 시간 (밀리초)
​
error
string | null
필수
에러 메시지 (정상 완료 시 null)
​
requestedAt
string
필수
분석 요청 시각 (ISO 8601)
​
completedAt
string | null
필수
분석 완료 시각 (ISO 8601, 미완료 시 null)
​
createdAt
string
필수
레코드 생성 시각 (ISO 8601)

​
페이지네이션

이 엔드포인트는 커서 기반 페이지네이션을 사용합니다. 모든 결과를 조회하려면 다음과 같이 합니다:
  1. cursor 파라미터 없이 첫 번째 요청을 보냅니다.
  2. 응답에 null이 아닌 nextCursor가 포함된 경우, 다음 요청의 cursor 쿼리 파라미터로 전달합니다.
  3. nextCursor가 null이 될 때까지 반복합니다.
목록 엔드포인트는 요약 객체를 반환합니다. 추출 데이터, 검증 결과, 감사 로그를 포함한 전체 분석 상세 정보를 조회하려면 GET /analyses/:analysisId를 사용하세요.

​
에러 코드

StatusCode설명
404PROFILE_NOT_FOUND지정된 프로필을 찾을 수 없습니다