Petnow LogoPetnow
Web IntegrationAPI 레퍼런스

결과 코드로 결과 조회

리디렉션으로 받은 일회용 `petify_code`를 세션 결과로 교환합니다. 서버에서 호출하세요. 이 경로는 내 서버가 발급한 세션의 코드와 Console 링크 세션의 코드를 받습니다. Console 링크 세션이면 `bindingTrusted`가 `false`입니다. 처음 조회하면 코드가 소모됩니다. 그 응답을 잃어버렸다면 유예 기간(기본 300초) 안에 다시 조회하세요. `alreadyConsumed: true`와 함께 같은 결과를 받습니다. 코드는 세션이 완료된 뒤 약 10분이 지나면 만료됩니다. 코드를 잃어버렸다면 `GET /v2/hosted-sessions/{sessionId}`를 사용하세요.

GET
/v2/hosted-results/{code}

Authorization

VendorApiKeyAuth
x-petnow-api-key<token>

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

In: header

Path Parameters

code*string

리디렉션의 petify_code로 받은 일회용 결과 코드입니다. 예: hrc_1a2b3c4d5e6f.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.petify.petnow.io/v2/hosted-results/string"

{
  "success": true,
  "data": {
    "sessionId": "3f2c9a1e-6d2b-4e6a-9c1a-7b8d5e4f3a21",
    "action": "REGISTER",
    "externalPetId": "customer-pet-42",
    "bindingTrusted": true,
    "outcome": "SUCCEEDED",
    "completedAt": "2026-07-27T05:04:12Z",
    "alreadyConsumed": false,
    "result": {
      "registered": true
    }
  }
}

{
  "errors": [
    {
      "code": "PETNOWB2B10000"
    }
  ]
}

{
  "errors": [
    {
      "code": "PETNOWB2B10010"
    }
  ]
}

{
  "errors": [
    {
      "code": "PETNOWB2B21005"
    }
  ]
}
{
  "errors": [
    {
      "code": "PETNOWB2B21006"
    }
  ]
}