바로빌 API 기본구조

회원구조

바로빌은 사업자를 대상으로 하는 B2B 서비스이며, 바로빌에서의 회원이란 회원사 를 의미합니다.

회사와 직원의 관계처럼, 회원사의 하위에는 계정(아이디)이 존재하며 1:N 의 관계를 갖습니다.

사용자 계정의 관계

사용자는 이 계정으로 바로빌 사이트에 로그인하여 서비스를 이용하게 됩니다.

최초로 가입된 계정은 관리자 계정이 되며, 다른 계정을 추가하거나 정지시킬 수 있는 권한을 갖습니다.

가입 방법에 대한 자세한 내용은 회원가입 기능 개발하기 를 참고해주세요.

바로빌 API 를 이용하여 서비스를 개발하는 회원사를 의미합니다. (파트너이면서 동시에 회원사가 됩니다.)

파트너와 회원사는 1:N의 관계로 연결될 수 있으며, 연결된 회원사만이 파트너의 연동인증키로 API를 사용할 수 있습니다.

파트너와 회원사의 관계

SI 의 경우

개발사를 파트너로 등록하고 고객사(발주처)를 회원사로 추가하는 방법과, 고객사(발주처)를 파트너로 등록하는 방법이 있습니다.

파트너(수익형)으로 진행하는 경우, 첫번째 방법을 권장합니다. 수익형 파트너란?

개발자센터에 로그인할 수 있는 계정입니다. 개발자센터 계정 생성하기

개발자센터 계정의 하위에는 파트너가 N:N의 관계로 연결됩니다. 파트너의 모든 정보(하위 회원사, 설정, 사용량 등)을 조회 관리할 수 있습니다.

개발자센터 계정과 파트너의 관계

개발자센터 계정은 오직 개발자센터에 로그인할 때만 사용됩니다.

바로빌 사이트를 이용하거나, 바로빌 API를 개발할 때 사용되지 않습니다.

바로빌은 개발자센터 계정, 파트너, 회원사 를 연결하는 다양한 방법을 제공합니다.

개발자센터 계정으로 로그인한 후, 두가지 방법으로 파트너를 연결할 수 있습니다.

파트너와 회원사를 연결하는 3가지 방법을 지원합니다.

바로빌에 새 파트너가 등록되면 테스트용 연동인증키와 운영용 연동인증키가 자동으로 발급됩니다.

연동인증키는 바로빌 API 호출 시 파라메터에 사용되며, 파트너를 식별하는 키값으로 활용됩니다.

연동인증키에 대한 자세한 설명은 바로빌 API 개발준비 가이드를 참고해주세요.

회원사를 파트너와 연결된 상태로 가입시키기 위해 사용되는 코드입니다.

가입코드는, 새 파트너 등록 시 파트너가 직접 생성합니다.

바로빌 사이트의 회원가입 페이지에서 연동회원을 선택하고 가입코드란에 파트너의 가입코드를 입력하여 가입합니다.

이렇게 가입된 회원사는 파트너와 연결된 상태가 되며, 가입 즉시 바로빌 API를 사용할 수 있게됩니다.