Petnow LogoPetnow
Web IntegrationAPI 레퍼런스

호스티드 세션 조회

내 호스티드 세션 하나의 현재 상태를 조회합니다. 세션이 `COMPLETED`가 되면 `result`에 `GET /v2/hosted-results/{code}`와 같은 결과가 담깁니다. 조회해도 소모되는 것이 없으므로 필요한 만큼 자주 폴링해도 됩니다. 리디렉션이나 결과 코드를 잃어버렸을 때 사용하세요. Console 링크로 시작된 세션(Link Integration)도 함께 반환합니다.

GET
/v2/hosted-sessions/{sessionId}

Authorization

VendorApiKeyAuth
x-petnow-api-key<token>

Petify Console에서 발급한 API 키입니다. 서버 키는 모든 경로를 호출할 수 있습니다. 클라이언트(앱) 키는 캡처 세션 생성과 이미지 업로드만 할 수 있습니다.

In: header

Path Parameters

sessionId*string

세션 발급 시 반환된 세션 ID입니다.

Formatuuid

Response 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"
    }
  ]
}