Query Device Current NTP Server Configuration

POST

/openapi/v2.0/manage/api/v1/organizations/{uuid}/manage-devices/cmds/get-ntp-status

Query specified dock device's currently effective NTP clock synchronization server configuration (IP/Port or Domain) and sync status code; used to troubleshoot device time inaccuracy, abnormal report timestamps, and other issues.

This API shares the same physical channel with the "Dispatch Custom Command to Organization Device (Generic cmds Channel) [Query-Type Developed as API, Configuration-Type Retained]" API (Generic cmds Channel), but {method} path segment is fixed to get-ntp-status; from the client's perspective, it is a fixed-form API; request body accepts only device_sn single field. In response, ntp_status / ntp_server lifts device passthrough fields from generic cmds channel to data top level (desensitized modeling).

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "device_sn": "2TUDK87654321"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/manage/api/v1/organizations/550e8400-e29b-41d4-a716-446655440000/manage-devices/cmds/get-ntp-status' \
--header 'x-user-token;' \
--header 'x-user-token;' \
--header 'X-Request-Id;' \
--header 'X-Request-Id;' \
--header 'X-Project-Uuid;' \
--header 'Content-Type: application/json' \
--data '{
    "device_sn": "2TUDK87654321"
}'

Responses

🟢200

application/json

Success Response

Bodyapplication/json

Example

{
    "code": 0,
    "message": "OK",
    "data": {
        "ntp_status": 0,
        "ntp_server": "ntp.aliyun.com:123"
    }
}

🟠400

🔴500

Modified at 2026-06-15 13:36:31

Batch Get Project Device HMS Events

Start Device Network Speed Detection Task