브라우저에서 결과 표시
최종 사용자가 돌아오는 페이지에서 Console 링크 세션의 결과를 조회합니다. 리디렉션으로 받은 일회용 `petify_code`로 브라우저에서 호출하세요. 이 경로는 API 키를 받지 않습니다. 브라우저는 세션의 리디렉션 URL과 출처(origin)가 같은 페이지에서만 응답을 읽을 수 있고, 그 밖의 출처에는 CORS 허용을 보내지 않습니다. 조회해도 코드가 소모되지 않습니다. 코드가 만료될 때까지(세션 완료 후 약 10분) 조회할 수 있고, 내 서버가 `GET /v2/hosted-results/{code}`로 코드를 교환한 뒤에도 조회할 수 있습니다. 결과는 최종 사용자에게 보여 주는 데만 쓰고 판단의 근거로 쓰지 마세요. 판단에는 서버에서 코드를 교환하세요. VERIFY와 IDENTIFY 세션을 제공합니다. REGISTER 세션에는 코드가 없습니다.
Path Parameters
리디렉션의 petify_code로 받은 일회용 결과 코드입니다. 예: hrc_1a2b3c4d5e6f.
Response Body
application/json
application/json
application/json
curl -X GET "https://api.petify.petnow.io/v2/hosted-results/string:display"{
"success": true,
"data": {
"action": "VERIFY",
"outcome": "MATCH",
"completedAt": "2026-07-27T05:04:12Z",
"result": {
"isVerified": true,
"score": 93
}
}
}{
"errors": [
{
"code": "PETNOWB2B21005"
}
]
}{
"errors": [
{
"code": "PETNOWB2B21009"
}
]
}결과 코드로 결과 조회 GET
리디렉션으로 받은 일회용 `petify_code`를 세션 결과로 교환합니다. 서버에서 호출하세요. 이 경로는 내 서버가 발급한 세션의 코드와 Console 링크 세션의 코드를 받습니다. Console 링크 세션이면 `bindingTrusted`가 `false`입니다. 처음 조회하면 코드가 소모됩니다. 그 응답을 잃어버렸다면 유예 기간(기본 300초) 안에 다시 조회하세요. `alreadyConsumed: true`와 함께 같은 결과를 받습니다. 코드는 세션이 완료된 뒤 약 10분이 지나면 만료됩니다. 코드를 잃어버렸다면 `GET /v2/hosted-sessions/{sessionId}`를 사용하세요.
Webhooks 개요
등록·검증·식별 작업의 결과를 폴링 없이, 서명된 HTTPS 이벤트로 고객사 서버에서 받는 방법