曹操出行开放平台

常见问题

原因: 桩企返回值和开放平台接口要求的数据类型不一致。

比如: 开放平台API中的接口getOrderInfoy要求返回值中的status字段必须为int类型，因此json返回结果中的该值的一种结果应该为 status:0 如果返回的结果为status："0"将提示 status数据类型错误，必须为 int

处理建议: 改成开放平台要求的数据类型

原因: 返回的数据精度不符合平台要求

比如: 开放平台API中的接口根据桩群编号查询桩群详情(queryStubGroupWithId)桩企返回值中stubInfo(桩信息)的kw字段要求是额定功率，小数点位数最多2位。0<=功率<=999 如果桩企返回结果是kw:220.001则将出现该错误提示。

处理建议: 修改返回值中对应字段的精度要求

原因: 返回数据中缺失了开放平台要求的必填值

处理建议: 错误提示中会告知哪个参数缺失,可以根据错误提示补充对应的参数值。同时,强烈建议根据开放平台API接口说明检查一下是否缺失了其他必填项

原因: 返回数据中存在格式未按照平台要求的值

比如: 平台对于时间参数要求的格式是24小时制的时间:yyyy-MM-dd,如果返回参数不符合该规则就会提示不能匹配规则的错误

处理建议: 修改值格式为正确格式

原因: 平台对于有些参数除了必填还要求值不能为空

比如: 充电订单回调接口中的参数chargeDetails除了要求必填还要求是不能为Empty,如果返回的数据是empty的值,则会出现该错误提示

处理建议: 因为充电订单必定存在充电详情,因此请添加该信息

原因: 桩企返回数据不是合法的Json格式,导致无法正常被解析为类对象

处理建议: 检查数据报文,确认是否为正确Json格式。

原因: 该错误基本发生在接口token获取检查传入的参数appId不正确，导致我方数据库查询不到贵公司的信息

处理建议: 检查appId是否正确

原因: 该错误有可能是桩企使用的加密秘钥信息和我方提供的不一致处理建议: 桩企自行检查系统中使用的加密信息是否和我方提供的秘钥一致