FAQ

계정

Petify SaaS(Console) 계정으로 Petify 모바일 앱에 로그인할 수 있나요?

네. Petify Console에서 쓰는 이메일과 비밀번호를 그대로 사용하세요. 앱에서 다시 가입하지 마세요 — 이미 등록된 이메일로 가입을 시도하면 인증 단계에서 실패합니다.

테스트

통합 테스트용 sandbox가 따로 필요한가요?

별도의 sandbox 테넌트는 없습니다. 같은 백엔드 안에서는 테스트와 운영이 하나의 계정과 하나의 잔액을 공유합니다. 대신 staging 백엔드가 있고 콘솔과 키가 따로 발급됩니다. production으로 보낸 스캔은 실제 등록으로 남으므로, 평가 단계에서는 staging을 쓰는 편이 좋습니다(다음 문답 참고).

어느 백엔드를 쓰든, 첫 API Key 또는 Web Integration 링크 생성 시 지급되는 50 Integration Credits를 활용하고, 테스트가 끝날 때마다 테스트용 펫을 삭제하세요. 동물 없이 테스트하려면 Web Integration 체험(mock) 링크를 사용하세요.

샘플 앱이나 평가용 빌드에는 어떤 API 키와 백엔드를 써야 하나요?

키는 백엔드별로 발급됩니다. staging 콘솔에서 발급한 키는 staging에서만, production 키는 production에서만 동작하며, 서로 맞지 않으면 라이선스 검증이 License validation failed: the API key was rejected by the server.로 실패합니다. SDK는 LicenseInfo.environment로 백엔드를 결정하고(React Native: usePetnowCamera({ apiKey, environment })), 생략하면 production입니다. production으로 보낸 스캔은 실제 등록으로 남기 때문에, 평가 단계에서는 staging을 사용하는 편이 좋습니다.

카메라가 코는 검출하는데 촬영이 시작되지 않아요.

대개 두 가지 중 하나입니다. 카메라가 사진·인쇄물·화면을 비추고 있어 위조 이미지(fake-image) 분류기가 거부했거나, SDK 또는 캡처 세션 설정이 잘못된 경우입니다. 자세한 내용은 트러블슈팅을 참고하세요.

Android SDK를 에뮬레이터에서 실행할 수 있나요?

네, 1.5.0부터 가능합니다. AAR에 x86_64 ABI가 포함되어 Android 에뮬레이터에서 SDK가 실행됩니다. 에뮬레이터의 GPU 가속은 GL/OpenCL 지원에 따라 다르며 CPU로 폴백합니다.

API 키

SDK에는 어떤 키를 넣나요? 앱에 넣어 배포해도 안전한가요?

SDK에는 Server API와 동일한 종류의 Petnow API 키를 넣습니다. 앱 바이너리에 넣은 값은 누구나 다시 읽어낼 수 있으니 자격 증명으로 취급하세요. 앱 전용 키를 발급해 사용하고 서버 키는 바이너리에 넣지 마세요 — API 키 보안을 참고하세요.

데이터

SDK가 이미지를 업로드하나요?

아니요. SDK는 로컬 이미지 파일을 앱에 반환할 뿐이며, 업로드는 고객사 서버가 Server API를 통해 수행합니다.

버전

변경 이력은 어디에 있고, 어떤 버전이 지원되나요?

최신 릴리즈와 플랫폼별 버전 이력은 변경 이력을 참고하세요.