호스티드 세션 조회
내 호스티드 세션 하나의 현재 상태를 조회합니다. 세션이 `COMPLETED`가 되면 `result`에 `GET /v2/hosted-results/{code}`와 같은 결과가 담깁니다. 조회해도 소모되는 것이 없으므로 필요한 만큼 자주 폴링해도 됩니다. 리디렉션이나 결과 코드를 잃어버렸을 때 사용하세요. Console 링크로 시작된 세션(Link Integration)도 함께 반환합니다.
Authorization
VendorApiKeyAuth Petify Console에서 발급한 API 키입니다. 서버 키는 모든 경로를 호출할 수 있습니다. 클라이언트(앱) 키는 캡처 세션 생성과 이미지 업로드만 할 수 있습니다.
In: header
Path Parameters
세션 발급 시 반환된 세션 ID입니다.
uuidResponse Body
application/json
application/json
application/json
application/json
curl -X GET "https://api.petify.petnow.io/v2/hosted-sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08"{
"success": true,
"data": {
"id": "3f2c9a1e-6d2b-4e6a-9c1a-7b8d5e4f3a21",
"linkId": null,
"action": "VERIFY",
"species": "DOG",
"integrationMethod": "SERVER_INTEGRATION",
"bindingSource": "SERVER_ISSUED",
"externalPetId": "customer-pet-42",
"bindingTrusted": true,
"status": "PROCESSING",
"outcome": null,
"errorCode": null,
"result": null,
"expiresAt": "2026-07-27T05:30:00Z",
"completedAt": null,
"createdAt": "2026-07-27T05:00:00Z"
}
}{
"errors": [
{
"code": "PETNOWB2B10000"
}
]
}{
"errors": [
{
"code": "PETNOWB2B10010"
}
]
}{
"errors": [
{
"code": "PETNOWB2B21004"
}
]
}호스티드 세션 발급 POST
호스티드 세션을 발급하고 최종 사용자용 웹 URL을 받습니다(Server Integration). `url`을 SMS, 웹뷰, QR 코드 등으로 최종 사용자에게 전달하세요. 세션을 폴링하려면 `id`가 필요하므로 저장해 두세요. 최종 사용자가 세션을 마치면 브라우저가 `petify_status`와 함께 `redirectUrl`로 돌아오고, `completed`일 때는 일회용 `petify_code`가 함께 전달됩니다. 서버는 `GET /v2/hosted-results/{code}`로 이 코드를 결과로 교환합니다. 요금제 때문에 차단된 실패 세션에는 `petify_code=FEATURE_UNAVAILABLE`이 담깁니다.
결과 코드로 결과 조회 GET
리디렉션으로 받은 일회용 `petify_code`를 세션 결과로 교환합니다. 서버에서 호출하세요. 이 경로는 내 서버가 발급한 세션의 코드와 Console 링크 세션의 코드를 받습니다. Console 링크 세션이면 `bindingTrusted`가 `false`입니다. 처음 조회하면 코드가 소모됩니다. 그 응답을 잃어버렸다면 유예 기간(기본 300초) 안에 다시 조회하세요. `alreadyConsumed: true`와 함께 같은 결과를 받습니다. 코드는 세션이 완료된 뒤 약 10분이 지나면 만료됩니다. 코드를 잃어버렸다면 `GET /v2/hosted-sessions/{sessionId}`를 사용하세요.