Petnow LogoPetnow
Web IntegrationAPI 레퍼런스

호스티드 세션 발급

호스티드 세션을 발급하고 최종 사용자용 웹 URL을 받습니다(Server Integration). `url`을 SMS, 웹뷰, QR 코드 등으로 최종 사용자에게 전달하세요. 세션을 폴링하려면 `id`가 필요하므로 저장해 두세요. 최종 사용자가 세션을 마치면 브라우저가 `petify_status`와 함께 `redirectUrl`로 돌아오고, `completed`일 때는 일회용 `petify_code`가 함께 전달됩니다. 서버는 `GET /v2/hosted-results/{code}`로 이 코드를 결과로 교환합니다. 요금제 때문에 차단된 실패 세션에는 `petify_code=FEATURE_UNAVAILABLE`이 담깁니다.

POST
/v2/hosted-sessions

Authorization

VendorApiKeyAuth
x-petnow-api-key<token>

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

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.petify.petnow.io/v2/hosted-sessions" \  -H "Content-Type: application/json" \  -d '{    "action": "REGISTER",    "species": "DOG",    "redirectUrl": "https://vendor.example.com/petify/return",    "externalPetId": "customer-pet-42"  }'
{
  "success": true,
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "url": "string",
    "action": "REGISTER",
    "species": "DOG",
    "integrationMethod": "LINK_INTEGRATION",
    "bindingSource": "SERVER_ISSUED",
    "externalPetId": "string",
    "expiresAt": "2019-08-24T14:15:22Z",
    "createdAt": "2019-08-24T14:15:22Z",
    "mock": true
  }
}

{
  "errors": [
    {
      "code": "PETNOWB2B10001",
      "details": {
        "externalPetId": [
          "This field is required for REGISTER."
        ]
      }
    }
  ]
}

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

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

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

{
  "errors": [
    {
      "code": "PETNOWB2B21002"
    }
  ]
}
{
  "errors": [
    {
      "code": "PETNOWB2B21001"
    }
  ]
}
{
  "errors": [
    {
      "code": "PETNOWB2B21007"
    }
  ]
}