> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 2026년 11월 업데이트 안내

> 2026년 11월 ARGOS ID check 제품 업데이트 안내

안녕하세요, ARGOS ID check입니다.

11월에 제공되는 신규 기능과 개선 사항을 안내드립니다.

***

## Unit API 출시

신규 기능

2026년 11월 4일부터 신원 인증에 필요한 기능을 **하나씩 골라 호출하는 Unit API**를 제공합니다. 신분증 OCR, 얼굴 비교, 기관 진위확인 같은 기능을 Liveform 제출 흐름을 거치지 않고 서비스에 바로 붙일 수 있습니다.

* 호출 한 번이 결과 하나입니다. 제출건(submission)을 만들지 않습니다.
* 모든 호출은 **동기**로 처리됩니다. 결과는 응답으로 바로 받고, 웹훅은 없습니다.
* 결과가 나온 호출만 크레딧이 차감됩니다. 오류로 결과가 나오지 않은 호출은 차감되지 않습니다.

> [!NOTE]
>
> **기존 고객사는 아무 조치도 필요하지 않습니다.** Liveform과 기존 REST API·애드온의 동작, 엔드포인트, API 키는 바뀌지 않습니다. Unit API는 필요한 프로젝트에서만 사용하면 됩니다.

### 제공 API

모든 리전에서 14종을 모두 사용할 수 있습니다.

