유효한 fullName과 birthDate 필드를 가진 승인된 제출만 온고잉 모니터링에 등록할 수 있습니다.
엔드포인트
POST /submission/aml/monitor/{worklistId}
기본 URL
https://rest-api.argosidentity.com/v3/submission/aml/monitor
https://test-api.argosidentity.com/dev/submission/aml/monitor
요청 헤더에 API 키를 포함하세요:
경로 매개변수
요청 본문
온고잉 모니터링에 등록할 제출 ID 배열 (1-25개 제출)
요청을 하는 관리자의 이메일 주소 (프로젝트의 관리자 목록에 등록되어 있어야 함)
요청 예시
curl -X POST 'https://rest-api.argosidentity.com/v3/submission/aml/monitor/{worklistId}' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {yourAPIKey}' \
-d '{
"submissionIds": [
"SUBMISSION_ID_00A",
"SUBMISSION_ID_01B",
"SUBMISSION_ID_02C"
],
"admin": "admin@company.com"
}'
성공 응답
{
"success" : true ,
"successCount" : 2 ,
"failedCount" : 1 ,
"successResults" : [
{
"submissionId" : "SUBMISSION_ID_00A" ,
"recordIds" : [
"RECORD_ID_00A"
],
"status" : "success"
},
{
"submissionId" : "SUBMISSION_ID_01B" ,
"recordIds" : [
"RECORD_ID_01B"
],
"status" : "success"
}
],
"failedResults" : [
{
"submissionId" : "SUBMISSION_ID_02C" ,
"recordIds" : [],
"status" : "failed" ,
"error" : "This submission is not approved: SUBMISSION_ID_02C"
}
]
}
응답 필드
성공적으로 처리된 제출 배열 처리 상태 (이 배열의 경우 항상 “success”)
처리에 실패한 제출 배열 빈 배열 (실패한 제출에 대해 생성된 레코드 없음)
처리 상태 (이 배열의 경우 항상 “failed”)
오류 응답
{
"errorCode" : "missing_required_parameters" ,
"errorMessage" : "Required parameters are missing: worklistId, submissionIds, projectId, alias"
}
오류 코드
오류 코드 HTTP 상태 설명 invalid_path400 잘못된 요청 메서드 invalid_project400 잘못된 프로젝트 ID 또는 온고잉 모니터링 옵션 비활성화 invalid_worklist400 워크리스트가 비활성 상태 invalid_submissionIds400 제출 ID 배열 형식 오류 또는 최대 개수 초과 invalid_admin400 프로젝트의 관리자 목록에서 관리자를 찾을 수 없음 missing_required_parameters400 필수 요청 매개변수 누락 all_submissions_failed500 모든 제출이 처리에 실패 processing_failed500 레코드 등록 또는 데이터 처리 실패 internal_server_error500 예상치 못한 서버 오류
중요 사항
등록을 위한 전제 조건:
제출은 등록되기 전에 승인되어야 함
각 제출은 유효한 fullName과 birthDate 필드를 가져야 함
활성 워크리스트만 새 레코드를 받을 수 있음
요청당 최대 25개 제출
모범 사례:
등록 시도 전에 제출 승인 상태 확인
효율성 향상을 위해 여러 제출에 배치 작업 사용
부분 실패에 대한 응답 모니터링 및 적절한 처리
향후 참조를 위해 생성된 레코드 ID 추적
속도 제한
이 엔드포인트는 표준 속도 제한 정책을 따릅니다. 각 요청은 동시에 최대 25개의 제출을 처리할 수 있습니다.
관련 엔드포인트
온고잉 모니터링 레코드 조회 특정 모니터링 레코드에 대한 상세 정보 조회
온고잉 모니터링 레코드 삭제 시스템에서 온고잉 모니터링 레코드 제거