停车场余位上传

最新更新时间：2023.06.13

停车场余位有变化时候需要主动上传最新余位信息。

---

接口说明

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

请求方式： POST

公共请求参数

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

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

请求参数

名称	必填	类型	说明
osStoreCode	是	string	备案系统中停车场编码(开放平台门店Code)
total	是	int	停车场的车位总数
surplus	是	int	停车场的实时余位

SDK方法

// 创建上传数据client
TyhUploadClient client = TyhUploadClient.create(TyhOptions.builder()
    .accessId(ACCESS_ID)
    .secretKey(SECRET_KEY)
    .build());
    
// 上传余位数据
OpenParkingSurplusCmd cmd = OpenParkingSurplusCmd.builder()
    .osStoreCode(OS_STORE_CODE)
    .total(20)
    .surplus(10)
    .build();
    
// 发送请求 result.ifSuccess()表示请求成功
Results result = client.uploadSurplus(cmd);

入参格式

{
  "osStoreCode" : "30000000000001",
  "total": 20,
  "surplus": 10
}

出参格式：

 { "code":8888, "msg":"success", "data": "json数据"}

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