개발 절차

DOSI SDK를 사용하려면 사전 논의 후 필요한 정보를 발급받아야 합니다. 아래는 DOSI SDK 사용 및 개발 절차를 간략히 나타낸 그림입니다.

사용 신청하기

DOSI SDK를 사용하기 전에 사전 논의한 파트너사 담당자에게 사용 의사를 전달하세요. 이때 API를 호출할 서버의 IP 주소도 함께 전달해야 합니다. DOSI SDK Tech Support팀은 사용 신청한 파트너사의 서버가 DOSI SDK의 API를 호출할 수 있도록 ACL에 등록하고, 개발에 사용할 정보를 발급합니다.

• 서버는 반드시 신뢰할 수 있는 인증서와 HTTPS 프로토콜을 사용해야 합니다.
• 보안을 고려해 TLS 1.2 이상인 인증서를 사용하기를 권장합니다.
• 다른 주체와 공유(예: NAT을 이용해 다른 곳과 공인 IP를 공유하는 방식)하는 서버 IP 주소나 회사 건물 IP 주소, 사무실 IP 주소 등은 등록할 수 없습니다.

개발 정보 확인하기

신청 절차가 끝나면, DOSI Biz 관리자 권한으로 DOSI Biz > 회원 관리 > 법인 관리 > SDK/API 정보에서 아래의 정보를 조회할 수 있습니다.

정보	설명
DOSI 채널 ID와 시크릿(secret)	DOSI SDK를 사용할 수 있는 채널 정보. API를 호출할 때 사용
Contract ID	서비스의 디지털 아이템이 속한 컨트랙트의 ID. 디지털 아이템을 관리할 때 사용 API에서 사용할 때는 요청 헤더 "Authorization"에서 지정한 DOSI 채널과 연결된 contract ID만 입력해야 합니다. 단, 디지털 아이템 목록 조회 엔드포인트는 DOSI 채널과 연결하지 않은 contract ID를 입력해도 해당 contract ID의 아이템 목록을 조회할 수 있습니다.
Partner ID	DOSI Biz 온보딩 때 발급받는 파트너 ID. 디지털 아이템을 생성할 때 사용

DOSI Biz 시스템에서 조회한 정보에 빠진 내용이 없는지 확인하세요.

개발 시작하기

받은 정보에 문제가 없다면 DOSI SDK를 사용해 DOSI와 연동해 보세요. 보통 다음 순서로 개발합니다.

1. User Account Connect로 파트너사 서비스와 사용자 DOSI 계정을 연동
2. 기본 기능으로 사용자 DOSI 계정에 있는 디지털 아이템 관리 권한을 서비스에 위임하는 프록시(proxy) 설정
3. 디지털 아이템 기능으로 서비스의 상품을 디지털 아이템으로 전환하거나 다시 상품으로 전환

이 과정에서 사용자 DOSI 계정의 아이템 목록을 조회하는 등 다른 API를 호출할 수도 있습니다.