停车场心跳上传

最新更新时间：2023.06.13

停车场本地系统定时向开放平台上传心跳，获取服务器基准时钟，检查停车场本地系统时钟是否准确。停车场需至少每5分钟调用一次。

---

接口说明

请求URL： https://{domain}/os-park/ospark/open/api/v2/uploadHeartbeat

请求方式： POST

公共请求参数

参数名	必填	类型	说明
access_id	是	string	开发者唯一标识
sign_type	是	string	固定传RSA2
time_stamp	是	long	请求时间，Linux时间戳，单位毫秒
sign	是	string	签名结果
data	是	string	将业务参数转为JSON字符串，然后使用BASE64编码的数据

详细签名方法请阅读接口加密方案

请求参数

名称	必填	类型	说明
osStoreCode	是	String	备案系统中停车场编码(开放平台门店Code)
uploadTime	是	long	停车场基准时间，unix时间戳格式，精确到毫秒，如1631602583000

SDK方法

// 创建上传数据client
TyhUploadClient client = TyhUploadClient.create(TyhOptions.builder()
    .accessId(ACCESS_ID)
    .secretKey(SECRET_KEY)
    .build());
    
// 心跳数据
OpenParkingHeartbeatCmd cmd = OpenParkingHeartbeatCmd.builder()
    .osStoreCode(OS_STORE_CODE)
    .uploadTime(uploadTime)
    .build();
    
// 发送请求 result.ifSuccess()表示请求成功
Results<OpenParkingHeartbeatDto> result = client.uploadHeartbeat(cmd);

入参格式

{
  "osStoreCode" : "30000000000001",
  "uploadTime": 1631602583000
}

出参格式：

 { "code":8888, "msg":"success", "data": "{ "serverTime":1631602583000 }"}

code 为 8888 表示操作成功，其它值则为失败，具体内容参见错误码说明。