---
title: "公开查询批量分享 Token 状态"
method: POST
path: "/api/v1/things/user/device/share/token/check"
tags: ["things/user/device/share", "thingsUserDeviceShare"]
---

# 公开查询批量分享 Token 状态

`POST /api/v1/things/user/device/share/token/check`

H5 分享承接页公开查询 shareToken 是否仍有效，只返回过期时间和精简状态，不返回权限详情。

## Request body

- UserDeviceShareTokenCheckReq
  - `shareToken` string, required

## Response `200`

A successful response.

- object
  - `code` integer
  - `data` UserDeviceShareTokenCheckResp
    - `authExpireAt` integer
    - `createdTime` integer
    - `deviceCount` integer
    - `linkExpireAt` integer
    - `reason` string
    - `useBy` string
    - `valid` boolean, required
  - `msg` string

## Changes

- **2026-06-11** `d9bde20b898b` — 1 info
  - endpoint added
- **2025-03-14** `e87dbcac5d9e` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/unitedrhino/apis/things-api/changes/api/v1/things/user/device/share/token/check/post.md)

---

[API](https://skmtc.dev/unitedrhino/apis/things-api.md) · [All operations](https://skmtc.dev/unitedrhino/apis/things-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/unitedrhino/things-api/revisions/f3bdeb916389/schema)