Device Management/Device Configuration/HMS Event
Device Management/Device Operations/HMS Events

Update Project Device HMS Read Time

Called when user clicks "Mark as Read" on "Project Device Topology"; updates specified device's HMS event read time to current time. Other online terminals in the same project and organization receive this read time update via real-time push channel; frontend can synchronously refresh red dot status, avoiding read-status misalignment during multi-user collaboration. Authentication: caller must be project member, and target device must be directly bound to project (no topology lookup). This is the key difference from "Update Organization Device HMS Read Time" API (organization level allows topology lookup to validate gateway device); calling project-level API without directly bound device returns non-zero code (business code DRCErrCodeDeviceNotInProject). Effect: after successful call, server distributes the latest read_time via real-time channel to other online terminals at both project and organization levels.

put/openapi/v2.0/manage/api/v1/projects/{uuid}/topologies/hms

Request

  • Base URL
    https://41b04hdzmc.apifox.cn (the document declares no server; this is the origin it was published from)
  • URL
    https://41b04hdzmc.apifox.cn/openapi/v2.0/manage/api/v1/projects/{uuid}/topologies/hms
  • Auth
    none required

Path parameters

uuidstring required

Project UUID

Headers

x-user-tokenstring required

Current User Session Credentials

X-Request-Idstring uuid

Request Trace ID (UUID v4 Recommended)

X-Project-Uuidstring required

Project UUID

Request body

device_snstring required

Device SN to Mark as Read (Single Device); must be directly bound to project

Response

OK

codeinteger required

Business Status Code: 0=Success; non-zero=Error Code (see message for meaning)

messagestring

Error Description Message (Omitted on Success)

dataunknown

Changes

No recorded changes to this operation across all 1 revision of this API.