Notes

아르고스 API를 이용하면 인증이 완료된 프로필의 데이터를 확인할 수 있습니다. 인증이 완료된 프로필은 KYC 신원정보와 지갑 주소 그리고 제 3자 정보제공 동의 사실을 포함합니다.

• 아르고스 API는 RESTful Endpoints와 기본인 HTTP Method를 사용합니다.

• 응답 데이터에는 요청 상태와 발생 가능한 오류 코드가 포함됩니다.

• 모든 응답 데이터는 JSON 형식으로 제공됩니다.

• 토큰 인증을 사용합니다.

• 모든 요청은 HTTPS에서 수행해야 합니다. HTTP 요청은 실패 됩니다.

• API 이용을 위해서는 유효한 API키가 필요하며, 대시보드에서 확인할 수 있습니다.

HTTP 헤더로 인증하기

쿼리와 함께 API 키를 HTTP 헤더로 보내야 합니다. API 키는 메소드 요청 헤더에 'x-api-key: {yourAPIKey}’로 포함되어야 합니다.

curl -H "x-api-key: {yourAPIKey}" "https://rest-api.argoskyc.com/..."

API Gateway Error

일반 HTTP 응답 코드로 응답 합니다. 2XX는 성공, 4XX는 전달된 정보에 오류가 있을 때, 5XX는 아르고스 서버에 오류가 있을 때 발생합니다.

HTTP Code	Message	Description
400	Invalid Query String parameters	클라이언트 에러 (예. 잘못된 형식의 요청 구문, 잘못된 요청 메시지 프레임)
403	User is not authorized to access this resource with an explicit deny	접속한 IP로 프로젝트에 액세스할 수 없습니다.
403	Forbidden	API 키가 제공되지 않았거나 API 키에 문제가 있습니다.
413	Request Entity Too Large	요청이 서버가 의도하거나 수행할 수 있는 것보다 큽니다.
500	Internal Server Error	아르고스 서버의 에러일 수 있습니다. 아르고스 팀에 문의하세요.
502	Bad Gateway	서버가 업스트림 서버로부터 잘못된 응답을 받았습니다.

API 할당량(Request Limit)

각각의 API 키는 아래와 같은 제한을 갖습니다.

• 초 당 최대 요청 수: 5,000건

• 하루 최대 요청 수: 200,000건 (UTC +0 기준으로 매일 자정 리셋됩니다.)

ARGOS ID vs. Consent ID

ARGOS ID('argos_id')

• 'argos_id'는 ARGOS KYC가 승인이 완료되면 부여되는 ID로, 특정 신원 정보를 가진 사람 인증 정보를 조회할 때 사용되는 ID입니다.

• 이름, 생년월일, 성별, 국적 4가지 정보를 비교하여 'argos_id'가 생성됩니다.

• 하나의 'argos_id'는 여러 개의 인증 기록을 가지고 있을 수 있기 때문에, 'argos_id'로 조회 시 다수의 목록이 반환 될 수 있습니다.

Consent ID('consent_id')

• 'consent_id'는 'arogsid'생성 후 개인 정보 제공 약관에 동의하면 생성되는 ID입니다.

• 하나의 인증 기록은 하나의 'consent_id'를 가지기 때문에, 조회 시 단건 기록이 반환 됩니다.

• 'argos_id', KYC 신원 인증 완료 데이터, 지갑 주소, AML결과, 인증 완료 날짜와 'argos_id'의 만료 일자 등이 반환 됩니다.