메뉴 여는 법
프로젝트에 들어가 좌측 메뉴 맨 아래의 Unit API를 엽니다.역할별 권한
- Guest에게는 실행 버튼이 꺼져 있고, 키 창에 키 대신 ‘Member 이상만 API 키를 볼 수 있습니다’ 안내가 보입니다. 실행이 필요하면 프로젝트 Owner·Leader에게 Member 이상 권한을 요청하세요.
- 역할은 관리자 역할과 권한을 참고하세요.
프로젝트 상태
화면 상단에 프로젝트 상태와 이용 범위가 표시됩니다.- 체험 프로젝트의 월 10건에는 오류로 끝난 호출과 한도 초과로 거절된 호출도 포함됩니다.
- 한도는 매월 1일 00:00 UTC(한국시간 오전 9시)에 초기화됩니다.
API 테스트
API를 골라 값을 넣고 실행하면, 실제 연동과 똑같이 처리된 결과를 바로 볼 수 있습니다.- API 테스트에서 API를 고릅니다. API별 단가와 예상 차감 크레딧이 함께 보입니다.
- 실행하기 전에 호출 주소와 요청 예시(cURL), 개발자 가이드 링크를 확인할 수 있습니다. 키와 이미지는 자리표시자로 나옵니다.
- 값을 넣고 실행을 누릅니다. 이전 실행 결과는 그 순간 화면에서 사라집니다.
- 결과를 확인합니다.
- 정상 처리: 결과 값, 차감 크레딧, TX ID
- 오류: 오류 안내와 오류 코드, ‘차감 안 됨’ 표시, TX ID
- 요청 예시(cURL)를 복사해 Unit API 키와 함께 서비스에 연동합니다.
- ID-OCR은 발급 국가를 고르면 그 국가에서 지원하는 신분증 종류만 목록에 남습니다.
- 이미지는 한 장당 3 MB까지 올릴 수 있습니다.
테스트라도 실제 개인정보를 넣으려면 정보주체의 동의 등 처리 근거가 있어야 합니다. 실행 결과는 저장되지 않으니 필요한 결과는 화면에서 바로 옮겨 두세요.
호출 내역
라이브 호출(API 키로 직접 호출)과 API 테스트 호출이 모두 최신순으로 쌓입니다. 실행 후 내역에 나타나기까지 수십 초가 걸릴 수 있습니다.필터
목록 항목
CSV 내려받기
화면과 같은 조건의 호출 내역을 CSV로 내려받습니다. 건수가 많으면 여러 파일로 나뉘어 받아집니다.- CSV의 시각은 UTC 원값입니다. 서비스 로그와 밀리초까지 대조할 수 있습니다.
- CSV에는
referenceId열이 있습니다. 화면에서는referenceId로 검색할 수 없으므로,referenceId로 호출을 찾으려면 CSV를 내려받아 찾으세요.
Unit API 키
Unit API 호출에 쓰는 프로젝트 키입니다. 프로젝트를 만들 때 자동으로 발급되며, 별도 발급 화면은 없습니다.- 복사: 키는 마스킹되어 보이며, 복사 버튼으로 원문을 복사합니다. Member 이상만 볼 수 있습니다.
- 발급 이력: 키마다 상태(사용 중·폐기), 발급 시각, 발급한 사람, 발급 사유, 폐기 시각이 보입니다. 처음 발급된 키의 발급자는
SYSTEM으로 표시될 수 있습니다. - 재발급: Owner·Leader만 할 수 있습니다. 재발급하면 이전 키는 즉시 폐기되어, 그 키로 들어온 호출은
401 INVALID_API_KEY로 거절됩니다. 재발급 기록은 이벤트 로그에도 남습니다.
프로젝트 설정의 긴급 정지는 Unit API 호출에 적용되지 않습니다. 키가 노출됐거나 오남용이 의심되면 키를 재발급하세요.
통계
통계 메뉴의 Unit API 탭에서 기간별 호출 수, 정상 처리율, 차감 크레딧, API별 사용량, 실행자별 사용량을 볼 수 있습니다.알아두실 점
- 결과가 나온 호출만 차감됩니다. 기관이 불일치로 답한 호출도 결과가 나온 것이므로 차감됩니다. 오류로 결과가 나오지 않은 호출은 차감되지 않습니다. 과금 기준
- 요청·응답 내용은 저장되지 않습니다. 호출 기록(시각, 결과, 크레딧 등)은 3년간 보관됩니다.
- 점수와 측정값만 드립니다. 통과 기준은 직접 정하시면 됩니다.
- 모든 리전에서 모든 Unit API를 쓸 수 있습니다.