PetnowWeb Integration
Web Integration 소개
앱 설치나 SDK 통합 없이, Petnow가 호스팅하는 웹 촬영 페이지로 반려동물 생체 인식을 제공하는 Web Integration을 소개합니다.
Web Integration이란?
Web Integration은 Petnow가 호스팅하는 모바일 웹 촬영 페이지로 반려동물 생체 인식 기능을 제공하는 연동 방식입니다. 고객사는 최종 사용자에게 촬영 URL 하나만 전달하면 됩니다. 사용자는 스마트폰 브라우저에서 링크를 열어 반려동물의 코를 촬영하고, 처리가 끝나면 고객사가 지정한 Redirect URL로 자동 복귀합니다.
촬영 UI, 실시간 가이드, 품질 검사, 업로드, 처리 상태 관리는 모두 Petnow가 호스팅하는 웹 앱이 담당합니다. 고객사가 구현할 것은 링크 전달과 결과 수신뿐입니다.
언제 Web Integration을 선택하나요?
- 앱 없이 웹 기반으로 서비스를 운영하는 경우
- 모바일 SDK 통합 전에 빠르게 PoC/파일럿을 진행하고 싶은 경우
- 문자·메신저·QR 코드 등으로 촬영 링크를 전달하는 접점이 있는 경우
앱에 촬영 UI를 직접 내장하려면 iOS · Android · React Native SDK를 참고하세요.
지원 기능
| 기능 | Action | 설명 |
|---|---|---|
| 등록 | REGISTER | 새 반려동물의 생체정보를 등록합니다 |
| 인증 | VERIFY | 등록된 반려동물과 일치하는지 확인합니다 (1:1) |
| 검색 | IDENTIFY | 촬영한 반려동물의 후보를 찾습니다 (1:N) |
- 대상 동물은 강아지(
DOG)와 고양이(CAT) 를 지원합니다. 등록·검색은 링크(세션) 생성 시 대상 동물을 지정하고, 인증은 대상 반려동물의 종을 자동으로 따릅니다. - 검색(
IDENTIFY) 기능은 이용 중인 플랜에 따라 제한될 수 있습니다. 자세한 내용은 가격 안내를 참고하세요.
두 가지 연동 방식
Web Integration은 촬영 세션을 누가 발급하는지에 따라 두 가지 방식으로 나뉩니다. 두 방식 모두 최종 사용자는 동일한 촬영 페이지를 사용합니다.
| Link Integration | Server Integration | |
|---|---|---|
| 세션 발급 | Petify Console에서 링크를 미리 생성 | 고객사 서버가 API로 사용자마다 발급 |
| 필요한 개발 | 거의 없음 (링크 전달 + 완료 페이지) | 서버 연동 (API Key 필요) |
| 반려동물 식별 | 링크 URL에 externalPetId 쿼리로 전달 — 서버가 보증하지 않는 값 | 세션 발급 시 서버가 직접 지정 — 신뢰 가능한 값 |
| 결과 수신 | 콘솔에서 확인 + (인증·검색) 표시 전용 코드 | 1회용 결과 코드를 서버에서 조회 + 세션 폴링 |
| 적합한 경우 | 파일럿, 소규모 운영, 수동 결과 관리 | 결과를 비즈니스 로직에 사용하는 서비스 자동화 |
- Link Integration — 콘솔에서 재사용 가능한 링크를 만들어 배포합니다. 개발 없이 시작할 수 있습니다.
- Server Integration — 고객사 서버가
POST /v2/hosted-sessions로 1회용 세션 URL을 발급하고, 완료 결과를 신뢰 가능한 형태로 서버에서 수신합니다.
결과를 근거로 비즈니스 의사결정(포인트 지급, 보험 가입 심사 등)을 해야 한다면 Server Integration을 사용하세요. Link Integration의 결과 전달 경로는 표시 전용입니다.
최종 사용자 플로우
- 사용자가 촬영 링크를 열면 **세션(Session)**이 생성됩니다. 세션은 기본 30분 후 만료됩니다.
- 촬영 가이드를 확인하고 카메라로 반려동물의 코를 촬영합니다.
- 촬영 품질을 확인한 뒤 제출하면 서버가 등록/인증/검색을 처리합니다.
- 처리가 끝나면 브라우저가 고객사의 Redirect URL로 자동 이동합니다. 이때 결과 상태가 쿼리 파라미터로 전달됩니다. 자세한 규칙은 Redirect URL과 결과 전달을 참고하세요.
촬영 환경 요구사항
- 모바일 전용: 데스크톱 브라우저에서는 촬영을 진행할 수 없으며, 모바일 기기에서 다시 열도록 안내합니다.
- 카메라 권한: 촬영 시작 시 브라우저의 카메라 접근 권한이 필요합니다.
- 새 탭, 같은 탭, 앱 내 웹뷰 등 진입 방식과 무관하게 동작합니다.
다음 단계
Web Integration을 도입하려면 다음 문서를 참고하세요:
- 시작하기 - 콘솔 준비부터 첫 촬영·결과 확인까지
- Link Integration - 콘솔에서 링크 발급·관리
- Server Integration - API로 세션 발급·결과 수신
- Redirect URL과 결과 전달 - 허용 목록과 리다이렉트 파라미터