POST/Submission

이 API는 데이터 마이그레이션을 위해 기존 시스템에서 ARGOS 시스템으로 사용자 데이터를 이전할 때 유용하게 사용될 수 있습니다. 또한, ID check 검증을 거치기 어려운 특수한 상황에서 직접 사용자 ID 확인 데이터를 제출해야 할 경우에도 활용할 수 있습니다. 마지막으로, 개발 단계에서 다양한 시나리오를 테스트할 때에도 이 API가 도움이 될 수 있습니다.

이 API를 통해 생성된 Submission은 ARGOS의 표준 검증 절차를 거치지 않으므로, 제출된 데이터의 정확성과 유효성에 대한 책임은 전적으로 클라이언트에게 있습니다. 따라서 일반적인 ID 확인 프로세스를 대체하지 않으며, 특수한 경우에만 사용하는 것이 바람직합니다.

1. 엔드포인트

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

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

2. 인증

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

x-api-key

x-api-key: {yourAPIKey}

3. 요청 본문

요청 본문은 JSON 형식이어야 합니다. 다음은 필드 설명입니다:

string

필수

프로젝트 관리자의 이메일 (대시보드에 등록되어 있어야 함)

string

필수

KYC 제출자의 이메일 주소

string

필수

KYC 제출자의 전체 이름

string

제출자의 이름

string

제출자의 가족 이름(성)

string

필수

KYC 제출자의 생년월일

string

필수

KYC 결과: approved 또는 rejected

string

ID 유형 ID 카드 코드

string

ID 발급 국가 국가 코드

string

KYC 제출자의 국적 국가 코드

string

female 또는 male

string

ID 발급일 YYY-MM-DD 형식

string

ID 만료일 YYY-MM-DD 형식

string

KYC 제출자의 IP 주소

string

KYC 제출자의 신분증 번호

string

KYC 제출자의 문서 번호

string

거주 도시

string

거주 국가

string

거주 주/도

string

거리 주소

string

전체 주소

string

사용자 정의 필드 #1

string

사용자 정의 필드 #2

string

사용자 정의 필드 #3

string

고유 사용자 ID

4. 요청 예시

curl --location 'https://rest-api.argosidentity.com/v3/submission/migration' \
--header 'Content-Type: application/json' \
--header 'x-api-key: {yourAPIKey}' \
--data-raw '{
  "admin": "{admin}",
  "email": "{email}",
  "fullName": "{fullName}",
  "firstName": "{firstName}",
  "lastName": "{lastName}",  
  "birthDate": "{birthDate}",
  "kycStatus": "approved",
  "idType": "drvlic",
  "issuingCountry": "USA",
  ...
}'

curl --location 'https://kr.rest-api.argosidentity.com/v3/submission/migration' \
--header 'Content-Type: application/json' \
--header 'x-api-key: {yourAPIKey}' \
--data-raw '{
  "admin": "{admin}",
  "email": "{email}",
  "fullName": "{fullName}",
  "firstName": "{firstName}",
  "lastName": "{lastName}",  
  "birthDate": "{birthDate}",
  "kycStatus": "approved",
  "idType": "drvlic",
  "issuingCountry": "USA",
  ...
}'

5. 응답

5-1. 성공 응답

result.json

{
    "message": "success",
    "submissionId": "submissionId123"
}

5-2. 오류 응답

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

error.json

{
    "errorCode": "invalid_payload",
    "message": "잘못된 페이로드입니다."
}

5-3. 오류 코드

에러 코드	메시지	설명
`invalid_payload`	Invalid payload	요청 본문을 파싱할 수 없음
`missing_data`	Required input data is missing	필수 필드가 누락됨
`invalid_project`	Invalid project	프로젝트 ID가 유효하지 않음
`invalid_admin`	Invalid admin	관리자 계정에 이 프로젝트에 대한 권한이 없음
`invalid_parameter`	invalid parameter: `{parameter}`	예상치 못한 매개변수가 제출됨
`invalid_format`	invalid format: `${parameter}`	매개변수가 예상 형식과 일치하지 않음
`processing_error`	Failed to complete migration	처리 중 알 수 없는 오류 발생

6. 암호화 옵션

