메인 콘텐츠로 건너뛰기
안녕하세요, ARGOS ID check입니다. 11월에 제공되는 신규 기능과 개선 사항을 안내드립니다.

​
Unit API 출시

신규 기능 2026년 11월 4일부터 신원 인증에 필요한 기능을 하나씩 골라 호출하는 Unit API를 제공합니다. 신분증 OCR, 얼굴 비교, 기관 진위확인 같은 기능을 Liveform 제출 흐름을 거치지 않고 서비스에 바로 붙일 수 있습니다.
  • 호출 한 번이 결과 하나입니다. 제출건(submission)을 만들지 않습니다.
  • 모든 호출은 동기로 처리됩니다. 결과는 응답으로 바로 받고, 웹훅은 없습니다.
  • 결과가 나온 호출만 크레딧이 차감됩니다. 오류로 결과가 나오지 않은 호출은 차감되지 않습니다.
기존 고객사는 아무 조치도 필요하지 않습니다. Liveform과 기존 REST API·애드온의 동작, 엔드포인트, API 키는 바뀌지 않습니다. Unit API는 필요한 프로젝트에서만 사용하면 됩니다.

​
제공 API

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

​
시작하기

  1. 대시보드 Unit API > Unit API 키에서 키를 복사합니다. 프로젝트를 만들 때 자동으로 발급되며, Member 이상 권한이 필요합니다.
  2. API 테스트에서 API를 골라 실행해 결과와 cURL 예시를 확인합니다.
  3. 프로젝트가 속한 리전의 호스트로 POST /v1/units/{api}를 호출합니다. 키는 x-api-key 헤더로 보냅니다.
Unit API 키는 Liveform API 키·애드온 API 키와 다른 키이며, 프로젝트 리전의 호스트에서만 통합니다. 프로젝트 설정의 긴급 정지는 Unit API 호출에 적용되지 않으므로, 키가 노출됐거나 오남용이 의심되면 Owner·Leader가 키를 재발급하세요. 재발급하면 이전 키는 즉시 폐기됩니다.

​
과금과 이용 범위

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

​
데이터 보관

  • 요청·응답 본문은 저장되지 않습니다. 응답을 받는 즉시 결과를 txId와 함께 시스템에 저장해 두세요.
  • 호출 기록(호출 시각, API, 결과, 오류 코드, 크레딧, 실행자, referenceId)은 3년간 보관되며 대시보드 호출 내역에서 볼 수 있습니다.
  • Unit API 시작하기 개발자 가이드
  • 오류 코드와 재시도 개발자 가이드
  • Unit API 레퍼런스 요청·응답 명세, 언어별 호출 코드, OpenAPI 명세 파일

​
대시보드 Unit API 메뉴

신규 기능 프로젝트 좌측 메뉴 맨 아래에 Unit API 메뉴가 추가되었습니다. 개발 없이 Unit API를 실행해 보고, 프로젝트의 모든 호출 내역과 키를 관리할 수 있습니다.
  • 화면 상단에 프로젝트 상태와 이용 범위(체험 프로젝트는 이번 달 사용 건수와 다음 초기화 시각)가 표시됩니다.
  • CSV에는 referenceId 열이 있어 직접 넣은 식별자로 호출을 찾을 수 있습니다.
  • 대시보드 Unit API 안내 대시보드 가이드

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

기능 개선 통계 페이지가 세 개의 탭으로 나뉘었습니다. 기존 제출건 통계는 제출건 탭에서 그대로 볼 수 있습니다.
  • 전체 탭은 크레딧을 제출건과 Unit API로 나누어 보여 줍니다. 제출 건수와 Unit API 호출 수는 단위가 달라 합산하지 않고, 크레딧만 합산합니다.
  • Unit API 탭에서는 API별 호출 수·정상 처리율·차감 크레딧·API 테스트 비중과, API 테스트를 많이 실행한 상위 5명을 볼 수 있습니다. 방금 실행한 호출은 집계에 들어오기까지 20초쯤 걸립니다.
전체·제출건 탭의 수치는 하루 단위로 집계되어 00:00 UTC(한국시간 오전 9시) 이후에 전날 사용분이 반영됩니다. 오늘 호출한 Unit API 사용량은 Unit API 탭에서 먼저 확인할 수 있습니다.
  • 통계 대시보드 가이드
ARGOS는 더 강력한 보안과 더 나은 사용자 경험을 위해 본인 인증 서비스를 지속적으로 개선하고 있습니다. ARGOS ID check를 이용해 주셔서 감사합니다. ARGOS Identity 팀