이 API는 프로젝트 설정에 따라 pending 상태의 KYC 제출 건을 수동으로 검토해야 하는 프로젝트 관리자에게 특히 유용합니다. 프로젝트 설정에서 검토자가 ‘Client’로 설정된 경우, Argos Agent는 해당 pending 제출 건을 검토하지 않습니다.

이 API를 사용해서는 pending 상태의 제출 건만 검토할 수 있습니다. 이미 승인되거나 거부된 제출 건은 이 엔드포인트를 통해 수정할 수 없습니다. 관리자 이메일이 대시보드에 등록되어 있고 해당 프로젝트에 대한 적절한 권한이 있는지 확인하세요.

​
1. 엔드포인트

POST https://rest-api.argosidentity.com/v3/submission/review

​
2. 인증

x-api-key 헤더에 API 키를 포함시켜야 합니다:

x-api-key
x-api-key: {yourAPIKey}

​
3. 요청 본문

요청 파라미터는 URL query 형식이어야 합니다. 각 파라미터에 대한 설명은 다음과 같습니다.

​
admin
string
required

검수 할 submission 의 프로젝트에 관리자로 등록된 admin 계정

​
submissionId
string
required

검토할 pending 제출 건의 고유 ID

​
status
string
required

변경하고자 하는 상태 값: approved 또는 rejected

​
rejectComment
string
required

검토 결정에 대한 설명 코멘트 (선택사항). status가 rejected인 경우 필수 값

​
updateFields
string

변경할 데이터 필드

​
4. 요청 예시

POST/Review
curl --location 'https://rest-api.argosidentity.com/v3/submission/review' \
--header 'Content-Type: application/json' \
--header 'x-api-key: {yourAPIKey}' \
--data-raw '{
    "submissionId": "string",
    "status": "string",
    "rejectComment": "string",
    "updateFields": {
      "fullName": "string",
      "gender": "string",
      "issueDate": "string",
      "expireDate": "string",
      "birthDate": "string",
      "idType": "string"
    },
    "admin": "string"
  }

​
5. 응답

​
5-1. 성공 응답

result.json
{
    "submissionId": "string",
    "message": "Success to review submission.",
    "finalStatus": "approved"
}

​
5-2. 오류 응답 예시

오류가 발생하면 400 상태 코드와 함께 응답 본문에 세부 정보가 포함됩니다:

error.json
{
    "message": "Project not found."
}

​
5-3. 오류 코드

오류 유형메시지설명
Validation : projectProject not found.유효하지 않은 api-key 또는 project 데이터
Validation : projectadmin is required.admin 미제출
Validation : projectAccess denied. The admin is not registered in the project.project 에 등록되지 않은 admin 또는 유효하지 않은 admin 데이터
Validation : submissionSubmission Id is required.submission ID 미제출
Validation : submissionInvalid Submission Id.유효하지 않은 submission 데이터
Validation : submissionOnly submissions in pending status can be reviewedsubmission 이 pending 상태가 아님.
Validation : submissionThis submission cannot be reviewed by clientclient review 가능한 submission 아님
Validation : request parameterInvalid status변경할 status 가 approved 또는 rejected 가 아님
Validation : request parameterInvalid data format.updateFields 의 포맷이 올바르지 않음 (object 필수)
Validation : request parameterReject comment is requiredrejected 로 상태 변경 시, rejectedComment 필수값 미제출
Validation : request parameterInvalid idType유효하지 않은 idType
Validation : request parameterInvalid gender유효하지 않은 gender
Validation : request parameterInvalid issueDate format. Use YYYY-MM-DD유효하지 않은 date format (yyyy-mm-dd 필수)
Validation : request parameterInvalid expireDate format. Use YYYY-MM-DD유효하지 않은 date format (yyyy-mm-dd 필수)
Validation : request parameterInvalid birthDate format. Use YYYY-MM-DD유효하지 않은 date format (yyyy-mm-dd 필수)
Processing ErrorFailed to process submission데이터 프로세싱 중 정의되지 않은 에러 발생
Processing ErrorError in submission review process.검수 프로세싱 중 정의되지 않은 에러 발생