<aside>
💡 기본적으로 API 호출 후 http status code : 200
으로 정상 응답을 받은 경우, 정상 호출로 간주되고, 과금 대상이 됩니다. 그러나 아래 항목들은 특별히 호출별 과금 없이 사용이 가능합니다.
API 서비스의 특성상, 에러(http status code : 4XX
)가 난 경우에도, 아래와 같은 케이스에 따 **과금 에러 / 미과금 에러**로 구분이 됩니다.
</aside>
<aside> 💡 과금되는 API 에러는 결과는 에러가 나왔지만, useB.API 서버를 통해서 서비스의 기능을 활용하게 되었을 때입니다.
✔ 예시 1) O003
: 다른 신분증을 시도한 경우, 빛반사나 사진 화질 문제로 신분증 핵심정보를 읽지 못한 경우
✔ 예시 2) A005
: 주민등록증의 이름 또는 발급일자 정보가 틀린 경우
✔ 예시 3) S011, S012
: 잘못된 계좌번호 또는 예금주명으로 1원 계좌인증을 시도하는 경우
✔ 예시 4) F006, FL001 : 얼굴이 없는 사진으로 안면 일치여부확인 또는 라이브니스 API를 호출한 경우
</aside>
<aside> 💡 미과금 API 에러는 해당 서비스를 제공해주기 어려운 잘못된 호출인 경우에 해당됩니다. 정부기관 시스템 점검 등으로 에러가 발생되는 경우도 포함됩니다.
CXXX
: Common Error Code ⇒ 미과금 처리TXXX
: Token 관련 Error Code ⇒ 미과금 처리KXXX
: AES256 관련 Error Code ⇒ 미과금 처리O007
: empty file로 OCR 호출 ⇒ 미과금 처리S013, F013, FS013
: 은행 점검 시간에 호출 ⇒ 미과금 처리✔ 예시 1) C016
: network_time_out 정부기관의 사이트 변경 및 네트워크 오류
✔ 예시 2) C061
: server_error 정부기관의 시스템 점검 기간
✔ 예시 3) C504
: gateway_time_out API 호출 후 응답이 지연되는 경우
✔ 예시 3) C413
: 5MB 이상의 크기로 API 호출한 경우
</aside>
<aside> 💡 아래 API 는 성공/실패와 상관없이 모두 미과금 처리 됩니다.
Oauth : 모든 호출이 미과금 됩니다.
https://auth.useb.co.kr/oauth/token
https://auth.useb.co.kr/oauth/get-client-secret
암호화 가이드 : 모든 호출이 미과금 됩니다.
https://auth.useb.co.kr/keys/generate-key-pair
https://auth.useb.co.kr/keys/register-public-key
https://auth.useb.co.kr/keys/exchange-keys
https://auth.useb.co.kr/keys/extract-keys
https://auth.useb.co.kr/keys/encrypt
https://auth.useb.co.kr/keys/decrypt
신분증 마스킹 : 모든 호출이 미과금 됩니다.
****https://api3.useb.co.kr/masking/idcard
https://api3.useb.co.kr/masking/driver
https://api3.useb.co.kr/masking/passport
https://api3.useb.co.kr/masking/alien
</aside>