하이브리드 앱

버전 체크

post

기능설명

• 업데이트해야 할 버전을 조회합니다.

---

상세설명

• appVersion, osType, 쿠키 값의 siteNo 기준으로 조회합니다.

• 사용여부가 Y인 코드들만 조회합니다.

• 최신 업데이트 일시로 단건만 조회합니다.

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

버전 체크 API Request

siteDomstringRequired

사이트 도메인

Example: fo.x2bee.com

appVersionstringRequired

현재 실행되고 있는 앱의 버전

Example: 1.0.0

osTypestringRequired

OS 타입 I:iOS A:AOS

Example: I

osVersionstringOptional

단말기에 설치된 OS의 버전 정보

deviceNamestringOptional

단말기 디바이스 이름

Example: iphone 15 pro

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

post

/v1/app/version

HTTPcURLJavaScriptPython

POST /api/common/v1/app/version HTTP/1.1
Host: api-common.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 108

{
  "siteDom": "fo.x2bee.com",
  "appVersion": "1.0.0",
  "osType": "I",
  "osVersion": "text",
  "deviceName": "iphone 15 pro"
}

{
  "timestamp": "2026-03-22T11:05:33.995Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "versionInfo": {
      "updateType": "N",
      "storeUrl": "https://xxxxxxx"
    },
    "splashInfo": {
      "imgUrl": "https://xxxxxxx"
    }
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}