보안 강화를 위해 요청 본문을 암호화할 수 있습니다. 전체 요청 본문 객체를 암호화한 문자열을 HTTP 요청 본문에 그대로 넣습니다. JSON 객체나 data 필드로 감싸지 않고 URL 인코딩하지 않습니다.

POST·PATCH 요청 본문의 암호문은 raw base64 문자열로 전달합니다. GET 요청의 암호문은 URL 인코딩한 뒤 data 쿼리 파라미터로 전달합니다. 암호화 방법은 API 요청 데이터 암호화 (AES-256-ECB)를 참조하세요.

6-1. 암호화된 요청 예시

post-encrypted.py

encryption = Encryption(api_key, mode='ECB')

payload_data = {
    "admin": "yourAdmin@sample.com",
    "email": "user@example.com",
    "fullName": "hong kil dong",
    "firstName": "kil dong",
    "lastName": "hong",
    "birthDate": "1999-11-31",
    "kycStatus": "approved",
    "idType": "drivers_license",
    "issuingCountry": "KOR"
}

# 전체 payload를 암호화
payload_encrypted = encryption.encrypt(payload_data)

# 암호문 문자열을 요청 본문에 그대로 전송 (JSON으로 감싸거나 URL 인코딩하지 않음)
response = requests.post(
    url,
    headers=headers,
    data=payload_encrypted
)

curl --location 'https://rest-api.argosidentity.com/v3/submission/migration' \
--header 'x-api-key: {yourAPIKey}' \
--header 'Content-Type: application/json' \
--data 'N34SNtWaavEfgtg1g+o+9JhQ9rp9dGUbyFNxAsHKKGH24aVQTRXYfNpFDHIGJU6Wo0RVpOupAubiDvFDuFyTkw=='

curl --location 'https://kr.rest-api.argosidentity.com/v3/submission/migration' \
--header 'x-api-key: {yourAPIKey}' \
--header 'Content-Type: application/json' \
--data 'N34SNtWaavEfgtg1g+o+9JhQ9rp9dGUbyFNxAsHKKGH24aVQTRXYfNpFDHIGJU6Wo0RVpOupAubiDvFDuFyTkw=='

6-2. 암호화된 응답

응답에는 isEncrypted 플래그와 암호화된 데이터가 포함됩니다:

result.json

response : {
   body : {
    "data": "encrypted-string",
    "isEncrypted": true
   }
}

시작하기

‘ID check API는 기업 고객이 KYC(Know Your Customer) 및 AML(Anti-Money Laundering) 프로세스를 보다 체계적이고 효율적으로 관리할 수 있도록 설계된 솔루션입니다. 이 API는 기존 시스템과의 원활한 통합을 지원하며, 사용자 데이터를 안전하게 처리하고 관리할 수 있는 기능을 제공합니다.

GET/Submission 응답 필드 정의

GET/Submission API 응답에 포함되는 모든 필드에 대한 상세 정의

웹훅 이벤트

ARGOS ID check의 KYC 프로세스 상태 변경을 실시간으로 확인하세요. 웹훅을 통해 즉각적인 업데이트를 받아볼 수 있습니다.

개요

API 참조

1. 엔드포인트

2. 인증

3. 요청 본문

4. 요청 예시

5. 응답

5-1. 성공 응답

5-2. 오류 응답

5-3. 오류 코드

6. 암호화 옵션

6-1. 암호화된 요청 예시

6-2. 암호화된 응답

관련 문서

시작하기

GET/Submission 응답 필드 정의

웹훅 이벤트

​1. 엔드포인트

​2. 인증

​3. 요청 본문

​4. 요청 예시

​5. 응답

​5-1. 성공 응답

​5-2. 오류 응답

​5-3. 오류 코드

​6. 암호화 옵션

​6-1. 암호화된 요청 예시

​6-2. 암호화된 응답

​관련 문서

시작하기

GET/Submission 응답 필드 정의

웹훅 이벤트

1. 엔드포인트

2. 인증

3. 요청 본문

4. 요청 예시

5. 응답

5-1. 성공 응답

5-2. 오류 응답

5-3. 오류 코드

6. 암호화 옵션

6-1. 암호화된 요청 예시

6-2. 암호화된 응답

관련 문서