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"
    }
  ]
}
유효한 fullName과 birthDate 필드를 가진 승인된 제출만 온고잉 모니터링에 등록할 수 있습니다.

엔드포인트

POST /submission/aml/monitor/{worklistId}

기본 URL

https://rest-api.argosidentity.com/v3/submission/aml/monitor

인증

요청 헤더에 API 키를 포함하세요:
x-api-key
string
required
인증을 위한 API 키

경로 매개변수

worklistId
string
required
레코드가 등록될 활성 워크리스트의 ID

요청 본문

submissionIds
array
required
온고잉 모니터링에 등록할 제출 ID 배열 (1-25개 제출)
admin
string
required
요청을 하는 관리자의 이메일 주소 (프로젝트의 관리자 목록에 등록되어 있어야 함)

요청 예시

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
boolean
required
배치 작업의 전체 성공 상태
successCount
number
required
성공적으로 처리된 제출 수
failedCount
number
required
처리에 실패한 제출 수
successResults
array
required
성공적으로 처리된 제출 배열
failedResults
array
required
처리에 실패한 제출 배열

오류 응답

{
  "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예상치 못한 서버 오류

중요 사항

등록을 위한 전제 조건:
  • 제출은 등록되기 전에 승인되어야 함
  • 각 제출은 유효한 fullNamebirthDate 필드를 가져야 함
  • 활성 워크리스트만 새 레코드를 받을 수 있음
  • 요청당 최대 25개 제출
모범 사례:
  • 등록 시도 전에 제출 승인 상태 확인
  • 효율성 향상을 위해 여러 제출에 배치 작업 사용
  • 부분 실패에 대한 응답 모니터링 및 적절한 처리
  • 향후 참조를 위해 생성된 레코드 ID 추적

속도 제한

이 엔드포인트는 표준 속도 제한 정책을 따릅니다. 각 요청은 동시에 최대 25개의 제출을 처리할 수 있습니다.

관련 엔드포인트