| 이미지·텍스트 분석 | 하는 일 |
| - | - |
| [ID-OCR](https://developers.argosidentity.com/ko/idcheck/unit-api/id-ocr.md) | 신분증 종류를 인식하고 기재 내용을 읽습니다 |
| [ID-LIVE](https://developers.argosidentity.com/ko/idcheck/unit-api/id-live.md) | 신분증 이미지가 실물을 찍은 것인지 검사합니다 |
| [FACE-COM](https://developers.argosidentity.com/ko/idcheck/unit-api/face-com.md) | 두 얼굴이 같은 사람인지 비교합니다 |
| [FACE-LIVE-PSV](https://developers.argosidentity.com/ko/idcheck/unit-api/face-live-psv.md) | 셀피 한 장이 실제 사람을 찍은 것인지 검사합니다 |
| [TXT-FZ-MAT](https://developers.argosidentity.com/ko/idcheck/unit-api/txt-fz-mat.md) | 두 이름이 얼마나 비슷한지 비교합니다 |

| 외부 기관 조회 | 하는 일 | 조회 기관 |
| - | - | - |
| [GC-KOR-NID](https://developers.argosidentity.com/ko/idcheck/unit-api/gc-kor-nid.md) | 주민등록증 진위확인 | 행정안전부 |
| [GC-KOR-DRV](https://developers.argosidentity.com/ko/idcheck/unit-api/gc-kor-drv.md) | 운전면허증 진위확인 | 경찰청 |
| [GC-KOR-PASS](https://developers.argosidentity.com/ko/idcheck/unit-api/gc-kor-pass.md) | 대한민국 여권 진위확인 | 외교부 |
| [GC-KOR-ARC](https://developers.argosidentity.com/ko/idcheck/unit-api/gc-kor-arc.md) | 외국인등록증 진위확인 | 법무부 |
| [GC-KOR-FPS](https://developers.argosidentity.com/ko/idcheck/unit-api/gc-kor-fps.md) | 외국인 체류 확인 | 법무부 |
| [GC-KOR-BRS](https://developers.argosidentity.com/ko/idcheck/unit-api/gc-kor-brs.md) | 사업자 상태 조회 | 국세청 |
| [GC-KOR-BIV](https://developers.argosidentity.com/ko/idcheck/unit-api/gc-kor-biv.md) | 사업자 진위확인 | 국세청 |
| [GC-MEX-CURP](https://developers.argosidentity.com/ko/idcheck/unit-api/gc-mex-curp.md) | 멕시코 CURP 조회 | RENAPO |
| [BANK-KOR-AON](https://developers.argosidentity.com/ko/idcheck/unit-api/bank-kor-aon.md) | 예금주명 조회 | 은행 |

이미지·텍스트 분석 API는 점수와 측정값만 돌려주며, 통과 기준은 직접 정하시면 됩니다. 외부 기관 조회 API는 기관의 답을 `verdict`(판정)와 `verdictReason`(판정 이유)으로 정리해 돌려줍니다.

### 시작하기

1. 대시보드 **Unit API > Unit API 키**에서 키를 복사합니다. 프로젝트를 만들 때 자동으로 발급되며, Member 이상 권한이 필요합니다.
2. **API 테스트**에서 API를 골라 실행해 결과와 cURL 예시를 확인합니다.
3. 프로젝트가 속한 리전의 호스트로 `POST /v1/units/{api}`를 호출합니다. 키는 `x-api-key` 헤더로 보냅니다.

| 리전 | 호스트 |
| - | - |
| US | `https://client-api.argosidentity.com` |
| KR | `https://kr.client-api.argosidentity.com` |

> [!WARNING]
>
> Unit API 키는 Liveform API 키·애드온 API 키와 다른 키이며, 프로젝트 리전의 호스트에서만 통합니다. 프로젝트 설정의 **긴급 정지**는 Unit API 호출에 적용되지 않으므로, 키가 노출됐거나 오남용이 의심되면 Owner·Leader가 키를 재발급하세요. 재발급하면 이전 키는 즉시 폐기됩니다.

### 과금과 이용 범위

* **결과가 나온 호출만 차감됩니다.** 기관이 불일치(`MISMATCH`)로 답한 호출도 결과가 나온 것이므로 차감됩니다. HTTP 상태가 `200`이 아닌 오류 호출은 차감되지 않습니다.
* 대시보드 API 테스트로 실행한 호출도 같은 기준으로 차감됩니다.
* 체험(Trial) 프로젝트는 크레딧이 차감되지 않는 대신 **월 10건**(오류 포함)까지 호출할 수 있습니다. 한도는 매월 1일 00:00 UTC(한국시간 오전 9시)에 초기화됩니다.
* API별 단가는 [Unit API 시작하기 — 과금 기준](https://developers.argosidentity.com/ko/idcheck/unit-api/overview.md#과금-기준)과 대시보드 **API 테스트**에서 확인할 수 있습니다.

### 데이터 보관

* **요청·응답 본문은 저장되지 않습니다.** 응답을 받는 즉시 결과를 `txId`와 함께 시스템에 저장해 두세요.

* 호출 기록(호출 시각, API, 결과, 오류 코드, 크레딧, 실행자, `referenceId`)은 3년간 보관되며 대시보드 호출 내역에서 볼 수 있습니다.

* [Unit API 시작하기](https://developers.argosidentity.com/ko/idcheck/unit-api/overview.md) 개발자 가이드

* [오류 코드와 재시도](https://developers.argosidentity.com/ko/idcheck/unit-api/errors.md) 개발자 가이드

* [Unit API 레퍼런스](https://client-api.argosidentity.com/docs#ko/description/introduction) 요청·응답 명세, 언어별 호출 코드, OpenAPI 명세 파일

***

## 대시보드 Unit API 메뉴

신규 기능

프로젝트 좌측 메뉴 맨 아래에 **Unit API** 메뉴가 추가되었습니다. 개발 없이 Unit API를 실행해 보고, 프로젝트의 모든 호출 내역과 키를 관리할 수 있습니다.

| 기능 | 설명 | 권한 |
| - | - | - |
| **API 테스트** | API를 골라 값을 넣고 실행하면 실제 연동과 똑같이 처리된 결과, 차감 크레딧, TX ID를 바로 봅니다. 실행 전에 호출 주소와 cURL 예시를 볼 수 있습니다 | Member 이상 |
| **호출 내역** | 라이브 호출과 API 테스트 호출이 최신순으로 쌓입니다. TX ID·API·결과·소스·기간으로 필터하고 CSV로 내려받을 수 있습니다 | 전체(Guest 포함) |
| **Unit API 키** | 키 복사, 발급 이력 확인, 재발급 | 보기·복사 Member 이상, 재발급 Owner·Leader |

* 화면 상단에 프로젝트 상태와 이용 범위(체험 프로젝트는 이번 달 사용 건수와 다음 초기화 시각)가 표시됩니다.

* CSV에는 `referenceId` 열이 있어 직접 넣은 식별자로 호출을 찾을 수 있습니다.

* [대시보드 Unit API 안내](https://developers.argosidentity.com/dashboard/ko/unit-api.md) 대시보드 가이드

***

## 통계 페이지 개편 — 전체·제출건·Unit API 탭

기능 개선

통계 페이지가 세 개의 탭으로 나뉘었습니다. 기존 제출건 통계는 **제출건** 탭에서 그대로 볼 수 있습니다.

| 탭 | 볼 수 있는 내용 | 조회할 수 있는 마지막 날 |
| - | - | - |
| **전체** | 제출건과 Unit API의 건수와 크레딧을 함께 봅니다 | 어제 |
| **제출건** | 제출건 현황, 승인률, 크레딧 사용량을 봅니다 | 어제 |
| **Unit API** | 호출 수, 정상 처리율, 차감 크레딧, API별 사용량을 봅니다 | 오늘 |

* **전체** 탭은 크레딧을 제출건과 Unit API로 나누어 보여 줍니다. 제출 건수와 Unit API 호출 수는 단위가 달라 합산하지 않고, 크레딧만 합산합니다.
* **Unit API** 탭에서는 API별 호출 수·정상 처리율·차감 크레딧·API 테스트 비중과, API 테스트를 많이 실행한 상위 5명을 볼 수 있습니다. 방금 실행한 호출은 집계에 들어오기까지 20초쯤 걸립니다.

> [!NOTE]
>
> 전체·제출건 탭의 수치는 하루 단위로 집계되어 00:00 UTC(한국시간 오전 9시) 이후에 전날 사용분이 반영됩니다. 오늘 호출한 Unit API 사용량은 Unit API 탭에서 먼저 확인할 수 있습니다.

* [통계](https://developers.argosidentity.com/dashboard/ko/dashboard.md) 대시보드 가이드

***

ARGOS는 더 강력한 보안과 더 나은 사용자 경험을 위해 본인 인증 서비스를 지속적으로 개선하고 있습니다.

ARGOS ID check를 이용해 주셔서 감사합니다.
**ARGOS Identity 팀**


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.