POST /analyses/:profileId/analyze - ARGOS Identity

분석은 비동기로 실행됩니다. 이 엔드포인트는 분석 ID만 즉시 돌려주고, 결과는 분석 상세 조회로 폴링해 받습니다.

엔드포인트

POST /v1/analyses/{profileId}/analyze

요청

경로 파라미터

파라미터	타입	설명
`profileId`	`string`	분석할 프로파일 ID (`pf_` 접두사)

요청 본문

필드	타입	필수	설명
`targetItems`	`object[]`	필수	분석에 넣을 아이템 목록. 최소 1개
`targetItems[].itemId`	`string`	필수	아이템 ID (`item_` 접두사). 해당 프로파일에 속하고 `ACTIVE` 상태여야 함

curl -X POST "https://client-omni-api.argosidentity.com/v1/analyses/pf_0twd91ioowfr/analyze" \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "targetItems": [
      { "itemId": "item_ieoravdq3jp3" },
      { "itemId": "item_we03t42pxgbc" },
      { "itemId": "item_veliji1hm3ih" }
    ]
  }'

응답 (202 Accepted)

{
  "id": "analysis_lghgsxkorvoc"
}

필드	타입	설명
`id`	`string`	분석 ID (`analysis_` 접두사)

실행 조건과 제약

항목	내용
아이템 상태	대상 아이템이 모두 `ACTIVE`여야 함. 아니면 `400` `OMNI_2109`
동시 실행	프로파일당 1건. 진행 중에 다시 요청하면 `409` `OMNI_2201`
체험판 한도	프로젝트당 하루 10회. 초과하면 `429` `OMNI_2004`
보관 개수	프로파일당 최근 5건. 초과하면 가장 오래된 분석이 자동 삭제됨

실행 전에 아이템 상태 조회로 isRagReady가 true인지 확인하세요.

에러 코드

상태	코드	설명
400	`OMNI_2109`	아이템이 존재하지 않거나 이 프로파일 소속이 아님
404	`OMNI_3005`	프로파일을 찾을 수 없음
409	`OMNI_2201`	이 프로파일에 진행 중인 분석이 있음
429	`OMNI_2004`	체험판 프로젝트의 일일 분석 한도(10회) 초과

공통 에러(400 요청 검증 · 401 인증 · 403 권한 · 500 서버 오류)는 API 개요를 참조하세요.

⌘I