---
title: "Check Version"
method: POST
path: "/api/v1/version/check"
tags: ["version", "android_app", "web_app"]
---

# Check Version

`POST /api/v1/version/check`

检查应用版本更新

通过HTTP头传递版本信息：
- appVersionCode: 应用版本代码（必填，整数）
- appVersionName: 应用版本名称（可选，后端会忽略，保留向后兼容）

## Headers

- `appVersionCode` integer, required — 应用版本代码
- `appVersionName` string, nullable — 应用版本名称（向后兼容，忽略）

## Response `200`

Successful Response

- APIResponseVersionCheckResponse
  - `code` integer
  - `message` string
  - `data` VersionCheckResponse — 版本检查响应模型
    - `reminder_action` 'NONE' | 'SETTINGS_REMINDER' | 'POP_UP_REMINDER' | 'BLOCK_ACCESS' — 客户端需要展示的提醒类型
    - `current_version` string, nullable — 当前客户端版本
    - `latest_version` string, nullable — 最新可用版本
    - `latest_version_code` integer, nullable — 最新版本代码
    - `update_required` boolean, nullable — 是否需要更新
    - `force_update` boolean, nullable — 是否强制更新
    - `force_update_reasons` string[], nullable — 强制更新的具体原因列表
    - `minimum_version` string, nullable — 最低支持版本
    - `changelog` string, nullable — 更新日志
    - `download_url` string, nullable — 下载链接
    - `message` string, nullable — 状态消息
    - `error` string, nullable — 错误信息

## Other responses

- `422` — Validation Error

## Changes

- **2025-12-07** `a5dbb314422e` — 15 breaking, 4 warning, 2 info
  - the response property `data/anyOf[subschema #1: VersionCheckResponse]/current_version` became optional for the status `200`
  - the response property `data/anyOf[subschema #1: VersionCheckResponse]/download_url` became optional for the status `200`
  - the response property `data/anyOf[subschema #1: VersionCheckResponse]/force_update` became optional for the status `200`
  - the response property `data/anyOf[subschema #1: VersionCheckResponse]/latest_version` became optional for the status `200`
  - …17 more
- **2025-12-01** `6c3239768e6b` — 1 info
  - added the optional property `data/anyOf[subschema #1: VersionCheckResponse]/reminder_action` to the response with the `200` status
- **2025-11-25** `05cf5f034c74` — 2 info
  - api tag `android_app` added
  - api tag `web_app` added
- **2025-09-10** `56253b536c00` — 1 info
  - added the optional property `data/anyOf[subschema #1: VersionCheckResponse]/force_update_reasons` to the response with the `200` status

[Change history](https://skmtc.dev/nascentcore/apis/inty-backend/changes/api/v1/version/check/post.md)

---

[API](https://skmtc.dev/nascentcore/apis/inty-backend.md) · [All operations](https://skmtc.dev/nascentcore/apis/inty-backend/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nascentcore/inty-backend/revisions/1e014c365df2/schema)