发起一键定位

测试环境

POST

/hmd-wx/api/v2/locatectx/location/app/ask

询问设备当前位置

trace ID 交互图

调用流程

App 调用接口。

服务器给手表发送请求上报的位置的通知。

手表上报位置通知给服务器。

服务收到手表上报的位置，发送定位变动通知消息给App。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

示例

{
    "traceId": "0192adee-1d46-7221-b0a7-9a411f124bd5",
    "deviceId": "ff0dfa267b37460c9a4c7a02ae60fd"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/hmd-wx/api/v2/locatectx/location/app/ask' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "traceId": "0192adee-1d46-7221-b0a7-9a411f124bd5",
    "deviceId": "ff0dfa267b37460c9a4c7a02ae60fd"
}'

返回响应

🟢200成功

application/json

Body

示例

{}

修改于 2025-09-20 07:17:43

小程序-上传头像url

Trajectory-获取历史轨迹