洗车API安全接入指南

快速开始

环境配置

测试环境: https://dev.washcar-api.fxzb.vip

生产环境: https://washcar-api.fxzb.vip

协议: HTTPS (必须)

请求方法: POST/GET

Content-Type: application/json; charset=utf-8

获取接入凭证

登录发现周边开放平台，在洗车API的开发配置中查看您的专属凭证：

appId: 渠道标识符 (如: 10000)

secret: 签名密钥 (如: HKKA4sj81FakwFk9)

签名验证

必需参数

所有API请求需要在URL中包含以下4个签名参数：

参数	说明	示例
appId	渠道标识符	10000
timestamp	13位毫秒时间戳	1709545184000
nonce	8-32位随机字符串	Hs94gj28ka12
sign	32位MD5签名	a1b2c3d4e5f6...

签名生成步骤

步骤1: 收集所有参数

步骤2: 按参数名排序并拼接

步骤3: 添加密钥并计算MD5

完整示例 - 订单创建

请求参数

签名计算

发送请求

curl示例

常见错误

错误码	错误类型	说明	常见原因	解决方案
0	成功	请求处理成功	-	-
101	签名验证失败	签名不匹配	签名计算错误、参数缺失、密钥错误	检查签名计算过程
300	参数错误	非法参数	参数值不符合业务规则	检查参数格式和取值范围
301	参数验证失败	参数格式错误或缺失	必需参数缺失、格式不正确	检查必需参数是否完整
501	运行时异常	系统内部错误	数据库连接、网络异常等	联系技术支持
502	服务异常	后端服务调用失败	后端服务不可用	稍后重试或联系技术支持
503	业务逻辑异常	业务处理失败	业务规则验证失败	检查业务参数有效性

具体错误场景

签名相关错误 (101)

签名不匹配: 客户端计算的签名与服务端不一致

参数相关错误 (300-301)

渠道appId不存在: 提供的appId在系统中不存在

该渠道已被禁用: 渠道状态异常，无法使用

渠道接口已过期: ChannelApi权限过期

城市编码有误: cityCode格式不正确

商品不存在: goodsId对应的商品不存在

商品不存在或已下架: 商品状态异常

套餐id不存在或已下架: goodsItemId对应的套餐不可用

订单不存在: orderNo对应的订单不存在

手机号不能为空: mobile参数缺失

渠道订单号不能为空: channelOrderNo参数缺失

业务逻辑错误 (503)

未查询到对应核销码: checkCode无效

订单不存在或手机号为空: 订单查询失败

未查询到对应商品信息: 商品信息获取失败

获取预约链接失败,请稍候重试: 第三方服务调用失败

查询订单失败,商品不存在或已下架: 订单关联商品异常

城市编码格式有误: 城市编码不符合规范

常见参数错误排查

渠道相关:

"未查询到渠道，请稍后再试": 检查appId是否正确

"该渠道已被禁用": 联系管理员恢复渠道状态

"渠道接口已过期": 申请ChannelApi权限续期

业务参数:

"城市编码有误": 使用6位数字的标准城市编码

"商品不存在或已下架": 确认goodsId有效且商品在售

"套餐id不存在或已下架": 确认goodsItemId有效且套餐可用

"订单不存在": 确认orderNo正确且订单存在

接口安全

洗车API安全接入指南

快速开始

环境配置

获取接入凭证

签名验证

必需参数

签名生成步骤

完整示例 - 订单创建

请求参数

签名计算

发送请求

curl示例

常见错误

具体错误场景

签名相关错误 (101)

参数相关错误 (300-301)

业务逻辑错误 (503)

常见参数错误排查

开发工具

JavaScript签名工具

Java签名工具

接口安全

洗车API安全接入指南#

快速开始#

环境配置#

获取接入凭证#

签名验证#

必需参数#

签名生成步骤#

完整示例 - 订单创建#

请求参数#

签名计算#

发送请求#

curl示例#

常见错误#

具体错误场景#

签名相关错误 (101)#

参数相关错误 (300-301)#

业务逻辑错误 (503)#

常见参数错误排查#

开发工具#

JavaScript签名工具#

Java签名工具#

洗车API安全接入指南

快速开始

环境配置

获取接入凭证

签名验证

必需参数

签名生成步骤

完整示例 - 订单创建

请求参数

签名计算

发送请求

curl示例

常见错误

具体错误场景

签名相关错误 (101)

参数相关错误 (300-301)

业务逻辑错误 (503)

常见参数错误排查

开发工具

JavaScript签名工具

Java签名工具