목차
이번에 시작하는 프로젝트에서 카페 사장님들 혹은 원두 판매자들의 경우 회원가입 단계에서 사업자 등록 여부를 확인하는 절차를 넣기로 했다.
그래서 관련 api를 알아보던 도중에 국세청 Open api 중에서 사업자등록정보 진위확인을 해주는 api를 발견했다.
사용방법
1. 요청(request)
사용방법은 간단하다.
사이트에 회원가입 / 로그인을 우선 해준다.
우선은 페이지에 들어갔을 때 우측 상단에 보이는 활용신청을 눌러서 사용목적 등을 기입한 후 신청을 넣는다. 그러면 보통 3시간에서 길면 2일~3일 후에 승인신청이 난다고 한다. 내 경우에는 신청 후 즉시 사용이 가능했다.
신청이 승인되면 마이페이지에서 위와 같이 인증키가 발급된다. 이 인증키를 api request url의 뒤에 붙여서 사용하면 된다.
https://api.odcloud.kr/api/nts-businessman/v1/validate?serviceKey=[서비스키]
잘 보면 인코딩 인증키와 디코딩 인증키가 있는데 내 경우에는 인코딩키를 사용하면 등록되지 않은 인증키입니다. 라는 오류가 발생해 디코딩키를 사용했다.
Request body의 경우에 필수 기입사항은 사업자 등록번호,개업일자,대표자명이 있다. 이때 숫자들 사이에는 하이폰(-)이 없어야하고 만약 필수 기재사항 이외의 항목들이 없다면 빈란("")으로 채워줘야 한다.
2. 응답(response)
그렇게 요청을 보내는데 성공하고 응답을 받게되면 다음과 같은 응답을 받게된다.
진위여부를 한개만 할 수 있는게 아니기 때문에 request_cnt, valid_cnt와 같은 내용이 있고 각각의 목록에 따른 자세한 결과는 data라는 배열에 들어가있다.
예시를 보면 valid라는 속성이 01이라면 유효한 것이고 02라면 유효하지 않은 것이다. 또한 02의 경우 valid_msg라는 속성이 추가되며 확인할 수 없습니다라는 메세지가 나온다.
