GET/Image

주의사항

한 번의 API 호출로 하나의 이미지만 다운로드할 수 있습니다.
요청한 이미지 유형이 해당 제출 건에 존재하지 않을 경우 오류가 반환될 수 있습니다.

1. 엔드포인트

GET https://rest-api.argosidentity.com/v3/image

GET https://kr.rest-api.argosidentity.com/v3/image

2. 인증

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

x-api-key

x-api-key: {yourAPIKey}

3. 요청 파라미터

string

필수

제출 건의 고유 ID

string

필수

다운로드할 이미지 유형

idImage: 신분증 앞면 사진
idBackImage: 신분증 뒷면 사진
selfieImage: 셀피 이미지
addressImage: 주소 문서 이미지

4. 요청 예시

curl --location --request GET 'https://rest-api.argosidentity.com/v3/image?submission_id={submission_id}&type=idImage' \
--header 'x-api-key: {yourAPIKey}'

curl --location --request GET 'https://kr.rest-api.argosidentity.com/v3/image?submission_id={submission_id}&type=idImage' \
--header 'x-api-key: {yourAPIKey}'

5. 응답

5-1. 성공 응답

성공적인 요청 시, API는 요청한 이미지 파일을 직접 반환합니다.

5-2. 오류 코드

오류가 발생하면 400 상태 코드와 함께 다음 오류 문구가 반환됩니다:

오류 코드	HTTP 상태	설명
`invalid id Type`	400	지원하지 않는 이미지 `type`을 요청함
`Missing required data: submission_id`	400	`submission_id`가 누락됨
`image not exist`	400	제출 건 또는 요청한 이미지가 존재하지 않음

이 API를 사용하여 ID check 제출 과정에서 업로드된 다양한 이미지를 효율적으로 조회하고 다운로드할 수 있습니다.

⌘I

개요

API 참조

1. 엔드포인트

2. 인증

3. 요청 파라미터

4. 요청 예시

5. 응답

5-1. 성공 응답

5-2. 오류 코드

​1. 엔드포인트

​2. 인증

​3. 요청 파라미터

​4. 요청 예시

​5. 응답

​5-1. 성공 응답

​5-2. 오류 코드

1. 엔드포인트

2. 인증

3. 요청 파라미터

4. 요청 예시

5. 응답

5-1. 성공 응답

5-2. 오류 코드