메인 콘텐츠로 건너뛰기

​
Endpoint

POST /v1/analyses/{profileId}/analyze

​
요청

curl -X POST "http://client-omni-api.argosidentity.com/v1/analyses/{profileId}/analyze" \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "targetItems": [
      { "itemId": "item_abc123" },
      { "itemId": "item_def456" }
    ]
  }'

​
요청 본문

​
targetItems
array
필수
분석에 포함할 아이템 배열입니다. 최소 하나 이상의 아이템을 포함해야 합니다.
​
targetItems[].itemId
string
필수
분석에 포함할 아이템 ID (item_ 접두사). 해당 아이템은 지정된 프로필에 속해야 하며 ACTIVE 상태여야 합니다.

​
응답 (202 Accepted)

{
  "id": "analysis_xyz789"
}
​
id
string
필수
분석 고유 ID (analysis_ 접두사). 이 ID를 GET /analyses/:analysisId에서 사용하여 분석 상태를 확인하고 결과를 조회할 수 있습니다.

​
주요 참고사항

분석은 비동기로 실행됩니다. 엔드포인트는 분석 ID를 즉시 반환합니다. GET /v1/analyses/:analysisId를 사용하여 상태를 폴링하고 완료 후 결과를 조회하세요.
프로필당 최대 5개의 분석이 보관됩니다. 이 한도를 초과하면 가장 오래된 분석이 자동으로 삭제되어 새 분석을 위한 공간을 확보합니다.
  • 모든 대상 아이템은 ACTIVE 상태여야 합니다. 다른 상태의 아이템은 거부됩니다.
  • 프로필당 한 번에 하나의 분석만 실행할 수 있습니다. 분석이 진행 중인 상태에서 두 번째 분석을 시작하려고 하면 409 에러가 반환됩니다.

​
에러 코드

StatusCode설명
400INVALID_ITEM_IDS하나 이상의 아이템이 존재하지 않거나 지정된 프로필에 속하지 않습니다
404PROFILE_NOT_FOUND지정된 프로필을 찾을 수 없습니다
409ANALYSIS_IN_PROGRESS해당 프로필에서 이미 분석이 진행 중입니다